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.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis 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 detailsBesides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.
See 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.