Back to data catalog

Geocoding API

Geocoding and reverse-geocoding based on OpenStreetMap®-data

OpenAPI Spec

Specification of all endpoints available in the geocoding api.

Github

Explore the source code behind the geocoding api.

More info

Data sources

The API is exclusively fetching data from https://photon.komoot.io. The service is based on OpenStreetMap® data, which is licensed under the Open Data Commons Open Database License (ODbL), by the OpenStreetMap Foundation (OSMF).

Processing

The data obtained from https://photon.komoot.io is presented as is, without any further processing or modification.

Examples

Example 1

Retrieving the coordinates of Berlin using JavaScript.

const response = await fetch(
	"https://api-test.openepi.io/geocoding/?" +
		new URLSearchParams({ q: "Berlin" })
)
const data = await response.json()

// prints the coordinates of the first result
console.log(data.features[0].geometry.coordinates)

Example 2

Retrieving the coordinates of Berlin using Python.

from httpx import Client

with Client() as client:
    response = client.get(
        url="https://api-test.openepi.io/geocoding/",
        params={"q": "Berlin"},
    )

    data = response.json()

    # prints the coordinates of the first result
    print(data["features"][0]["geometry"]["coordinates"])

Example 3

Retrieving a location near the given coordinate using JavaScript.

const response = await fetch(
	"https://api-test.openepi.io/geocoding/reverse?" +
		new URLSearchParams({
			lon: "13.438596",
			lat: "52.519854",
		})
)
const data = await response.json()

// prints the name of the first result
console.log(data.features[0].properties.name)

Example 4

Retrieving a location near the given coordinate using Python.

from httpx import Client

with Client() as client:
    response = client.get(
        url="https://api-test.openepi.io/geocoding/reverse",
        params={"lon": 13.438596, "lat": 52.519854}
    )

    data = response.json()

    # prints the name of the first result
    print(data["features"][0]["properties"]["name"])