API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Batch Processing
★  Specification
★  SDKs
★  Stats
Data Tools
Security and Networking

Geocode Reverse

Convert a geographic coordinate (latitude and longitude) into a real world address or location.

Reverse geocoding is the opposite of address geocoding. This API is ideal for applications which process location data (for example mobile GPS data) and need to correlate this with real places. If your coordinates do not map directly (or very close to) to a real address then you can still locate street, city, region and country information.

Our mapping data covers the entire globe and is continuously updated as new geographic data is created.

End Point

Test API
API Request
latitudeYesstringThe location latitude in decimal degrees format
longitudeYesstringThe location longitude in decimal degrees format
language-codeNostringenThe language to display results in, available languages are:
  • de, en, es, fr, it, pt, ru
API Response
foundbooleanTrue if these coordinates map to a real location
addressstringThe fully formatted address
address-componentsmapThe components which make up the address such as road, city, state, etc
citystringThe city of the location
statestringThe state of the location
countrystringThe country of the location
country-codestringThe ISO 2-letter country code of the location
country-code3stringThe ISO 3-letter country code of the location
currency-codestringISO 4217 currency code associated with the country
postal-codestringThe postal code for the location
location-typestringThe detected location type ordered roughly from most to least precise, possible values are:
  • address - indicates a precise street address
  • street - accurate to the street level but may not point to the exact location of the house/building number
  • city - accurate to the city level, this includes villages, towns, suburbs, etc
  • postal-code - indicates a postal code area (no house or street information present)
  • railway - location is part of a rail network such as a station or railway track
  • natural - indicates a natural feature, for example a mountain peak or a waterway
  • island - location is an island or archipelago
  • administrative - indicates an administrative boundary such as a country, state or province
location-tagsarrayArray of strings containing any location tags associated with the address. Tags are additional pieces of metadata about a specific location, there are thousands of different tags. Some examples of tags: shop, office, cafe, bank, pub
Daily Limits
Free TierTier 1Tier 2Tier 3