Sign in

v51

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012281206.0 KB
geocode

Translate coordinates to the closest address(es)/places/stops.

get/api/v1/reverse-geocode

Query parameters

placestring required

latitude, longitude in degrees

typeLocationType[]

Optional. Default is all types.

Only return results matching one of the given types. For example, this can be used to allow only ADDRESS and STOP results.

numResultsinteger

Optional. Number of results to return.

If omitted, 5 results are returned by default. Must be <= server config variable reverse_geocode_max_results.

Response

A list of guesses to resolve the coordinates to a location

type'ADDRESS' | 'PLACE' | 'STOP' required

location type

categorystring

Experimental. Type categories might be adjusted.

For OSM stop locations: the amenity type based on https://wiki.openstreetmap.org/wiki/OpenStreetMap_Carto/Symbols

namestring required

name of the location (transit stop / PoI / address)

idstring required

unique ID of the location

latnumber required

latitude

lonnumber required

longitude

levelnumber

level according to OpenStreetMap (at the moment only for public transport)

streetstring

street name

houseNumberstring

house number

countrystring

ISO3166-1 country code from OpenStreetMap

zipstring

zip code

tzstring

timezone name (e.g. "Europe/Berlin")

scorenumber required

score according to the internal scoring system (the scoring algorithm might change in the future)

modesMode[]

available transport modes for stops

importancenumber

importance of a stop, normalized from [0, 1]