Skip to content

Maps API

by tomtom.com

API keyHTTPSGeocoding
Open documentation ↗

Overview

The Maps API web services suite offers the following APIs: - Raster The Maps Raster API renders map data that is divided into gridded sections called tiles. Tiles are square images (png or jpg format) in various sizes which are available at 19 different zoom levels, ranging from 0 to 20. For zoom level 0, the entire earth is displayed on one single tile, while at zoom level 20, the world is divided into 2<sup>40</sup> tiles. - Vector Similar to Maps Raster API, the Maps Vector API serves data on different zoom level ranging from 0 to 22. For zoom level 0, the entire earth is displayed on one single tile, while at zoom level 22, the world is divided into 2<sup>44</sup> tiles. The Maps Vector Service delivers geographic map data packaged in a vector representation of squared sections called vector tiles. Each tile includes pre-defined collections of map features (points, lines, road shapes, water polygons, building footprints, ect.) delivered in one of the specified vector formats. Format of the tile is formally described using protobuf schema.

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

At a glance

Authentication
API key
HTTPS
Yes
CORS
Unknown
Category
Geocoding
Base URL
https://api.tomtom.com
Version
1.0.0
Endpoints
10
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/map/VERSIONNUMBER/copyrights.FORMAT" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch("https://api.tomtom.com/map/VERSIONNUMBER/copyrights.FORMAT", {
  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/map/VERSIONNUMBER/copyrights.FORMAT",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/map/{versionNumber}/copyrights.{format}Copyrights whole world
GET/map/{versionNumber}/copyrights/caption.{format}Captions
GET/map/{versionNumber}/copyrights/{minLon}/{minLat}/{maxLon}/{maxLat}.{format}Copyrights bounding box
GET/map/{versionNumber}/copyrights/{zoom}/{X}/{Y}.{format}Copyrights tile
GET/map/{versionNumber}/staticimageStatic Image
GET/map/{versionNumber}/tile/{layer}/{style}/{zoom}/{X}/{Y}.pbfTile
GET/map/{versionNumber}/tile/{layer}/{style}/{zoom}/{X}/{Y}.{format}Tile
GET/map/{versionNumber}/wms/GetMap
GET/map/{versionNumber}/wms//GetCapabilities
GET/map/{versionNumber}/wmts/{key}/{wmtsVersion}/WMTSCapabilities.xmlWMTS

Questions

Does the Maps API need an API key?

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

Does the Maps API support HTTPS?

Yes, the Maps API is served over HTTPS.

How many endpoints does the Maps API have?

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

What are alternatives to the Maps API?

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

Compare alternatives →

Listed from APIs.guru (CC0).