Reverse Geocoding

Reverse geocoding is the technique of transforming geographic coordinates into a readable address or place name. It serves as the converse of forward geocoding, which turns addresses into geographic coordinates. This process is particularly useful in applications that require identifying specific location details from GPS coordinates.

SecurityApiKeyAuth

Request

query Parameters

lat required	number [ -90 .. 90 ] Latitude
lon required	number [ -180 .. 180 ] Longitude
format	string Output format Enum: "json" "xml"
addressdetails	number Include a breakdown of the address into elements. Enum: 0 1
extratags	number Include additional information in the result if available, e.g. wikipedia link, opening hours. Enum: 0 1
namedetails	number Include a list of alternative names in the results. These may include language variants, references, operator and brand. Enum: 0 1
accept-language	string Preferred language order for showing search results, overrides the value specified in the Accept-Language HTTP header. Either use a standard RFC2616 accept-language string or a simple comma-separated list of language codes. Example: accept-language=en
zoom	number [ 0 .. 18 ] The required level of detail for the address is specified by a numerical value. The default setting is 18. This number approximately aligns with the zoom levels utilized in XYZ tile sources within frameworks such as Leaflet.js, OpenLayers, and others. The zoom levels correspond to varying degrees of address detail as follows: `3` - country `5` - state `8` - county `10` - city `14` - suburb `16` - major street `17` - any street `18` - building Example: zoom=10
polygon_geojson	number Output geometry of results as a GeoJSON. Only one of `polygon_` options can be used at a time. Enum: 0 1
polygon_kml	number Output geometry of results as a KML. Only one of `polygon_` options can be used at a time. Enum: 0 1
polygon_svg	number Output geometry of results as a SVG. Only one of `polygon_` options can be used at a time. Enum: 0 1
polygon_text	number Output geometry of results as a WKT. Only one of `polygon_` options can be used at a time. Enum: 0 1
polygon_threshold	number Return a simplified version of the output geometry. The parameter is the tolerance in degrees with which the geometry may differ from the original geometry. Topology is preserved in the result.

Responses

200

Reverse geocoding result

400

Incorrect request parameters.

401

API key is incorrect or not provided.

402

Subscription daily limit exceeded.

403

Subscription suspended.

get/reverse

Request samples

curl
JavaScript
Ruby
Go
Python

Response samples

{"place_id": "string",
"licence": "string",
"osm_type": "string",
"osm_id": "string",
"lat": "string",
"lon": "string",
"display_name": "string",
"boundingbox": ["string",
"string",
"string",
"string"
],
"address": {"house_number": "string",
"road": "string",
"city": "string",
"county": "string",
"state": "string",
"postcode": "string",
"country": "string",
"country_code": "string"
}
}