Static Maps API
Center-based image
Added in v4.2.0
GET http://localhost:3650/api/maps/{mapId}/static/{lon},{lat},{zoom}/{width}x{height}{scale}.{format}
Generates a raster image based on the specified center and zoom level.
Request
Path Parameters
| Parameters | Type | Description |
|---|---|---|
| mapId | string |
Identifier of the map. See MapTiler Server Maps.
Example: streetsAdded in v4.2.0 |
| lon | number |
Longitude of the center of the image.
Added in v4.2.0 |
| lat | number |
Latitude of the center of the image.
Added in v4.2.0 |
| zoom | number |
Zoom level of the resulting image (can be fractional). (In the tile pyramid based on 512x512 tiles.)
Added in v4.2.0 |
| width | integer |
Width of the image in pixels.
Added in v4.2.0 |
| height | integer |
Height of the image in pixels.
Added in v4.2.0 |
| scale | string |
Use “@2x” to get “retina”/HiDPI image.
Allowed values:
@2xAdded in v4.2.0 |
| format | string |
The value depends on the Map settings.
Allowed values:
png
jpg
webpAdded in v4.2.0 |
Request example
http://localhost:3650/api/maps/streets/static/6.0288,44.3408,3/400x300.pngResponses
| Code | Content | Description |
|---|---|---|
| 200 | image/* | |
| 400 | Out of bounds / Invalid format | |
| 404 | The item does not exist | |
| 414 | URI Too Long. Maximum allowed length is 8192 bytes. |
Bounds-based image
Added in v4.2.0
GET http://localhost:3650/api/maps/{mapId}/static/{minx},{miny},{maxx},{maxy}/{width}x{height}{scale}.{format}
Generates a raster image based on the given bounds.
Request
Path Parameters
| Parameters | Type | Description |
|---|---|---|
| mapId | string |
Identifier of the map. See MapTiler Server Maps.
Example: streetsAdded in v4.2.0 |
| minx | number |
Longitude of the left (west) edge.
Added in v4.2.0 |
| miny | number |
Latitude of the bottom (south) edge.
Added in v4.2.0 |
| maxx | number |
Longitude of the right (east) edge.
Added in v4.2.0 |
| maxy | number |
Latitude of the top (north) edge.
Added in v4.2.0 |
| width | integer |
Width of the image in pixels.
Added in v4.2.0 |
| height | integer |
Height of the image in pixels.
Added in v4.2.0 |
| scale | string |
Use “@2x” to get “retina”/HiDPI image.
Allowed values:
@2xAdded in v4.2.0 |
| format | string |
The value depends on the Map settings.
Allowed values:
png
jpg
webpAdded in v4.2.0 |
Request example
http://localhost:3650/api/maps/streets/static/-11.54,34.1,23.6,52.96/400x300.pngResponses
| Code | Content | Description |
|---|---|---|
| 200 | image/* | |
| 400 | Out of bounds / Invalid format | |
| 404 | The item does not exist | |
| 414 | URI Too Long. Maximum allowed length is 8192 bytes. |