Geocoding API

Search by name (forward)

GET https://api.maptiler.com/geocoding/{query}.json

Forward geocoding (search by place name).

Request

Security: API Key

Path Parameters

Parameters Type Description
query string
Place name to search for.
Example: Zurich

Query Parameters

Parameters Type Description
bbox string
Only search for results in the specified area. Specified as "minx,miny,maxx,maxy".
Examples: 5.9559,45.818,10.4921,47.8084
Style: Comma separated values
language string
Prefer results in specific language. It's possible to specify multiple values.
Examples: de,en
Style: Comma separated values
proximity string
Prefer results close to a specific location. Specified as "longitude,latitude".
Examples: 8.528509,47.3774434
Style: Comma separated values
Example requests

https://api.maptiler.com/geocoding/zurich.json?key=YOUR_MAPTILER_API_KEY

Response

Code Content Description
200 application/json
400 Query too long / Invalid parameters
403 Key is missing, invalid or restricted

Search by coordinates (reverse)

GET https://api.maptiler.com/geocoding/{longitude},{latitude}.json

Forward geocoding (search by place name).

Request

Security: API Key

Path Parameters

Parameters Type Description
longitude number
Example: 8.528509
latitude number
Example: 47.3774434

Query Parameters

Parameters Type Description
bbox string
Only search for results in the specified area. Specified as "minx,miny,maxx,maxy".
Examples: 5.9559,45.818,10.4921,47.8084
Style: Comma separated values
language string
Prefer results in specific language. It's possible to specify multiple values.
Examples: de,en
Style: Comma separated values
proximity string
Prefer results close to a specific location. Specified as "longitude,latitude".
Examples: 8.528509,47.3774434
Style: Comma separated values
Example requests

https://api.maptiler.com/geocoding/8.528509,47.3774434.json?key=YOUR_MAPTILER_API_KEY

Response

Code Content Description
200 application/json
400 Query too long / Invalid parameters
403 Key is missing, invalid or restricted