Introduction

Service version: 2
Last edit: 2023.10.03

What is TomTom's Geocoding API?

The Geocoding API is a powerful tool that converts addresses, such as "109 Park Row, New York, United States," into geographic coordinates (e.g., "lat": 40.71226, "lon": -74.00207). Designed for machine-to-machine interaction, the TomTom Geocoding API is capable of handling requests from automated systems to geocode addresses that may be incomplete, incorrectly formatted, or contain typos, providing the best possible result.

It infers geographic information given a textual place description (postal address) and additional (optional) parameters that guide the search. Examples of optional parameters include a list of countries to search for and a location to search around. The main elements in the geographic information include:

  • address components
  • corresponding geographic coordinates
  • a complete formatted address

The Geocoding API provides a simple way to make a request and obtain the desired geographic information in JSON or XML formats, depending on the user's preference. Please note that this API does not return Points of Interest (POIs). It consists of the following endpoints:

Geocode

Use the geocode endpoint when you just have an address or a partial address.

Structured Geocode

Use the structured geocoding endpoint when you have data that has already been split into multiple fields such as streetNumber, streetName, city/town, and postal code.

Common use cases

  • Get the coordinates to locate the place:
    • To deliver or pickup a delivery.
    • To pick up and drop off passengers.
    • Do route planning.
  • Address validation/verification.
  • Geospatial analysis.
  • Data cleaning.
  • Data enhancement.
  • Get boundaries, geometries.
  • Resolve address issues in user apps which are not human-to-machine interactions.

Getting started

To access the Geocoding API, you will need an API key, which can be obtained by registering for the TomTom Developer Portal. See the following instructions. Once registered, navigate to your Dashboard and locate the API Key (the first one is called "My first API Key"). Sample code and integration options are available in the TomTom Knowledge Base.

  1. To get your API Key, you first need to be registered for the TomTom Developer Portal. If you don't have an account, no worries! Register / Sign in now before continuing.
  2. Once you are registered, go to your Dashboard and locate the API Key that you would like to use (we've created the first one for you, it's called My first API Key).

To start, read the documentation and consider using the TomTom Maps SDK for Web, iOS, or Android. Check related blog articles on the TomTom Developer Portal for further information and resources.