The geocoding API is used to convert a known address (like "Unter den Linden 78 10117 Berlin") into geo-coordinates.


The API is callable via GET and POST and returns the geo-coordinates and the corresponding correct postal address.


curl -X GETße%2032,%201040%20Wien \
    -H 'Authorization: Bearer API_KEY_HERE'


curl -X POST \
    -H 'Authorization: Bearer API_KEY_HERE' \
    -H 'Content-Type: application/json' \
    -d '{ "query": "Wiedner Hauptstraße 32, 1040 Wien" }'


Both endpoints return the result in JSON format and with HTTP status 200. If the address is not recognized, an empty response with HTTP status 204 is returned.

  "position": {
    "latitude": 48.1954,
    "longitude": 16.36688
  "address": {
    "houseNumber": "32",
    "street": "Wiedner Hauptstraße",
    "city": "Vienna",
    "postalCode": "1040",
    "country": "Austria",
    "countryCode": "AT"


query: String

The query as a free-text address.

language: String = en

The language used for result localization based on ISO 639-1. For example: en or fr

Possible errors

Identifier Description
message.queryMustNotBeBlank Parameter queryis required and must not be blank.
message.languageMustBeValid Parameter language must be valid and covered by ISO 639.

It should be noted that there are a number of common error messages, which can be found in the "Possible errors" section of the general documentation.

Geocoding costs
Convert a known address to geo-coordinates.
Credits spent
Credit cost per REST call
EUR per call
Price depends on your subscription