GetTile is used to request a map image with well-defined geospatial and dimensional parameters in the image format specified in the request.
For the Simple Profile, GetTile requests are supported for Popular Visualization CRS (Spherical or Popular Mercator) with coordsys bounds.
Request Format
There are two possible request types:
Standard Request
The possible request depends on the type of encoding used - Key Value Pair (KVP) or REST.
Using KVP Encoding:
The tile can be requested by using this URL:
https://api.cloud.precisely.com/v1/spatial/wmts?VERSION=1.0.0&SERVICE=WMTS&REQUEST=GetTile
&LAYER={layer}&STYLE=default&FORMAT={image/png}&TILEMATRIXSET={tilematrixset}
&TILEMATRIX={tilematrix}&TILEROW={tilerow}&TILECOL={tilecol}Using RESTful Encoding:
The tile can be requested by using this URL:
hhttps://api.cloud.precisely.com/v1/spatial/wmts/1.0.0/default/tiles/{LAYER}/{STYLE}/
{TILEMATRIXSET}/{TILEMATRIX}/{TILECOL}/{TILEROW}.{IMAGE_FORMAT_EXTENSION}Simple Profile Request
Popular Visualization CRS (Spherical or Popular Mercator) using RESTful encoding:
The tile can be requested by using this URL:
https://api.cloud.precisely.com/v1/spatial/wmts/1.0.0/simpleProfileTile/tiles/{LAYER}/
{TILEMATRIX}/{TILECOL}/{TILEROW}.{IMAGE_FORMAT_EXTENSION}Request parameters
The following table lists the possible request inputs. The request parameters are always sent as an HTTP query string.
| Input | Type | Required | Description |
|---|---|---|---|
| VERSION=version | String | Yes | Request version. WMTS supports version 1.0.0 of the OGC specification. |
| SERVICE=WMTS | String | Yes | Service type. This is always WMTS. |
| REQUEST=GetTile | String | Yes | Request name. For a GetTile request, this is always GetTile. |
| LAYER=layer | String | Yes | The layer to be included in the map image. For example:
|
| STYLE=default | String | Yes | Comma-separated list of one rendering style per requested layer. A style is required for each layer requested. For a GetTile request, the style parameter is not supported and it is always default.
|
| FORMAT=output_format | String | Yes | The format in which the map image is to be returned. |
| TILEMATRIXSET=identifier | String | Yes | TileMatrixSet identifier. This will be the identifier of the requested tileMatrixSet. |
| TILEMATRIX=identifier | Integer | Yes | TileMatrix identifier. This will be the identifier of the tileMatrix of the desired scale denominator for the tileMatrixSet requested. |
| TILECOL=column_index | Integer | Yes | Specifies the column index of tile matrix. |
| TILEROW=row_index | Integer | Yes | Specifies the row index of tile matrix. |
| .{IMAGE_FORMAT_EXTENSION} | Image Mime | Yes | Specifies the response image format (jpeg, jpg or png). |
Response
After a successful GetTile request, the service returns a GetTile response, that is an image of the map specified by the parameters in the request.
Examples
Request
https://api.cloud.precisely.com/v1/spatial/wmts?layer=fireriskpro&style=default&tilematrixset=WorldWebMercatorQuad_0_to_19&Service=WMTS&Request=GetTile&Version=1.0.0&Format=image%2Fpng&TileMatrix=12&TileCol=1190&TileRow=1550https://api.cloud.precisely.com/v1/spatial/wmts/1.0.0/default/tiles/fireriskpro/default/WorldWebMercatorQuad_0_to_19/12/1190/1550.pnghttps://api.cloud.precisely.com/v1/spatial/wmts/1.0.0/simpleProfileTile/tiles/fireriskpro/12/1190/1550.pngResponse