Introduction

Service version: 2
Last edit: 2020.06.30

What is TomTom's Search API?

Search is a RESTful API designed for developers allowing single-line fuzzy search for addresses and POIs. Search assigns a latitude/longitude to a specific address, cross street, geographic feature, or point of interest (POI).

The Search API contains the following services with their endpoints:

Search

This is a fuzzy single-line search process for query-based relevant addresses and POIs, with the option to restrict the search within a certain geometry.

Autocomplete

Autocomplete enables you to make a more meaningful Search API call by recognizing entities inside an input query and offering them as query terms.

Geocoding

Geocoding only looks up locations of addresses with the ability to provide single line or structured addresses as input.

Reverse Geocoding

Reverse Geocoding turns latitudes / longitudes into human readable addresses with the ability to look up cross streets.

Filters

Filter your own or 3rd party POIs (Points of Interest) within a certain geometry.

Additional Data

Returns sets of coordinates that represent the outline of a city, country, or land area.

POI Categories

Provides a full list of POI categories and sub-categories, together with their translations and synonyms.

Batch Search

This is a subset of the Search API and dispatches batches of requests to endpoints from the Search API suite with ease.

Search API Market Coverage

Provides a list of all countries supported by the Search API engine.

Search API Release Notes

Records the release date with the addition, improvement, deprecation, removal, and known issues associated with a product release.

Supported Category Codes

Describes category codes for supported category names.

Supported Connector Types

Describes supported connector types.

Supported Languages

Describes language tags used as language parameter values.


Getting started

  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).
  3. Read the documentation and start coding.
  4. Consider using the TomTom Maps SDK for Web, for iOS, and for Android.
  5. Check related Blog articles for further information.

Common use cases

Here are some potential use cases.

  • Search for an address, a POI (Points Of Interest), or a combination of both.
  • Search for area, for example: "Chinatown".
  • Search in the direction you are heading.
  • Search for cross streets, for example: "Clay Street Drumm Street".
  • Search for a POI near a POI or address, for example:
    • "Coffee near XYZ company"
    • "Restaurants on Main Street"
    • "ATMs near AMC Theater"
    • "Parking near 1234 Main Street"

Features

This is a high-level view of our Search API features.

  • Fuzzy search, with optional:
    • Typeahead
    • Fuzzines level setting
  • Freetext and structured geocoding
  • POI search
  • POI category search
  • Geometry search, with:
    • Point and radius
    • Boundingbox
  • Mature ranking, with Landmarks