Tiles API

Embeddable HTML viewer

GET https://api.maptiler.com/tiles/{tilesId}/

Request

Security: API Key

Path Parameters

Parameters Type Description
tilesId string
Identifier of the tiles. See MapTiler Cloud Tiles
Example: satellite
Example requests

https://api.maptiler.com/tiles/satellite/?key=YOUR_MAPTILER_API_KEY

Response

Code Content Description
200 text/html

XYZ tiles

GET https://api.maptiler.com/tiles/{tilesId}/{z}/{x}/{y}.{format}

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

Security: API Key

Path Parameters

Parameters Type Description
tilesId string
Identifier of the tiles. See MapTiler Cloud Tiles
Example: satellite
z integer
x integer
y integer
format string
The value depends on the Map settings.
Example requests

https://api.maptiler.com/tiles/satellite/10/518/352.jpg?key=YOUR_MAPTILER_API_KEY

Response

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

GET https://api.maptiler.com/tiles/{tilesId}/tiles.json

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

Security: API Key

Path Parameters

Parameters Type Description
tilesId string
Identifier of the tiles. See MapTiler Cloud Tiles
Example: satellite
Example requests

https://api.maptiler.com/tiles/satellite/tiles.json?key=YOUR_MAPTILER_API_KEY

Response

Code Content Description
200 application/json TileJSON object https://documentation.maptiler.com/hc/en-us/articles/4405591904913-TileJSON-for-map-tiles

WMTS Capabilities

GET https://api.maptiler.com/tiles/{tilesId}/WMTSCapabilities.xml

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

Security: API Key

Path Parameters

Parameters Type Description
mapId string
Identifier of the map. See MapTiler Cloud Maps
Example: streets
Example requests

https://api.maptiler.com/tiles/satellite/WMTSCapabilities.xml?key=YOUR_MAPTILER_API_KEY

Response

Code Content Description
200 text/xml