--- title: "Tiles API" description: "API for accessing vector and raster map tiles." --- > For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL. # Tiles API ## Tiles API reference Scalar API Reference - [ Introduction ](#description/introduction) - [ Tiles ](#tag/tiles) Close Group - Tiles - [ Embeddable HTML viewer HTTP Method:  GET](#tag/tiles/GET/tiles/{tilesId}/) - [ XYZ tiles HTTP Method:  GET](#tag/tiles/GET/tiles/{tilesId}/{z}/{x}/{y}) - [ TileJSON HTTP Method:  GET](#tag/tiles/GET/tiles/{tilesId}/tiles.json) - [ OGC API \- Tiles HTTP Method:  GET](#tag/tiles/GET/tiles/{tilesId}/tiles) - [ OGC API TileMatrixSets HTTP Method:  GET](#tag/tiles/GET/tiles/{tilesId}/tileMatrixSet) - [ WMTS Capabilities HTTP Method:  GET](#tag/tiles/GET/tiles/{tilesId}/WMTSCapabilities.xml) [Powered by Scalar](https://www.scalar.com) v1.0 OpenAPI 3.1.0 # MapTiler API [Support](mailto:support@maptiler.com) [](https://docs.maptiler.com/support/requests/) [Terms of Service](https://www.maptiler.com/terms/) Server Server:https://api.maptiler.com MapTiler API ## AuthenticationRequired Selected Auth Type: key Client Libraries Shell Ruby Node.js PHP Python MoreSelect from all clients Shell Curl ## Tiles ​Copy link Tiles Operations - get/tiles/{tilesId}/ - get/tiles/{tilesId}/{z}/{x}/{y} - get/tiles/{tilesId}/tiles.json - get/tiles/{tilesId}/tiles - get/tiles/{tilesId}/tileMatrixSet - get/tiles/{tilesId}/WMTSCapabilities.xml ### Embeddable HTML viewer ​Copy link Auth Required Path Parameters - tilesIdCopy link to tilesId Type: string required Example satellite-v4 Identifier of the tiles. See [MapTiler Tiles](https://cloud.maptiler.com/tiles/). Responses - 200 text/html Request Example for get/tiles/_{tilesId}_/ Shell Curl ```curl curl 'https://api.maptiler.com/tiles/satellite-v4/?key=YOUR_MAPTILER_API_KEY' ``` Copy Copy Test Request(get /tiles/{tilesId}/) Status: 200 No Body ### XYZ tiles ​Copy link Auth Required 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 - tilesIdCopy link to tilesId Type: string required Example satellite-v4 Identifier of the tiles. See [MapTiler Tiles](https://cloud.maptiler.com/tiles/). - zCopy link to z Type: integer required Zoom level. Specifies the tile's zoom level. See [Tiles à la Google Maps](https://docs.maptiler.com/google-maps-coordinates-tile-bounds-projection/) - xCopy link to x Type: integer required Column. Specifies the tile's column. See [Tiles à la Google Maps](https://docs.maptiler.com/google-maps-coordinates-tile-bounds-projection/) - yCopy link to y Type: integer required Row. Specifies the tile's row. See [Tiles à la Google Maps](https://docs.maptiler.com/google-maps-coordinates-tile-bounds-projection/) Responses - 200 \* - 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}_ Shell Curl ```curl curl 'https://api.maptiler.com/tiles/satellite-v4/1/1/1?key=YOUR_MAPTILER_API_KEY' ``` Copy Copy Test Request(get /tiles/{tilesId}/{z}/{x}/{y}) Status: 200Status: 204Status: 400Status: 403Status: 404 No Body ### TileJSON ​Copy link Auth Required 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 - tilesIdCopy link to tilesId Type: string required Example satellite-v4 Identifier of the tiles. See [MapTiler Tiles](https://cloud.maptiler.com/tiles/). Responses - 200 application/json Request Example for get/tiles/_{tilesId}_/tiles.json Shell Curl ```curl curl 'https://api.maptiler.com/tiles/satellite-v4/tiles.json?key=YOUR_MAPTILER_API_KEY' ``` Copy Copy Test Request(get /tiles/{tilesId}/tiles.json) Status: 200 Show Schema ```json {} ``` Copy Copy ### OGC API - Tiles ​Copy link Auth Required Tileset landing page of the tiles. Can be used in software supporting the OGC API - Tiles v1.0 specification. Path Parameters - tilesIdCopy link to tilesId Type: string required Example satellite-v4 Identifier of the tiles. See [MapTiler Tiles](https://cloud.maptiler.com/tiles/). Responses - 200 application/json Request Example for get/tiles/_{tilesId}_/tiles Shell Curl ```curl curl 'https://api.maptiler.com/tiles/satellite-v4/tiles?key=YOUR_MAPTILER_API_KEY' ``` Copy Copy Test Request(get /tiles/{tilesId}/tiles) Status: 200 Show Schema ```json string ``` Copy Copy ### OGC API TileMatrixSets ​Copy link Auth Required 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 - tilesIdCopy link to tilesId Type: string required Example satellite-v4 Identifier of the tiles. See [MapTiler Tiles](https://cloud.maptiler.com/tiles/). Responses - 200 application/json Request Example for get/tiles/_{tilesId}_/tileMatrixSet Shell Curl ```curl curl 'https://api.maptiler.com/tiles/satellite-v4/tileMatrixSet?key=YOUR_MAPTILER_API_KEY' ``` Copy Copy Test Request(get /tiles/{tilesId}/tileMatrixSet) Status: 200 Show Schema ```json string ``` Copy Copy ### WMTS Capabilities ​Copy link Auth Required 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 - tilesIdCopy link to tilesId Type: string required Example satellite-v4 Identifier of the tiles. See [MapTiler Tiles](https://cloud.maptiler.com/tiles/). Responses - 200 text/xml Request Example for get/tiles/_{tilesId}_/WMTSCapabilities.xml Shell Curl ```curl curl 'https://api.maptiler.com/tiles/satellite-v4/WMTSCapabilities.xml?key=YOUR_MAPTILER_API_KEY' ``` Copy Copy Test Request(get /tiles/{tilesId}/WMTSCapabilities.xml) Status: 200 Show Schema ```json string ``` Copy Copy ![](https://docs.maptiler.com/assets/img/open-api.png) Using the OpenAPI Specification? Get the [openapi.yaml](https://docs.maptiler.com/_data/cloud/api/openapi.yml)