How to setup TomTom geocoding


User guides



TomTom is a leading independent location technology specialist, shaping mobility with highly accurate maps, navigation software, real-time traffic information and services. Their geocoding service can also be used within Maps Marker Pro since v4.6 after signing up for an API key.

Tutorial: How to register an API key (for layers + geocoding)

  1. Register a free account at
  2. Login with your account at
  3. On the Dashboard click on the button “Add new key”:
  4. Enter a “Key Name” and select the following products: “Map Display API” and “Search API” – it is also recommended to “Domain whitelisting” to prevent misusage of your key and add the domain of your website:
  5. Click on “Create a key” to finish
  6. Copy your license key to your clipboard:
  7. Login to your WordPress site and head to Maps Marker Pro / Settings / Geocoding / TomTom and paste that key there:
  8. Navigate to Settings / Geocoding / Provider and select TomTom as geocoding provider:
  9. Navigate to Settings / Layer / TomTom and also paste your TomTom API key there:
  10. Save Settings.

That´s it. Afterwards you can start using TomTom geocoding when creating a new map or marker:

Additionally you can now also choose TomTom basemaps for your maps:

Terms of services

TomTom can be used after registering a mandatory API key. The related terms of services can be found at

Usage limits

With their free plan, TomTom allows up to 2.500 requests/day for all of their APIs. The limit is set to 5 calls per second for non-tile based APIs and 1,000 for tile based APIs. If you’re using the TomTom Maps APIs for free and you exceed the daily free credit limit of 2,500 API transactions, you will receive an “HTTP 403 – Over the limit error”.

Larger plans are are available for higher usage limits.

Reference for all TomTom settings

Location biasing

You can provide latitude and longitude values as well as a radius in meters – please note that configuring these settings biases the resulted to the indicated area, the results may not be fully restricted to this specified area though.


Changes the language of the results. You can pass IETF language tags (IETF BCP 47).
If empty, the language set in WordPress will be used.


Changes the countries to search in. You can pass two letters country codes (ISO 639-1).
If empty, the entire planet will be searched.

Updated on 29 May 2022