Reverse Geocoding to City API
Introduction
Reverse geocoding is the process of back (reverse) coding of a point location (Latitude, Longitude) to a readable address or a place.
Existing reverse geocoding providers look for the closest street address for the provided coordinates. In most use-cases, this level of detail is overkill, providing an incredibly slow service of minimal accuracy, with quality that varies wildy for mobile and regional users.
Our Reverse Geocoding API is the first to deliver administrative/non-administrative boundaries-based results and as such, it is the perfect choice when you need to resolve a user's practical area such as their city, state or country rather than their street address.
A prime use-case is when utilising client-side W3C geolocation and you need to recognise your customer's closest outlet, or what promotions are available in their region.
This API not only offers detailed locality information based on your customer's Latitude & Longitude, it is also exceptionally fast with each response being generated with sub-millisecond timing, allowing for true real-time applications.
https://api.bigdatacloud.net/data/reverse-geocode
CURL Example
curl -X GET --header 'Accept: application/json' 'https://api.bigdatacloud.net/data/reverse-geocode'
Visit our SDK page to access API clients in specific languages like Javascript, Python + PHP.
Response
Response Format
|
Field |
Data type |
Description |
|---|---|---|
|
latitude |
float |
Requested Latitude |
|
longitude |
float |
Requested Longitude |
|
localityLanguageRequested |
string |
localityLanguage input parameter received |
|
countryName |
string |
Country name. Omitted if not available |
|
countryCode |
string |
Country code. Omitted if not available |
|
principalSubdivision |
string | Principal subdivision. Omitted if not available |
|
locality |
string | Locality name. Omitted if not available |
|
postcode |
string |
Postcode. Omitted if not available |
|
localityInfo |
<LocalityInfo> object |
Detailed reverse geocoded locality information localised to the language as defined by ‘localityLanguage’ request parameter |
API Endpoint
| Endpoint: | /data/reverse-geocode |
|---|---|
| Full URL: | https://api.bigdatacloud.net/data/reverse-geocode |