Reverse Geocoding to City API
GPS and device location APIs give you coordinates. This API turns those coordinates into something useful: the country, state, city, suburb, and postal code the user is actually in.
Most reverse geocoding services are built around street addresses — they try to resolve coordinates to the nearest building. That works well in dense urban areas but degrades quickly for mobile users, regional locations, and anywhere the street data is sparse. BigDataCloud's approach is different: we resolve to administrative and non-administrative boundaries instead, which means consistent results regardless of how populated the area is.
Key characteristics of this API:
- Sub-millisecond response times — no external network hops, pure boundary lookup
- Results in over 100 languages
- Full postal code accuracy for the US, Great Britain, and Australia; partial for other countries
- Works reliably in rural, regional, and less-populated areas where street-level geocoding struggles
For background on how reverse geocoding works and where different approaches break down, see How reliable are reverse geocoding APIs for location-based services?
https://api-bdc.net/data/reverse-geocodeParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
latitude | number (double) | Optional | Latitude value as per WGS 84 reference system (GPS system). Expected values are in [-90, 90] range |
longitude | number (double) | Optional | Longitude value as per WGS 84 reference system (GPS system). Expected values are in [-180, 180] range |
localityLanguage | string | Optional | Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. If the requested language is unavailable for a requested location, it will default to English. If no English variant is available, will provide the native, local names. Use 'default' as the requested value to automatically adjust the language to the first administrative language in the Country. |
key | string | Optional | Your API key |
Responses
Sample Request
https://api-bdc.net/data/reverse-geocode?latitude=-34.93129&longitude=138.59669&localityLanguage=en&key=[YOUR API KEY]Sample Response
Response Schema
▶fipsobjectFIPS code object, omitted if unavailable. FIPS (Federal Information Processing Standards) Codes are codes used by the Census Bureau to uniquely identify places in the US. Visit FIPS FAQ page for more information.
▶localityInfoobjectlocalityInfo object
▶administrativearrayAdministrative authorities as ordered by area (most significant first). Omitted if no administrative boundaries are available
▶informativearrayNon-administrative boundaries as ordered by area (most significant first). Omitted if unavailable
Sample Response
Sample Response
Sample Response
Sample Response