2.1.10   Get the previous destinations list

The .in file

Attributes in [Head] section:

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

Attributes in [PreviousDestinationList] 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 previous destinations. The addresses are written in the .out file as PreviousDestinationLocationAddress attributes. If SearchAddress is disabled, the value of PreviousDestinationLocationAddress attributes will look like ",,,,".
Warning: Finding the addresses takes a very long time. Therefore the application won't respond during the search!

Sample .in file: Get a list of all previous destinations

[Head] Type=10 Mode=0 Blocking=0 [PreviousDestinationList] SearchAddress=1

The .out file

Attributes in [PreviousDestinationList] section:

• NumberOfPreviousDestinations: Number of previous destinations in the previous destinations list
• SearchAddress: The SearchAddress attribute given in the .in file
• A separate section is created for each previous destination. The section names are sequentially named starting with 1, e.g. previous destination one's section is named [PreviousDestination_1] ....
  Attributes in [PreviousDestination_i] section:
  • PreviousDestinationID: The unique identifier for this previous destination
  • PreviousDestinationType: Type of previous destination

  PreviousDestinationType	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

  • PreviousDestinationTypeDesc: A textual description of PreviousDestinationType
  • PreviousDestinationCaption: The caption of the previous destination, which is displayed in the application
  • PreviousDestinationLocationMercator: The mercator coordinates of the previous destination
  • PreviousDestinationLocationGeodecimal: Geographical coordinates of the previous destination
  • PreviousDestinationLocationAddress: The address of the previous destination
  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: There are currently 4 previous destinations

[Head] Type=10 TypeDesc=get previous destinations list Mode=0 ModeDesc=try once Blocking=0 BlockingDesc=not blocking Timestamp=677255921 Id=677255562 Result=2 ResultDesc=success and request deleted ExecuteDuration=14531 [PreviousDestination] NumberOfPreviousDestinations=4 SearchAddress=1 [PreviousDestination_1] PreviousDestinationID=677202306 PreviousDestinationType=6 PreviousDestinationTypeDesc=favorite PreviousDestinationCaption=23611 Bad Schwartau / Bahnhofstrasse PreviousDestinationLocationMercator=1189670,7146825 PreviousDestinationLocationGeodecimal=+10.698959,+53.919002 PreviousDestinationLocationAddress=D,23611,Bad Schwartau,Bahnhofstrasse, [PreviousDestination_2] PreviousDestinationID=677202298 PreviousDestinationType=5 PreviousDestinationTypeDesc=previous destination PreviousDestinationCaption=bei Schulstrasse PreviousDestinationLocationMercator=1189135,7147060 PreviousDestinationLocationGeodecimal=+10.694148,+53.920246 PreviousDestinationLocationAddress=D,23611,Bad Schwartau,Schulstrasse, [PreviousDestination_3] PreviousDestinationID=677202299 PreviousDestinationType=5 PreviousDestinationTypeDesc=previous destination PreviousDestinationCaption=bei Rensefelder Strasse PreviousDestinationLocationMercator=1188860,7147105 PreviousDestinationLocationGeodecimal=+10.691675,+53.920485 PreviousDestinationLocationAddress=D,23611,Bad Schwartau,Rensefelder Strasse, [PreviousDestination_4] PreviousDestinationID=677202300 PreviousDestinationType=6 PreviousDestinationTypeDesc=favorite PreviousDestinationCaption=Remote Control Favorite (Address) PreviousDestinationLocationMercator=937575,6269540 PreviousDestinationLocationGeodecimal=+8.431815,+49.010029 PreviousDestinationLocationAddress=D,76131,Karlsruhe/Oststadt,Tullastrasse/Tullaplatz,