Tiles API
Embeddable HTML viewer
Request
You must include an API Key with every API request
Path Parameters
Parameters | Type | Description |
---|---|---|
tilesId | string |
Identifier of the tiles. See MapTiler Tiles.
Example: satellite-v2 |
Request example
https://api.maptiler.com/tiles/satellite-v2/?key=YOUR_MAPTILER_API_KEY
Get your FREE API key in your MapTiler account.
Responses
Code | Content | Description |
---|---|---|
200 | text/html |
XYZ tiles
The individual tiles. Can be used with various libraries to display the tiles (e.g. Leaflet, OpenLayers, ...). It's usually better (if possible) to use the TileJSON rather than using the tile URL directly.
Request
You must include an API Key with every API request
Path Parameters
Parameters | Type | Description |
---|---|---|
tilesId | string |
Identifier of the tiles. See MapTiler Tiles.
Example: satellite-v2 |
z | integer |
Zoom level. Specifies the tile’s zoom level. See Tiles à la Google Maps
|
x | integer |
Column. Specifies the tile’s column. See Tiles à la Google Maps
|
y | integer |
Row. Specifies the tile’s row. See Tiles à la Google Maps
|
format | string |
Format of the returned tiles. The value depends on the data type. You can find the value by selecting the tileset in MapTiler Tiles and looking the format at the tileset details.
Allowed values:
png
jpg
webp
pbf
terrain
quantized-mesh-1.0 |
Request example
https://api.maptiler.com/tiles/satellite-v2/10/536/358.png?key=YOUR_MAPTILER_API_KEY
Get your FREE API key in your MapTiler account.
Responses
Code | Content | Description |
---|---|---|
200 | * | |
204 |
Tile not present – presumed empty (empty response) |
|
400 |
Out of bounds / Invalid format |
|
403 |
Key is missing, invalid or restricted |
|
404 |
The item does not exist |
TileJSON
TileJSON describing the metadata of the tiles as well as link to the XYZ tiles. Can be used with various libraries to display the tiles (e.g. Leaflet, OpenLayers, ...).
Request
You must include an API Key with every API request
Path Parameters
Parameters | Type | Description |
---|---|---|
tilesId | string |
Identifier of the tiles. See MapTiler Tiles.
Example: satellite-v2 |
Request example
https://api.maptiler.com/tiles/satellite-v2/tiles.json?key=YOUR_MAPTILER_API_KEY
Get your FREE API key in your MapTiler account.
Responses
Code | Content | Description |
---|---|---|
200 | application/json | https://raw.githubusercontent.com/mapbox/tilejson-spec/master/2.2.0/schema.json TileJSON |
OGC API - Tiles
Tileset landing page of the tiles. Can be used in software supporting the OGC API - Tiles v1.0 specification.
Request
You must include an API Key with every API request
Path Parameters
Parameters | Type | Description |
---|---|---|
tilesId | string |
Identifier of the tiles. See MapTiler Tiles.
Example: satellite-v2 |
Request example
https://api.maptiler.com/tiles/satellite-v2/tiles?key=YOUR_MAPTILER_API_KEY
Get your FREE API key in your MapTiler account.
Responses
Code | Content | Description |
---|---|---|
200 | application/json |
OGC API TileMatrixSets
Description of the tileset tile matrix sets according to the OGC Web API. This resource is linked from the OGC API - Tiles endpoint.
Request
You must include an API Key with every API request
Path Parameters
Parameters | Type | Description |
---|---|---|
tilesId | string |
Identifier of the tiles. See MapTiler Tiles.
Example: satellite-v2 |
Request example
https://api.maptiler.com/tiles/satellite-v2/tileMatrixSet?key=YOUR_MAPTILER_API_KEY
Get your FREE API key in your MapTiler account.
Responses
Code | Content | Description |
---|---|---|
200 | application/json |
WMTS Capabilities
WMTS Capabilities XML document describing the metadata of the tiles as well as link to the XYZ tiles. Can be used with various GIS software (e.g. QGIS) to display the tiles.
Request
You must include an API Key with every API request
Path Parameters
Parameters | Type | Description |
---|---|---|
tilesId | string |
Identifier of the tiles. See MapTiler Tiles.
Example: satellite-v2 |
Request example
https://api.maptiler.com/tiles/satellite-v2/WMTSCapabilities.xml?key=YOUR_MAPTILER_API_KEY
Get your FREE API key in your MapTiler account.
Responses
Code | Content | Description |
---|---|---|
200 | text/xml |
