Introduction

Service version: 1
Last edit: 2024.01.15

What is TomTom's Routing API?

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

The Routing API consists of the the following services with endpoints:

Routing service

Contains a suite of web services including Calculate Route, Calculate Reachable Range, and Common Routing Parameters.

Batch Routing service

Enables you to dispatch batches of Calculate Route and Calculate Reachable Range requests.

Matrix Routing v2 service

Allows clients to calculate a matrix of route summaries for a set of routes defined with origin and destination locations.

Market Coverage

Provides a list of all countries supported by the Routing API and Extended Routing API engines.


What is TomTom's Extended Routing?

The Extended Routing web service allows EV drivers to plan their trips around where to stop and recharge their electric vehicle. Given the start, intermediate, and end parameters, the endpoint returns routes with available charging stations within driving range and displays them on a TomTom map.

Extended Routing consists of the following RESTful API services with endpoints:

Long Distance EV Routing

Calculates a route between a given origin and destination.

Market Coverage

Provides a list of all countries supported by the Routing API and Extended Routing API engines.

Getting Started

Use the following topics to become more acquainted with this API and its endpoints.

How to get a TomTom API Key

How to get a TomTom API Key

When you use our location Service APIs, we need a way to identify that it is your application that is making the request to use the service (API).

The TomTom Knowledge Base

TomTom Knowledge Base

The TomTom Knowledge Base optimizes the retrieval of information via articles, blogs, FAQs, tutorials, and videos for your use and reference.

Routing API Map

Plan Your Road Trip Menu in Advance with the TomTom Routing and Search APIs

Using the TomTom Routing and Search APIs, you can plan your road trip menu in advance, specifying all the stops you want to make along the way.

Routing parameter explained

The vehicleHeading Routing Parameter Explained

In this article, we’ll explore the vehicleHeading parameter at a high level. We will discuss what this parameter does and how it impacts our routes using the TomTom Routing API using a quick React app to demonstrate.

Common use cases you can implement

Calculating

  • Calculate departure times by planning routes using desired arrival times.
  • Calculate the travel time of pre-existing routes (like routes created using GPS trace data or routes planned with other routing engines).
  • Calculate a batch of up to 700 routing requests 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.

Evaluating and plotting

  • Evaluate the amount of fuel/energy needed for any route.
  • Plot the route geometry on map tiles from TomTom (or other map suppliers).
  • Draw a polygon of the reachable range with the current fuel/energy budget.

Planning

  • Plan the fastest, shortest or eco route from A to B taking in consideration the real-time traffic and the historical traffic.
  • Plan multiple alternative routes through one single API call.
  • Plan a route through up to 150 intermediate waypoints.
  • Plan the optimized route through the intermediate waypoints (traveling salesman).
  • Plan a round trip through at least one intermediate point.
  • 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.
  • Draggable routes: replan the same route with additional intermediate points.

Features

Routing API

Traffic

Our Routing engine uses IQ Routes™ and TomTom Traffic™. As such, the 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 the fastest routes for any day and time.

Alternative routes

There are many ways to get from point 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.

Waypoints

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 in which to visit your chosen waypoints.

Extended Routing API

Charging data

Each charging stop results in an additional leg in the route response.

  • Each additional leg contains a chargingInformationAtEndOfLeg element in its leg summary.
  • Both the route summary and the leg summary include a remainingChargeAtArrivalInkWh element.
  • The route summary includes a totalChargingTimeInSeconds element.
  • The chargingInformationAtEndOfLeg field consists of:
    • target battery charge
    • charging time
    • details about the charging stop