14
Finally, to package all the POI types into a single external POI file, the following command can be
used:
zippoi «path» «result».poi
Where «path» is the pathname of the directory where the files for the individual POI types are located
and «result» is the desired name of the resulting external POI file. The input files must have a name with
the form poi.«nnnn».
4.4. Format of the requests to external applications
When the user selects an external command from the location−sensitive menu, Navigator creates a
request and sends a notification to the external application. The request is a text file (in the \TomTom\
directory) containing a single line with one of the following possible formats, according to the command
type:
REQUEST|«cmd name»|2|«longitude»|«latitude»|
Or:
REQUEST|«cmd name»|4|«unique id»|
Where «cmd name» is the command name as given in the .CAP file, «longitude» and «latitude» are the
WGS84−coordinates of an arbitrary location in degrees multiplied by 100,000, and «unique id» is the
unique ID of a point of interest from the external POI file.
After the request has been created, a notification is sent to the external application, in the form of a
Windows WM_COPYDATA message to the main window of the external application. The lpData member
of the COPYDATASTRUCT structure referenced by the LPARAM parameter of the message points to a
zero−terminated Unicode string with the pathname of the request file. If the external application is not
running, Navigator will try to launch it. The external application should bring itself to the foreground in
response to the notification using the SetForegroundWindow API. After the external application has
finished processing the WM_COPYDATA message, Navigator deletes the request file.
4. Extending the Location−sensitive Menu