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”.
Example: 5.9559,45.818,10.4921,47.8084 |
| proximity | string | Prefer results close to a specific location. Specified as “longitude,latitude”.
Example: 8.528509,47.3774434 |
| language | string | Prefer results in specific language. It’s possible to specify multiple values.
Example: de,en |
Request example
https://api.maptiler.com/geocoding/Zurich.json?key=YOUR_MAPTILER_API_KEY
Responses
| Code | Content | Description |
|---|---|---|
| 200 | application/json | https://tools.ietf.org/html/rfc7946 |
| 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
Reverse geocoding (search by coordinates).
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”.
Example: 5.9559,45.818,10.4921,47.8084 |
| proximity | string | Prefer results close to a specific location. Specified as “longitude,latitude”.
Example: 8.528509,47.3774434 |
| language | string | Prefer results in specific language. It’s possible to specify multiple values.
Example: de,en |
Request example
https://api.maptiler.com/geocoding/8.528509,47.3774434.json?key=YOUR_MAPTILER_API_KEY
Responses
| Code | Content | Description |
|---|---|---|
| 200 | application/json | https://tools.ietf.org/html/rfc7946 |
| 400 | Query too long / Invalid parameters | |
| 403 | Key is missing, invalid or restricted |