Tiles API

Embeddable HTML viewer

Request

Path Parameters

Parameters	Type	Description
tilesId	string	Identifier of the tiles. See MapTiler Server Tiles http://localhost:3650/admin/tiles/. Example: maptiler-satellite Added in v1.0.0

Request example

  http://localhost:3650/api/tiles/maptiler-satellite/

Responses

Code	Content	Description
200	text/html
404		The item does not exist

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

Path Parameters

Parameters	Type	Description
tilesId	string	Identifier of the tiles. See MapTiler Server Tiles http://localhost:3650/admin/tiles/. Example: maptiler-satellite Added in v1.0.0
z	integer	Zoom level. Specifies the tile’s zoom level. See Tiles à la Google Maps Added in v1.0.0
x	integer	Column. Specifies the tile’s column. See Tiles à la Google Maps Added in v1.0.0
y	integer	Row. Specifies the tile’s row. See Tiles à la Google Maps Added in v1.0.0

Request example

  http://localhost:3650/api/tiles/maptiler-satellite/10/536/358

Responses

Code	Content	Description
200	*
204		Tile not present – presumed empty (empty response)
400		Out of bounds
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

Path Parameters

Parameters	Type	Description
tilesId	string	Identifier of the tiles. See MapTiler Server Tiles http://localhost:3650/admin/tiles/. Example: maptiler-satellite Added in v1.0.0

Request example

  http://localhost:3650/api/tiles/maptiler-satellite/tiles.json

Responses

Code	Content	Description
200	application/json	https://raw.githubusercontent.com/maptiler/tilejson-spec/master/2.2.0/schema.json TileJSON
404		The item does not exist

OGC API - Tiles

Tileset landing page of the tiles. Can be used in software supporting the OGC API - Tiles v1.0 specification.

Request

Path Parameters

Parameters	Type	Description
tilesId	string	Identifier of the tiles. See MapTiler Server Tiles http://localhost:3650/admin/tiles/. Example: maptiler-satellite Added in v4.6.0

Request example

  http://localhost:3650/api/tiles/maptiler-satellite/tiles

Responses

Code	Content	Description
200	application/json	OK
404		The item does not exist

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

Path Parameters

Parameters	Type	Description
tilesId	string	Identifier of the tiles. See MapTiler Server Tiles http://localhost:3650/admin/tiles/. Example: maptiler-satellite Added in v4.6.0

Request example

  http://localhost:3650/api/tiles/maptiler-satellite/tileMatrixSet

Responses

Code	Content	Description
200	application/json	OK
404		The item does not exist

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

Path Parameters

Parameters	Type	Description
tilesId	string	Identifier of the tiles. See MapTiler Server Tiles http://localhost:3650/admin/tiles/. Example: maptiler-satellite Added in v1.0.0

Request example

  http://localhost:3650/api/tiles/maptiler-satellite/WMTSCapabilities.xml

Responses

Code	Content	Description
200	text/xml
404		The item does not exist