Table of Contents
Advertisement
It is possible to create your own itinerary files outside Navigator, and then use them from within. This
section explains the file format. Refer to the C++ API for itinerary−related API−functions.
3.1. Itinerary file format
The file format for itineraries is plain ASCII. an itinerary file consists of lines, each denoting one point
in your itinerary. Normally, itinerary files are stored in the following folder:
\My Documents\TomTom Navigator Settings
and have the extension .itn
Each line consists of the following fields, terminated by bar characters (''|'')
3.1.1. Fields in itinerary files
Field 0
Longitude in WGS84 format (in 100 000th of degrees)
Field 1
Latitude in WGS84 format (in 100 000th of degrees)
Field 2
Name of this point in the itinerary
Field 3
Flag
3.1.2. Flags in itinerary lines
The flags in the itinerary lines can be ORed together. Currently, the following flags exist:
0x00
None
0x01
Itinerary location is enabled
0x02
Itinerary location is a stop−over (as opposed to a
pass−by location)
0x04
Itinerary location is departure point (Should only
be set for the first item in the itinerary file)
Example: \My Documents\TomTom Navigator Settings\Itinerary.itn
Here's an example of an itinerary file representing a small itinerary in France:
80417|4821030|Unnamed road, Gué (Le) (Vendeuvre−Du−Poitou)|4|
98140|4799585|Unnamed road, Boursay|1|
107833|4804246|Unnamed road, Droué|1|
115927|4800041|Unnamed road, Haies (Les) (Bourdonné)|3|
This itinerary consists of a starting point, an end point and two stop−overs in between.
3.2. Using itineraries
An itinerary can be loaded by the user from within Navigator. From the C++ api, the following
functions can be used in relation to itineraries:
AddItineraryLocationV01
AddItineraryLocationV02
SetItineraryLocationV01
SetItineraryLocationV02
GetItineraryLocationV01
GetItineraryLocationV02
DeleteItineraryLocation
EnableItineraryLocation
IsItineraryLocationEnabled
3. Itinerary files
8
Advertisement
Table of Contents
