2.1.6   Get the stop-off point list

The .in file

Attributes in [Head] section:

Type: 6
Allowed Mode: 0 (try once), 1 (try until success), 2 (loop)
Allowed Blocking: 0 (non blocking), 1 (blocking)

Attributes in [StopOffPointList] section:

• SearchAddress: Output the location as an address in the .out-file. 0=disabled, 1=enabled. This attribute is optional. Default is 0.

Note: If SearchAddress is enabled, the application tries to find the correct addresses for all stop-off points. The addresses are written in the .out file as StopOffPointLocationAddress attributes. If SearchAddress is disabled, the value of StopOffPointLocationAddress attributes will look like ",,,,".
Warning: Finding the addresses takes a very long time. Therefore the application won't respond during a search!

Sample .in file: Get a list of all stop-off points

[Head] Type=6 Mode=0 Blocking=0 [StopOffPointList] SearchAddress=1

The .out file

Attributes in [StopOffPointList] section:

• NumberOfStopoffPoints: Number of stop-off points in the stop-off point list
• SearchAddress: The SearchAddress attribute given in the .in file
• A separate section is created for each stop-off point. The section names are sequentially named starting with 1, e.g. stop-off point one's section is named [StopOffPoint_1] ....
  Attributes in [StopOffPoint_i] section:
  • StopOffPointID: The unique identifier for this stop-off point
  • StopOffPointType: Type of stop-off point

  StopOffPointType	Description
  1	GPS position
  2	click point
  3	address
  4	homebase
  5	previous destination
  6	favorite
  7	Search for Next
  8	point of interest
  9	destination defined via command line
  10	destination defined via remote control

  • StopOffPointTypeDesc: A textual description of StopOffPointType
  • StopOffPointCaption: The caption of the stop-off point, which is displayed in the application
  • StopOffPointLocationMercator: The mercator coordinates of the stop-off point
  • StopOffPointLocationGeodecimal: Geographical coordinates of the stop-off point
  • StopOffPointLocationAddress: The address of the stop-off point

Sample .out file: There are currently 2 stop-off points: Number 1 is the actual GPS position, number 2 is a stop-off point of type address which was specified by the user

[Head] Type=6 TypeDesc=get stop-off point list Mode=0 ModeDesc=try once Blocking=0 BlockingDesc=not blocking Timestamp=88899250 Id=88899218 Result=2 ResultDesc=success and request deleted ExecuteDuration=15265 [StopOffPointList] NumberOfStopoffPoints=2 SearchAddress=1 [StopOffPoint_1] StopOffPointID=675921891 StopOffPointType=1 StopOffPointTypeDesc=GPS position StopOffPointCaption=GPS position StopOffPointLocationMercator=0,0 StopOffPointLocationGeodecimal=0.000000,0.000000 StopOffPointLocationAddress=,,,, [StopOffPoint_2] StopOffPointID=675921892 StopOffPointType=3 StopOffPointTypeDesc=address StopOffPointCaption=76133 Karlsruhe / Albert-Nestler-Strasse StopOffPointLocationMercator=938650,6271155 StopOffPointLocationGeodecimal=+8.441482,+49.019555 StopOffPointLocationAddress=D,76131,Karlsruhe/Rintheim,Albert-Nestler-Strasse,