Sorry, you need to enable JavaScript to visit this website.

What is Routing API?

Routing API is a suite of web services designed for developers to use our latest scalable routing engine. Independent tests have established that TomTom routing engine is the best in the industry. Our routing engine uses IQ Routes™ and TomTom Traffic™.

Routing API consists of the following REST-like APIs:

  • Routing
    • Calculate Route - calculates a route between an origin and a destination, passing through waypoints (if specified). Additional routing parameters like traffic, avoidance conditions, departure/arrival time etc. can be taken into account.
    • Calculate Reachable Range - calculates a set of locations that can be reached from the origin point, subject to the available fuel or energy budget that is specified in the request.
  • Batch - allows batch processing of the Routing requests.
  • Matrix - allows calculation of a matrix of route summaries for a set of routes defined with origin and destination locations.

For detailed geographic coverage information, please go here.

Getting Started

  1. Register/Sign in to TomTom Developer Portal.
  2. Request an evaluation API key to access the Routing service.
  3. Read the API documentation and start coding.
  4. Consider using Maps SDK for Web, for iOS, for Android

Common use-cases you can implement

  • Plan the fastest, shortest or eco route from A to B taking in consideration the real-time traffic and the historical traffic.
  • Calculate departure times by planning routes using desired arrival times.
  • Plan multiple alternative routes through one single API call.
  • Draggable routes: replan the same route with additional intermediate points.
  • Plan a route through up to 50 intermediate waypoints.
  • Plan the optimized route through up to 20 intermediate waypoints (traveling salesman).
  • Plot the route geometry on map tiles from TomTom (or other map suppliers).
  • Plan a round trip through at least one intermediate point.
  • Calculate the travel time of pre-existing routes (like routes created using GPS trace data or routes planned with other routing engines).
  • Plan a route which avoids toll roads, ferries or other types of roads.
  • Plan a route for vehicles or pedestrians.
  • Plan a route using our elaborated consumption models for both electric and combustion engines.
  • Draw a polygon of the reachable range with the current fuel/energy budget.
  • Evaluate the amount of fuel/energy needed for any route.
  • Have a batch of up to 700 routing requests calculated in parallel and retrieve the results as a single file.
  • While having a matrix of origins and destinations calculate routing costs for each origin-to-destination combination and retrieve it in a single file.

Feature List

Routing API


Our routing engine uses IQ Routes™ and TomTom Traffic™. As such Routing API enables you to:

  • Plan routes for immediate departure and TomTom's industry-leading traffic data will be used to optimize journey times, minimize traffic delays and get to your destination faster.
  • Plan routes in the future to take advantage of TomTom's extensive historic traffic database. Using past traffic patterns, the routing engine can predict journey times and calculate fastest routes for any day and time.

Alternative Routes

There are many ways to get from A to B. Sometimes your users want to know about them.

  • You can reuse the same waypoints in calls with different routing parameters (like fastest, shortest, and eco).
  • You can request more than one route matching your input parameters within the same call.


In addition to the start and end of the route, you can specify intermediate waypoints that the planned route must go through.

  • Use additional waypoints to create draggable routes, where the user can replan a displayed route to go via a desired location.
  • Use our Optimized Routing algorithm to obtain the best order to visit your chosen waypoints in.

Batch Routing

Supported services for batch processing

The Batch Routing service supports requests to the Routing APIs - calculateRoute and calculateReachableRange.

Matrix Routing

Supported services for matrix processing

The Matrix Routing service uses Routing API to compute route costs. It supports Routing API parameters excluding: locations, maxAlternatives, instructionsType, language, computeBestOrder, routeRepresentation, vehicleHeading, report, callback. The Supporting Points feature is also not available, as it uses HTTP POST requests.