Retrieve tiles and tile metadata

These are the endpoints in Tiling service dedicated to serving tiles and associated metadata.

GET/api/tiles/dataset/{id}/metadata. Returns tiling metadata for the given dataset. The structure contains list of all generated schemes, tile sizes, zoom levels and other parameters and extent of the dataset in JSON format.

Click to show example shell script

projectid="<replacewithprojectid>"
openapikey="<replacewithopenapikey>"
datasetid="<replacewithdatasetid>"

curl -L -X GET "https://api.mike-cloud-test.com/api/tiles/dataset/$datasetid/metadata" \
  -H 'Content-Type: application/json' \
  -H "dhi-open-api-key: $openapikey" \
  -H "dhi-project-id: $projectid" \
  -H "dhi-dataset-id: $datasetid" \
  -H "dhi-service-id: tiles" \
  -H "api-version: 1" \

GET/api/tiles/dataset/{id}/wmts. Implements GetCapabilities and GetTile requests according to subset of WMTS standard. In order to get the Capabilities response in xml format (which is what OpenLayers expects - see below), the request needs to have a header: "Accept: application/xml", otherwise the response is sent using JSON format. For tiles in XYZ format it is most likely more convenient to use the pure metadata endpoint.

Click to show example shell script

projectid="<replacewithprojectid>"
openapikey="<replacewithopenapikey>"
datasetid="<replacewithdatasetid>"

curl -L -X GET "https://api.mike-cloud-test.com/api/tiles/dataset/$datasetid/wmts" \
  -H 'Content-Type: application/json' \
  -H "dhi-open-api-key: $openapikey" \
  -H "dhi-project-id: $projectid" \
  -H "dhi-dataset-id: $datasetid" \
  -H "dhi-service-id: tiles" \
  -H "api-version: 1" \

GET/api/tiles/dataset/{id}/scheme/{schemeId}/{tileMatrix}/{tileRow}/{tileCol}. Endpoint for retrieving tiles in WMTS standard or XYZ standard, depending on the tiling scheme used. This endpoint is announced in the capabilities document as the one serving tiles, but both this one and the wmts100 endpoint can be used to get WMTS tiles. Endpoint will serve XYZ tiles in Web Mercator for schemes generated with schemeType = XYZ.

Click to show example shell script

projectid="<replacewithprojectid>"
openapikey="<replacewithopenapikey>"
datasetid="<replacewithdatasetid>"
schemeId="<replacewithschemeid>"
tileMatrix = "<replacewithtilematrix>"
tileRow = "<replacewithtilerow>"
tileCol = "<replacewithtilecol>"

curl -L -X GET "https://api.mike-cloud-test.com/api/tiles/dataset/$datasetid/scheme/$schemeId/$tileMatrix/$tileRow/$tileCol" \
  -H 'Content-Type: application/json' \
  -H "dhi-open-api-key: $openapikey" \
  -H "dhi-project-id: $projectid" \
  -H "dhi-dataset-id: $datasetid" \
  -H "dhi-service-id: tiles" \
  -H "api-version: 1" \

GET/api/tiles/dataset/{id}/scheme/{schemeId}/emptyTile. Endpoint returns an empty tile for the given dataset and tiling scheme. The idea is that when a tile is empty, it will look the same for all resolutions and positions. So one tile from one url can be used to represent all such tiles, and the consumer might be able to skip redundant calls to the API.

Click to show example shell script

projectid="<replacewithprojectid>"
openapikey="<replacewithopenapikey>"
datasetid="<replacewithdatasetid>"
schemeId="<replacewithschemeid>"

curl -L -X GET "https://api.mike-cloud-test.com/api/tiles/dataset/$datasetid/scheme/$schemeId/emptyTile" \
  -H 'Content-Type: application/json' \
  -H "dhi-open-api-key: $openapikey" \
  -H "dhi-project-id: $projectid" \
  -H "dhi-dataset-id: $datasetid" \
  -H "dhi-service-id: tiles" \
  -H "api-version: 1" \

GET/api/vectortiles/dataset/{id}/{zoom}/{tileCol}/{tileRow}.vector.pbf. Endpoint for retrieving map vector tiles inspired by MapBox specification.

Click to show example shell script

projectid="<replacewithprojectid>"
openapikey="<replacewithopenapikey>"
datasetid="<replacewithdatasetid>"
zoom="<replacewithzoom>"
tileRow = "<replacewithtilerow>"
tileCol = "<replacewithtilecol>"

curl -L -X GET "https://api.mike-cloud-test.com/api/vectortiles/dataset/$datasetid/$zoom/$tileCol/$tileRow.vector.pbf" \
  -H 'Content-Type: application/json' \
  -H "dhi-open-api-key: $openapikey" \
  -H "dhi-project-id: $projectid" \
  -H "dhi-dataset-id: $datasetid" \
  -H "dhi-service-id: tiles" \
  -H "api-version: 1" \