Skip to content

Routing API

by tomtom.com

API keyHTTPSGeocoding
Open documentation ↗

Overview

Routing consists of the following service: <b>Calculate Route</b> 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. <b>Calculate Reachable Range</b> 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.

Routing is a geocoding API from tomtom.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 4 endpoints.

At a glance

Authentication
API key
HTTPS
Yes
CORS
Unknown
Category
Geocoding
Base URL
https://api.tomtom.com
Version
1.0.0
Endpoints
4
Spec updated
2019-02-25

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://api.tomtom.com/routing/VERSIONNUMBER/calculateReachableRange/ORIGIN/CONTENTTYPE" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch("https://api.tomtom.com/routing/VERSIONNUMBER/calculateReachableRange/ORIGIN/CONTENTTYPE", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://api.tomtom.com/routing/VERSIONNUMBER/calculateReachableRange/ORIGIN/CONTENTTYPE",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/routing/{versionNumber}/calculateReachableRange/{origin}/{contentType}Reachable Range
POST/routing/{versionNumber}/calculateReachableRange/{origin}/{contentType}Reachable Range
GET/routing/{versionNumber}/calculateRoute/{locations}/{contentType}Calculate Route
POST/routing/{versionNumber}/calculateRoute/{locations}/{contentType}Calculate Route

Questions

Does the Routing API need an API key?

Yes. The Routing API uses API key authentication; the documentation explains how to get credentials.

Does the Routing API support HTTPS?

Yes, the Routing API is served over HTTPS.

How many endpoints does the Routing API have?

Its OpenAPI description lists 4 endpoints in version 1.0.0. All of them are shown on this page.

What are alternatives to the Routing API?

Other Geocoding APIs include Bing Maps, ip-api, OpenStreetMap, GeographQL, IP Address Details.

Compare alternatives →

Listed from APIs.guru (CC0).