DriveWorks SDK Reference
3.0.4260 Release
For Test and Development only

TomTom Maps to DriveWorks Maps Converter Tool

Description

The NVIDIA® DriveWorks TomTom Maps to DriveWorks Maps Converter tool downloads TomTom Maps data
from the AutoStream server, and generates a DriveWorks Maps file. This file can be along a route defined
by a file type, or within a geometrical region.

For specific examples, please refer to the following:

Note
SW Release Applicability: This tool is available in NVIDIA DRIVE Software releases.

Prerequisites

This tool is available on the x86 Host System.

This tool creates output files that are placed into the current working directory by default. Please ensure the following for your convenience:

  • Write permissions are enabled for the current working directory.
  • Include the tools folder in the binary search path of the system.
  • Execute from your home directory.

Ensure you have obtained the proper credentials to access TomTom AutoStream HD Maps data.

Running the Tool

The TomTom Maps to DriveWorks Maps Converter tool accepts the following parameters. Several of these parameters are required based on the route definition.
For more information, please refer to the Examples.

Run the tool by executing:

./maptool_tomtom_to_dw_maps --key=[AutoStream API key]
                            --dw_gps_file=[input DriveWorks GPS file]
                            --output_file=dwMapCache.bin
                            --route_kml_file=[input KML file]
                            --minLon=[minimum longitude in degrees]
                            --maxLon=[maximum longitude in degrees]
                            --minLat=[minimum latitude in degrees]
                            --maxLat=[maximum latitude in degrees]
                            --lat=[latitude in degrees]
                            --lon=[longitude in degrees]
                            --radius=[radius in meters]
                            [--autoStreamCertFile=[path to file]]
                            [--base_path=[path to AutoStream URI]]
                            [--bounding_box=[lat/lon measurements]]
                            [--cache_file=[TomTom cache file]]
                            [--host_port=[AutoStream host port]]
                            [--http_log=[input HTTP log file]]
                            [--offscreen=[0|1|2]]
                            [--profiling=[0|1]]
                            [--timeout=[timeout to fetch data from server]]

Parameters

--key=[TomTom AutoStream service API key]
        Description: The API key to access the TomTom AutoStream HD Map service

--output_file=[path to output file]
        Description: The output DriveWorks Maps file name in '.xml' or '.bin' format.
        Default value: dwMapCache.bin

--dw_gps_file=[path to input file]
        Description: The input DriveWorks GPS file.

--route_kml_file=[path to input file]
        Description: The input KML file extracted from Google Maps after specifying a route.

--minLon=[minimum longitude in degrees]
        Description: The minimum longitude of a map for a rectangular query.

--maxLon=[maximum longitude in degrees]
        Description: The maximum longitude of a map for a rectangular query.

--minLat=[minimum latitude in degrees]
        Description: The minimum latitude of a map for a rectangular query.

--maxLat=[maximum latitude in degrees]
        Description: The maximum latitude of a map for a rectangular query.

--lat=[latitude in degrees]
        Description: The latitudinal center of the map in degrees for a radius query.
        Default value: 37.3705354

--lon=[longitude in degrees]
        Description: The longitudinal center of the map in degrees for a radius query.
        Default value: -121.9667493

--radius=[radius in meters]
        Description: The coverage distance (in meters) around a specified latitude/longitude as the center.
        Default value: 1000

--autoStreamCertFile=[path to file]
        Description: The AutoStream certificate file.
                     This parameter is optional.
        Default value: (data-dir)/tools/maps/tomtom/AutoStreamClient/certs/AutoStreamRootCAs.pem

--base_path=[path to AutoStream URI]
        Description: The AutoStream URI base path.
                     This parameter is optional.
        Default value: autostream

--bounding_box=[latitude/longitude measurements]
        Description: The size of the bounding box in latitude/longitude measurements for the data query, when radius is not specified.
                     This parameter is optional.

--cache_file=[path to cache file]
        Description: The TomTom cache file.
                     This parameter is optional.
        Default Value: ./SqlCache.db

--host_port=[host port name]
        Description: The AutoStream host port name.
                     This parameter is optional.
        Default value: api.tomtom.com

--http_log=[path to input log file]
        Description: The HTTP data usage log file.
                     This parameter is optional.
        Default value: ./HttpLog.db

--offscreen=[0|1|2]
        Description: Used to run windowed apps in headless mode:
                     '0' = Display window.
                     '1' = Offscreen window.
                     '2' = No window created.
                     This parameter is optional.
        Default value: 0

--profiling=[0|1]
        Description: Enables or disables sample profiling.
                     '0' = Disables sample profiling. 
                     '1' = Enables sample profiling.
                     This parameter is optional.
        Default value: 1

--timeout=[int]
        Description: The timeout value in milliseconds to fetch data from the TomTom server.
                     This parameter is optional.

Examples

For Routes Defined by a DriveWorks GPS File

./maptool_tomtom_to_dw_maps --key=[AutoStream API key]
                            --dw_gps_file=
                            --output_file=dwMapCache.bin
                            --autoStreamCertFile=[path to file]
                            --base_path=[path to AutoStream URI]
                            --bounding_box=[lat/lon measurements]
                            --cache_file=[TomTom cache file]
                            --host_port=[AutoStream host port]
                            --http_log=[input HTTP log file]
                            --offscreen=[0|1|2]
                            --profiling=[0|1]
                            --timeout=[timeout to fetch data from server]

For Routes Defined by a KML File

./maptool_tomtom_to_dw_maps --key=[AutoStream API key]
                            --route_kml_file=
                            --output_file=dwMapCache.bin
                            --autoStreamCertFile=[path to file]
                            --base_path=[path to AutoStream URI]
                            --bounding_box=[lat/lon measurements]
                            --cache_file=[TomTom cache file]
                            --host_port=[AutoStream host port]
                            --http_log=[input HTTP log file]
                            --offscreen=[0|1|2]
                            --profiling=[0|1]
                            --timeout=[timeout to fetch data from server]

For Regions Defined by a Rectangle

./maptool_tomtom_to_dw_maps --key=[AutoStream API key]
                            --minLon=-122.3
                            --maxLon=-122.2
                            --minLat=37.4
                            --maxLat=37.5
                            --output_file=dwMapCache.bin
                            --autoStreamCertFile=[path to file]
                            --base_path=[path to AutoStream URI]
                            --bounding_box=[lat/lon measurements]
                            --cache_file=[TomTom cache file]
                            --host_port=[AutoStream host port]
                            --http_log=[input HTTP log file]
                            --offscreen=[0|1|2]
                            --profiling=[0|1]
                            --timeout=[timeout to fetch data from server]

For Regions Defined by a Center and Radius

./maptool_tomtom_to_dw_maps --key=[AutoStream API key]
                            --lon=-122.25
                            --lat=37.45
                            --radius=100
                            --output_file=dwMapCache.bin
                            --autoStreamCertFile=[path to file]
                            --base_path=[path to AutoStream URI]
                            --bounding_box=[lat/lon measurements]
                            --cache_file=[TomTom cache file]
                            --host_port=[AutoStream host port]
                            --http_log=[input HTTP log file]
                            --offscreen=[0|1|2]
                            --profiling=[0|1]
                            --timeout=[timeout to fetch data from server]