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.
formatoptionalStringdefault: jsonResponse format: 'json'.
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.
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].
poipoi field in the Forward Geocoding API. View POI field detailsSee the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
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.