M
API Matrix

TomTom API

Geocoding / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)
77 Score
Grade B
Visit Official Site Compare Alternatives

Overview

TomTom offers a comprehensive suite of mapping APIs covering maps, routing, traffic, and place search for developers. You can use it to display interactive maps, calculate routes with live traffic, and find points of interest worldwide. An API key from the TomTom developer portal is required.

💡

Beginner Tip

Start with the Search API to find places by name and the Routing API to get directions—these are the most commonly used endpoints and have detailed documentation with interactive examples on the TomTom developer portal.

Available Data

TomTom data via REST API
JSON-formatted response data
Requires API key authentication

Example Response

JSON Response 
{
  "status": "success",
  "data": {
    "result": "Data from TomTom",
    "description": "Maps, Directions, Places and Traffic APIs",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

results List of matching places or points of interest returned by the search.
id Unique TomTom identifier for the place or route element.
score Relevance score of the search result; higher values indicate better matches.
address Structured address object with street, city, country, and postal code fields.
position Geographic coordinates (lat and lon) of the result location.

Implementation Example 

const url = "https://developer.tomtom.com/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

403 Forbidden or Developer Inactive Your API key is invalid, expired, or does not have access to the requested service.
✓ Log in to developer.tomtom.com, verify your key is active, and confirm the service is enabled for your application.
400 Bad Request on routing endpoint The route request is missing required parameters like origin or destination, or has invalid coordinate formats.
✓ Coordinates must be in lat,lng format (e.g., 52.5200,13.4050). Ensure both origin and destination are provided.
Map tiles not displaying Incorrect tile URL format or missing API key in the tile request.
✓ Follow the TomTom Maps SDK quickstart guide exactly. The API key must be appended to each tile URL as the key= parameter.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 17/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category Geocoding
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →

Actinia Grass GIS

0

Actinia Grass GIS provides programmatic access to actinia is an open source rest api for geographical data that uses grass gis via REST API.

API Key Intermediate HTTPS

Apiip

82

Apiip is an IP geolocation API that returns detailed location data including city, country, timezone, and currency for any IP address.

API Key Intermediate HTTPS

Battuta

22

Battuta is a hierarchical location API that lets you browse countries, regions, and cities in a cascade, making it easy to build location pickers with dependent dropdowns.

API Key Intermediate

BigDataCloud

⭐ Beginner's Pick
77

BigDataCloud offers a fast and highly accurate IP geolocation API that also includes network security checks and a confidence area metric to indicate how precise the location is.

API Key Intermediate HTTPS

Bing Maps

87

Bing Maps (now Azure Maps) is Microsoft's mapping platform that lets you geocode addresses, reverse geocode coordinates, get routes, and embed interactive maps in your applications.

API Key Intermediate HTTPS