2.1.4   Add a stop-off point to previous destinations list

The .in file

Attributes in [Head] section:

Type: 4
Allowed Mode: 0 (try once)
Allowed Blocking: 0 (non blocking)

Attributes in [StopOffPoint] section:

• Location: The location of the stop-off point to add. Location can be entered in 3 formats:
  • Address: country code,zip code,town,street,house number
    e.g. D,76131,Karlsruhe,Tullastrasse,1
  • Mercator coordinates: xxxxxx,yyyyyyy
    e.g. 951215,6261940
  • Geodez-Tupel: x.xxxxxxx,y.yyyyyyyy
    e.g. 8.5545,48.9652
• Caption: The caption which appears in the favorite list
• 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 address, if Location is given as mercator coordinates or geodez-tupel. The address is written in the .out file as Location_Address attribute. If SearchAddress is disabled, the value of Location_Address attribute will look like ",,,,".
Warning: Finding the address from mercator coordinates or geodez-tupels takes a very long time. Therefore the application won't respond during the search!

Sample .in file: This request adds a stop-off point using a geodez-tupel

[Head] Type=4 Mode=0 Blocking=0 [StopOffPoint] Location=8.4417,49.0212 Caption=Remote Control Previous Destination (Geodez) SearchAddress=1

The .out file

Attributes in [StopOffPoint] section:

• Location: The location attribute given in the .in file
• Caption: The caption attribute given in the .in file
• SearchAddress: The SearchAddress attribute given in the .in file
• StopOffPointResult: Result code

  StopOffPointResult	Description
  -4	Stop-off point was not added; the favorite list is full
  -3	Stop-off point was not added; the location is not unique
  -2	Stop-off point was not added; the location does not exist on the map
  -1	Stop-off point was not added; the location syntax is invalid
  1	Stop-off point was added successfully

• StopOffPointResultDesc: A textual description of StopOffPointResult
• Location_Mercator: Mercator coordinates of the added stop-off point
• Location_Geodecimal: Geographical coordinates of the added stop-off point
• Location_Address: Address of the added stop-off point
The output is given as a formatted string like the following:
D,76131,Karlsruhe,Tullastrasse,1-11|2-20
The housenumber will be given as ranges separated by the pipe '|' symbol. A range of 0-0 means no housenumber found for this side of the segment. The different ranges will always be sorted from lower to upper.

Sample .out file: The stop-off point was added successfully

[Head] Type=4 TypeDesc=add stop-off point to previous destinations Mode=0 ModeDesc=try once Blocking=0 BlockingDesc=not blocking Timestamp=6099919 Id=6099900 Result=2 ResultDesc=success and request deleted ExecuteDuration=169557 [StopOffPoint] Location=8.4417,49.0212 Caption=Remote Control Previous Destination (Geodez) SearchAddress=1 StopOffPointResult=1 StopOffPointResultDesc=stop-off point added Location_Mercator=938674,6271433 Location_Geodecimal=+8.441698,+49.021195 Location_Address=D,76131,Karlsruhe/Rintheim,Albert-Nestler-Strasse,