Tiles API

Embeddable HTML viewer

Added in v1.0.0
GET http://localhost:3650/api/tiles/{tilesId}/

Request

Path Parameters

Parameters Type Description
tilesId
 string
Identifier of the tiles. See MapTiler Server 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

Added in v1.0.0
GET http://localhost:3650/api/tiles/{tilesId}/{z}/{x}/{y}

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.
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

Added in v1.0.0
GET http://localhost:3650/api/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

Path Parameters

Parameters Type Description
tilesId
 string
Identifier of the tiles. See MapTiler Server 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/mapbox/tilejson-spec/master/2.2.0/schema.json TileJSON
404

The item does not exist

OGC API - Tiles

Added in v4.6.0
GET http://localhost:3650/api/tiles/{tilesId}/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.
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

Added in v4.6.0
GET http://localhost:3650/api/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

Path Parameters

Parameters Type Description
tilesId
 string
Identifier of the tiles. See MapTiler Server 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

Added in v1.0.0
GET http://localhost:3650/api/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

Path Parameters

Parameters Type Description
tilesId
 string
Identifier of the tiles. See MapTiler Server 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
Using the OpenAPI Specification?
Get the openapi.yaml