Tiles API

Tiles API reference

Scalar API Reference
v1.0
OpenAPI 3.1.0

MapTiler API

Support
Terms of Service

MapTiler API

Client Libraries
Shell Curl

Tiles

​
Tiles Operations

Embeddable HTML viewer

​
Path Parameters
  • tilesId
    Type: string
    required

    Identifier of the tiles. See MapTiler Tiles.

Responses
  • text/html
Request Example for get/tiles/{tilesId}/
curl 'https://api.maptiler.com/tiles/satellite-v4/?key=YOUR_SECRET_TOKEN'
No Body

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.

Path Parameters
  • tilesId
    Type: string
    required

    Identifier of the tiles. See MapTiler Tiles.

  • z
    Type: integer
    required

    Zoom level. Specifies the tile's zoom level. See Tiles à la Google Maps

  • x
    Type: integer
    required

    Column. Specifies the tile's column. See Tiles à la Google Maps

  • y
    Type: integer
    required

    Row. Specifies the tile's row. See Tiles à la Google Maps

Responses
  • *
  • 204

    Tile not present -- presumed empty (empty response)

  • 400

    Out of bounds

  • 403

    Key is missing, invalid or restricted

  • 404

    The item does not exist

Request Example for get/tiles/{tilesId}/{z}/{x}/{y}
curl 'https://api.maptiler.com/tiles/satellite-v4/1/1/1?key=YOUR_SECRET_TOKEN'
No Body

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

Path Parameters
  • tilesId
    Type: string
    required

    Identifier of the tiles. See MapTiler Tiles.

Responses
  • application/json
Request Example for get/tiles/{tilesId}/tiles.json
curl 'https://api.maptiler.com/tiles/satellite-v4/tiles.json?key=YOUR_SECRET_TOKEN'

{}

OGC API - Tiles

​

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

Path Parameters
  • tilesId
    Type: string
    required

    Identifier of the tiles. See MapTiler Tiles.

Responses
  • application/json
Request Example for get/tiles/{tilesId}/tiles
curl 'https://api.maptiler.com/tiles/satellite-v4/tiles?key=YOUR_SECRET_TOKEN'

string

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.

Path Parameters
  • tilesId
    Type: string
    required

    Identifier of the tiles. See MapTiler Tiles.

Responses
  • application/json
Request Example for get/tiles/{tilesId}/tileMatrixSet
curl 'https://api.maptiler.com/tiles/satellite-v4/tileMatrixSet?key=YOUR_SECRET_TOKEN'

string

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.

Path Parameters
  • tilesId
    Type: string
    required

    Identifier of the tiles. See MapTiler Tiles.

Responses
  • text/xml
Request Example for get/tiles/{tilesId}/WMTSCapabilities.xml
curl 'https://api.maptiler.com/tiles/satellite-v4/WMTSCapabilities.xml?key=YOUR_SECRET_TOKEN'

string
Using the OpenAPI Specification?
Get the openapi.yaml
Was this helpful?
MapTiler API
Tiles API
Tiles API