The Geocoding API gives developers access to TomTom’s first class geocoding service. Developers may call this service through either a single or batch geocoding request. This service supports global coverage, with house number level matching in over 50 countries, and address point matching where available. Using Geocoder you can retrieve TomTom’s geocoded data from Geocoding API.


>>> import geocoder
>>> g = geocoder.tomtom('San Francisco, CA', key='<API KEY>')
>>> g.json

Command Line Interface

$ geocode 'San Francisco, CA' --provider mapbox --out geojson

Environment Variables

To make sure your API key is store safely on your computer, you can define that API key using your system’s environment variables.

$ export TOMTOM_API_KEY=<Secret API Key>


  • location: Your search location you want geocoded.
  • key: use your own API Key from TomTom.
  • method: (default=geocode) Use the following:
    • geocode