Convert a geographic coordinate (latitude and longitude) into a real world address.
This API is ideal for applications which process raw location data like coordinates obtained from mobile GPS devices.
Reverse geocoding is the opposite process of address geocoding,
you can get detailed location data right down to a specific building or zoomed out to the street, city or country level.
The language to display results in, available languages are:
de, en, es, fr, it, pt, ru
zoom
no
string
address
The zoom level to respond with:
address - the most precise address available
street - the street level
city - the city level
state - the state level
country - the country level
API Response
Parameter
Type
Description
found
boolean
True if these coordinates map to a real location
latitude
float
The location latitude
longitude
float
The location longitude
address
string
The complete address using comma-separated values
address-components
map
The components which make up the address such as road, city, state, etc
city
string
The city of the location
state
string
The state of the location
region-code
string
The ISO 3166-2 region code for the location
country
string
The country of the location
country-code
string
The ISO 2-letter country code of the location
country-code3
string
The ISO 3-letter country code of the location
currency-code
string
ISO 4217 currency code associated with the country
postal-code
string
The postal code for the location
postal-address
string
The formatted address using local standards suitable for printing on an envelope
location-type
string
The 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-tags
array
Array 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
timezone
map
Map containing timezone details for the location:
Parameter
Type
Description
id
string
The time zone ID as per the IANA time zone database (tzdata)
name
string
The full time zone name
abbr
string
The time zone abbreviation
date
string
The current date at the time zone (ISO 8601 format 'YYYY-MM-DD')
time
string
The current time at the time zone (ISO 8601 format 'hh:mm:ss.sss')
offset
string
The UTC offset for the time zone (ISO 8601 format '±hh:mm')
API Performance
Characteristic
Value
Description
Avg Latency
80ms
Average RTT for requests within the same data center/region
Max Rate
20/second
Maximum inbound request rate. Exceeding this will result in request throttling
Max Concurrency
250
Maximum concurrent/simultaneous requests. Exceeding this will result in error code 06 [TOO MANY CONNECTIONS]