DriveWorks SDK Reference
3.0.4260 Release
For Test and Development only

Map Access Sample
SW Release Applicability: This sample is available in NVIDIA DRIVE Software releases.


The Map Access sample demonstrates how to access map data from the Maps module. The sample mimics a car driving along a GPS path, visualizing the map around the car. The map geometry is stored as polylines of WGS84 coordinate points. It shows how to query the map data around a current position, how to transform the geometry into a local Cartesian coordinate space, and how to render that data from various views.

Running the Sample

The command line for the Map Access sample, sample_mapaccess, is:


The sample plays automatically, running through a fixed route of GPS points.

While the application is running the following actions are possible:

  • 'F1' displays controls on screen.
  • 'Esc' closes the application.
  • 'Spacebar' pauses the application.
  • 'Mouse Wheel' allows to control camera zoom.
  • 'right' mouse button allow to move the camera when the sample is paused.
  • 'Up' and 'Down' arrow keys move the vehicle forward or backward.


The output window is split into 3 parts:

  • left side showing an overview of complete map data.
  • middle showing a zoomed top view of the current location.
  • right side showing the current view from a car driving along the GPS path.

Rendered elements:

  • Blue lines = all lane divider lines.
  • White lines = local non-traversable lane divider lines.
  • Green lines = local traversable lane divider lines.
  • Grey lines = local invisible lane divider lines.
  • Yellow Box = current car position.
HD Maps Access Sample

Additional Information

This sample contains an NVIDIA® DriveWorks map format representation of TomTom HD Maps. This data is for evaluation purposes only and may not be used for any commercial application without prior approval from TomTom. Further restrictions to the use of this data are set out in your evaluation agreement with NVIDIA.

The NVIDIA® DriveWorks TomTom Maps to DriveWorks Maps Converter Tool contains the TomTom AutoStream Client software, owned by TomTom. This tool can download TomTom HD Maps from the TomTom AutoStream server and generate DriveWorks maps files. Users will need to contact TomTom to obtain a license and credentials to access TomTom AutoStream HD Maps.

To learn more about TomTom HD Maps, see:

For more details see Maps.