Tiles API

Embeddable HTML viewer

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

Request

You must include an API Key with every API request

Path Parameters

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

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

Get your FREE API key in the MapTiler Cloud.

Responses

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

You must include an API Key with every API request

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
Request example

  https://api.maptiler.com/tiles/satellite/10/536/358.jpg?key=YOUR_MAPTILER_API_KEY

Get your FREE API key in the MapTiler Cloud.

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

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

You must include an API Key with every API request

Path Parameters

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

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

Get your FREE API key in the MapTiler Cloud.

Responses

Code Content Description
200 application/json https://raw.githubusercontent.com/mapbox/tilejson-spec/master/2.2.0/schema.json TileJSON Object

OGC API - Tiles

GET https://api.maptiler.com/tiles/{tilesId}/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 Cloud Tiles.
Example: satellite
Request example

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

Get your FREE API key in the MapTiler Cloud.

Responses

Code Content Description
200 application/json

OGC API TileMatrixSets

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

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 Cloud Tiles.
Example: satellite
Request example

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

Get your FREE API key in the MapTiler Cloud.

Responses

Code Content Description
200 application/json

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

You must include an API Key with every API request

Path Parameters

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

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

Get your FREE API key in the MapTiler Cloud.

Responses

Code Content Description
200 text/xml