2.1.5   Add a stop-off point to the stop-off point list

The .in file

Attributes in [Head] section:

Type: 5
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 stop-off point 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 mercator coordinates

[Head] Type=5 Mode=0 Blocking=0 [StopOffPoint] Location=938625,6271340 Caption=Remote Control stop-off point list (Mercator) SearchAddress=0

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
• StopOffPointResult: Result code

  StopOffPointResult	Description
  -3	Stop-off point was not added; the location is ambiguous
  -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=5 TypeDesc=add stop-off point to stop-off point list Mode=0 ModeDesc=try once Blocking=0 BlockingDesc=not blocking Timestamp=32298812 Id=32298781 Result=2 ResultDesc=success and request deleted ExecuteDuration=198 [StopOffPoint] Location=938625,6271340 Caption=Remote Control stop-off point list (Mercator) SearchAddress=0 StopOffPointResult=1 StopOffPointResultDesc=stop-off point added Location_Mercator=938625,6271340 Location_Geodecimal=+8.441257,+49.020646 Location_Address=,,,,