Autocomplete
GET
https://api.woosmap.com/localities/autocomplete
Returns worldwide place suggestions for a text query, matching on whole words or substrings. Designed for as-you-type input: addresses, cities, postal codes, suburbs, and more.
Ratelimit: 50/1s
Authorization
Header Parameters
accept-language
string
Query Parameters
language
string Defaults to
"" data
string Defaults to
standard components
string
types
LocalitiesTypes | LocalitiesTypesPoi | LocalitiesTypesPoiAlias Defaults to
locality|postal_code excluded_types
LocalitiesTypes | LocalitiesTypesPoi | LocalitiesTypesPoiAlias
input
string required
custom_description
string
extended
string
location
string
radius
integer Defaults to
100000 Response
Successful Response
localities
object[] required
Show 7 propertiesHide 7 properties
Show 1 propertiesHide 1 properties
Errors
401
Unable to locate credentials.
application/json
detail
string required
402
Out of free quota.
application/json
detail
string required
403
Credentials found, but not matching.
application/json
detail
string required
422
Validation Error
429
Rate limit reached
application/json
detail
string required
curl -L 'https://api.woosmap.com/localities/autocomplete/?input=Lond&components=country%3Agb&no_deprecated_fields=true&key=YOUR_PUBLIC_API_KEY' \
-H 'Referer: http://localhost'
const requestOptions = {
method: "GET",
redirect: "follow"
};
fetch("https://api.woosmap.com/localities/autocomplete/?input=Lond&components=country%3Agb&no_deprecated_fields=true&key=YOUR_PUBLIC_API_KEY", requestOptions)
.then((response) => response.text())
.then((result) => console.log(result))
.catch((error) => console.error(error));
import requests
url = "https://api.woosmap.com/localities/autocomplete/?input=Lond&components=country%3Agb&no_deprecated_fields=true&key=YOUR_PUBLIC_API_KEY"
payload = {}
headers = {
'Referer': 'http://localhost'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
{ "localities": [ { "public_id": "Ch6qA8cLmvyvEEoFy6nYeFcEdNU=", "type": "locality", "types": [ "locality", "city" ], "description": "London, City of London, United Kingdom", "matched_substrings": { "description": [ { "offset": 0, "length": 4 } ] } }, { "public_id": "m/T2C4YI2LgszkKXrELBC+9dfC8=", "type": "locality", "types": [ "locality", "city" ], "description": "Derry/Londonderry, Derry City and Strabane, United Kingdom", "matched_substrings": { "description": [ { "offset": 6, "length": 4 } ] } }, { "public_id": "J6eISGMjjvQwPkao8rsByB3aVwM=", "type": "locality", "types": [ "locality", "village" ], "description": "London Colney, Hertfordshire, United Kingdom", "matched_substrings": { "description": [ { "offset": 0, "length": 4 } ] } }, { "public_id": "52MnrbHVWH21CLWH8VY/YWKhqeM=", "type": "locality", "types": [ "locality", "village" ], "description": "London Apprentice, Cornwall, United Kingdom", "matched_substrings": { "description": [ { "offset": 0, "length": 4 } ] } }, { "public_id": "S/5AkUmMBhX35qVI2jR38+dALwk=", "type": "locality", "types": [ "locality", "city" ], "description": "City of London, United Kingdom", "matched_substrings": { "description": [ { "offset": 8, "length": 4 } ] } } ] }