TomTom's Geocoding API converts addresses and place names into coordinates and back, drawing on TomTom's own commercial map data rather than open datasets like OSM, and sits alongside its routing, traffic, and search products. TomTom is steering new integrations toward its newer Orbis Maps platform while keeping this legacy Maps/Geocoding API live and documented. New accounts get 20,000 free geocoding requests a month with no card required, with metered paid tiers above that.
Send it on every request as a query param?key=<key>
Stored keyNo key stored
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
Servers
https://api.tomtom.com
Auth
api_key
Additional Data1
GET/search/{versionNumber}/additionalData.{ext}Additional Data
Parameters
Name
In
Required
Type
ext
path
yes
string
geometries
query
yes
string
geometriesZoom
query
no
integer
Responses
Status
Description
Schema
200
OK: additional data were retrieved and the body of the response contains requested data.
—
400
Bad request: one or more parameters(i.e. geometries, ext) were incorrectly specified.
—
403
Permission, capacity, or authentication issues:
- Forbidden
- Not authorized
- Account inactive
- Account over queries per second limit
- Account over rate limit
- Rate limit exceeded
—
404
Not Found: the requested resource could not be found, but it may be available again in the future.
—
405
Method Not Allowed: the client used a HTTP method other than GET.
—
408
Request timeout.
—
414
Requested uri is too long.
—
500
An error occurred while processing the request. Please try again later.
—
502
Internal network connectivity issue.
—
503
Service currently unavailable.
—
504
Internal network connectivity issue or a request that has taken too long to complete.
