Map Tiles

specdraftimplproposal

Publish raster image tiles.

Scope

The supported tile formats are:

• PNG
• WebP
• JPEG

Only the WebMercatorQuad tiling scheme is available.

Conformance Classes

The module is based on the drafts of OGC API - Maps. The implementation will change as the draft will evolve during the standardization process.

Operations

Resource	Path	Methods	Media Types	Description
Dataset Map Tiles	map/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}	GET		Access dataset map tiles
Collection Map Tiles	collections/{collectionId}/map/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}	GET		Access dataset map tiles
Dataset Tilesets	map/tiles	GET	HTML, JSON	Access dataset map tilesets
Collection Map Tilesets	collections/{collectionId}/map/tiles	GET	HTML, JSON	Access collection map tilesets
Dataset Tileset	map/tiles/{tileMatrixSetId}	GET	JSON, TileJSON	Access dataset map tileset
Collection Tileset	collections/{collectionId}/map/tiles/{tileMatrixSetId}	GET	JSON, TileJSON	Access collection map tileset

Path Parameters

Name	Resources	Description
Map Tiles	{@endpoints}
Map Tiles	{@endpoints}
Map Tiles	{@endpoints}
Map Tiles	{@endpoints}
Map Tiles	{@endpoints}

Query Parameters

Name	Resources	Description
f	Dataset Map Tile, Collection Map Tile	Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the "Accept" header will be used to determine the format.
f	Dataset Tileset, Collection Tileset	Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the "Accept" header will be used to determine the format.
f	Dataset Tilesets, Collection Tilesets	Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the "Accept" header will be used to determine the format.

Configuration

Options

Name	Default	Description	Type	Since
buildingBlock		Always MAP_TILES.	string	v2.0
extensionType		Deprecated See buildingBlock.	string	v2.0
enabled	false	Enable the building block?	boolean	v2.0
mapProvider	null	Specifies the data source for the tiles, currently only TileServer-Tile-Provider is supported.	object	v2.0

Examples

Example configuration:

- buildingBlock: MAP_TILES
  enabled: true
  mapProvider:
    type: TILESERVER
    urlTemplate: 'https://www.example.com/tileserver/styles/topographic/{tileMatrix}/{tileCol}/{tileRow}@2x.{fileExtension}'
    tileEncodings:
      - WebP
      - PNG

An example of a TileServer-GL configuration with the style "topographic", which can use, e.g., the vector tiles provided by the API as the data source:

{
  "options": {},
  "styles": {
    "topographic": {
      "style": "topographic.json",
      "tilejson": {
        "type": "overlay",
        "bounds": [35.7550727, 32.3573507, 37.2052764, 33.2671397]
      }
    }
  },
  "data": {}
}