APIs
Authentication
Admin API
On This Page
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 |