Migration Guide

Public preview notice

A newer version of this API is available here.
For new integration, we recommend using the latest Orbis version.
To review changes or to migrate, please find the migration guide here.

Important notes

This TomTom Orbis API is in public preview.
This API is powered by TomTom Orbis Maps.
See the TomTom Orbis Maps documentation for more information.

Where do I find the new endpoints

The following endpoints are supported:

Geocode

Please notice that following endpoints are not supported in TomTom Orbis Maps Geocode API:

Structured Geocode

The new Orbis Geocode API endpoint has the following prefix:

get

URL request example

1
https://api.tomtom.com/maps/orbis/places/geocode/...

instead of:

get

URL request example

1
https://api.tomtom.com/search/{versionNumber}/geocode/...

Please check the respective endpoint’s documentation page for details.

Changes in the parameters or responses

Important note:

Either the apiVersion URL parameter or the TomTom-Api-Version header needs to be present.

There are no changes in parameters or responses.
Currently supported geopolitical views: Unified, AR, MA, and IL.