Loading
Loading
Turn any GPS coordinates into a full street address with our reverse geocoding API. Returns structured JSON with POI, city, state, country, and postcode.
The API accepts WGS84 decimal degree coordinates and returns the nearest matching address with a complete breakdown of every administrative level. A single request returns one result: the closest address to the submitted coordinates.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. Both lat and lon are required.
latrequiredFloatLatitude of the location. Valid range: -90 to 90.
lonrequiredFloatLongitude of the location. Valid range: -180 to 180.
The following headers can be used in your API requests.
Accept-LanguageoptionalStringdefault: enLanguage preference for results. Single code or comma-separated list. Falls back to English if needed.
A successful request returns a 200 OK response with a JSON object containing the address data. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.
latLatitude of the matched location.
lonLongitude of the matched location.
nameName of the matched place.
categoryHigh-level category, e.g. amenity, place, natural, building, highway.
typeSpecific type within the category, e.g. fast_food, city, park, house_number.
poiPoints of interest at or near the coordinates.
streetStreet or road name.
areaNeighbourhood, suburb, district, or similar sub-city area.
postcodePostal code.
cityCity, town, or municipality.
countyCounty, district, shire, or prefecture.
state_codeISO 3166-2 subdivision code, e.g. US-TX.
stateState, region, province, or division.
country_codeISO 3166-1 alpha-2 country code in uppercase.
countryCountry name.
full_addressFull address as a single readable line.
bounding_boxSpatial extent of the feature: [lat_min, lat_max, lon_min, lon_max].
Each object in the poi array contains the following fields:
poi[].nameName of the point of interest.
poi[].categoryPOI category.
poi[].typeSpecific type within the POI category.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
please pass correct parameters
Latitude must be between -90 and 90.
Longitude must be between -180 and 180.
Please provide a valid latitude value.
Please provide a valid longitude value.
No results found for the given query.