Snap to Roads API

Introduction

Request access

Important note
This API is not available as part of our free evaluation or Pay As You Grow (PAYG) offering. Click the Request access button above to apply for the private preview.

Private Preview Notice

Important notes:

  • This TomTom Orbis Maps API is restricted to private preview. Go to the Private Preview page to see what this means.
  • This API will change. Its request and response schema will be aligned with other TomTom Orbis Maps APIs, so expect breaking changes before general availability.
  • Coverage is limited to the USA, and not every response field of the TomTom Maps version is available yet. See Differences from TomTom Maps.
  • This API is powered by TomTom Orbis Maps. See the TomTom Orbis Maps documentation for more information.

What is TomTom’s Snap to Roads API?

The TomTom Orbis Maps Snap to Roads API matches points gathered from GPS devices to the TomTom Orbis Maps road network, reconstructs the road driven by a customer, and provides detailed information about the matched route. It is a REST API for developers building web and mobile applications on advanced map data.

The request and response are the same as those of the TomTom Maps Snap to Roads API, with the differences listed in Differences from TomTom Maps.

Synchronous Snap to Roads

Returns detailed information for a reconstructed road in a single request.

Synchronous Snap to Roads

Getting Started

Request access

This API is in private preview. Click the Request access button above to apply.

About Private Preview

Platform and tools

Understand how to use the TomTom products and services.

Open Platform and tools

Endpoint descriptions

GET / POST Synchronous Snap to Roads

This endpoint provides detailed information of a reconstructed road in an efficient way. The Synchronous Snap to Roads endpoint matches the received points to the map road network and reconstructs the driven road. Points given as input to the Synchronous Snap to Roads endpoint are related to themselves and are a part of the same route from the same client.

The matching algorithm chooses the driven road fitting to all of the given points, or in case of a few possibilities takes into account additional restrictions provided by the client. This endpoint can also provide extended data related to a matched route.

This endpoint can be used for:

  • Reconstructing the driven road and getting the detailed insights for it.
  • Providing innovative information in order to build applications with advanced map data.

API Limitations

  • A single request supports up to 5000 points and up to 100 km of road distance.
  • Only the synchronous endpoint is available. The asynchronous (batch) endpoints of the TomTom Maps version are not available.
  • Coverage is limited to the USA. See Market Coverage.

Endpoint type

Max number
of points per route

Max road distance per route

Max QPS

Synchronous

5000

100 km

10