Find Place
Query for geographical places across countries. Each query will return a list of place suggestions, which consists of a place name, descriptive name and id.
This API returns geographical information such as countries, capitals, administrative areas and more. It is ideal for correctly identifying a place along with any other details like geolocation.
Implementing Place Autocomplete
Extracting the full information of a place is a 2 step process:
- Retrieve place suggestions via /places
- Retrieve the entire place with the ID provided in the suggestion
Suggestion Format
Each place suggestion contains a descriptive name which you can provide to users to uniquely identify a place.
Rate Limiting and Cost
The rate limit for the Autocomplete API is 3000 requests per 5 minutes. HTTP Headers inform about the current rate limit.
Autocomplete API usage does not impact your balance, but resolving a suggestion to a full address requires a paid request. Autocomplete requests without subsequent paid requests may result in rate limitation or suspension.
Query parameters
API Key
Your unique identifier that allows access to our APIs.
Begins ak_. Available from your dashboard
Specifies the place you wish to query. Query can be shortened to q=
Filter by Country
Filter by country ISO code. Uses 3 letter country code (ISO 3166-1) standard.
Filter by multiple countries with a comma separated list. E.g. GBR,IRL
Bias by Country Bias by country ISO code. Uses 3 letter country code (ISO 3166-1) standard. Bias by multiple countries with a comma separated list. E.g. GBR,IRL
Bias by Geolocation
Bias search to a geospatial circle determined by an origin and radius in meters. Max radius is 50000. Uses the format bias_lonlat=[longitude],[latitude],[radius in metres] Only one geospatial bias may be provided
Bias by Geolocation of IP
Biases search based on approximate geolocation of IP address.
Set bias_ip=true to enable.
Response
Success
Example response
{
"result": {
"hits": [
{
"id": "geonames_2643743",
"name": "London",
"descriptive_name": "London, Greater London, England",
"country_iso": "GBR"
},
{
"id": "geonames_4517009",
"name": "London",
"descriptive_name": "London, Madison County, Ohio",
"country_iso": "USA"
},
{
"id": "geonames_4298960",
"name": "London",
"descriptive_name": "London, Laurel County, Kentucky",
"country_iso": "USA"
}
]
},
"code": 2000,
"message": "Success"
}