GetResourceRepresentation request Tile resource mandatory in resource oriented architectural style
Copyright © 2010 Open Geospatial Consortium Inc.
63 valid value. The template processor SHALL support the following variable names:
Style, TileMatrixSet, TileMatrix, TileRow, TileCol and any dimension identifier that has been defined for this layer in the element .Dimensionows:Identifier.
The template processor SHALL substitute the variable names by the values of the elements as shown in Table 32.
Possible values and ranges of the variables in the URL template can be extracted from the SeviceMetadata document parameters. The following table lists all the possible variable
names, their description, possible values and multiplicity. Assuming a ServiceMetadata in XML format the possible values are also given using XPath expressions that point to
the ServiceMetadata document. When a relative XPath is used, it is relative to its layer element of the ServiceMetadata document.
When a variable has only one possible value for this layer, the use of the direct value instead of the variable is recommended on the URL template.
Table 32 — URL template variables and possible values for tile
URL template variable
Meaning Possible values
Multiplicity
style
Style identifier
identifier in Table 7
.styleows:Identifier
One mandatory
a
.Dimension ows:Identifie
r
Dimension value
identifier in Table 9
.Dimension[ows:Identifier={.Dimension ows:Identifier}]Value
One for each dimension
available mandatory if
there are dimensions
defined
TileMatrix Set
tile matrix set
identifier identifier in Table 6
. TileMatrixSetLinkTileMatrixSet
One mandatory
a
TileMatrix
tile matrix identifier
identifier in Table 14
CapabilitiesContentsTileMatrixSet[ ows:Identifier={TileMatrixSet}]TileMatrix
ows:Identifier
One mandatory
a
TileRow
row index of tile
matrix If TileMatrixSetLimits is present, see Table 10,
.TileMatrixSetLimits
, SHALL be any integer value between MinTileRow and MaxTileRow in
Table 12 both included
.tileMatrixSetLimitstileMatrixLimits[. TileMatrix={TileMatrix}]MinTileRow
and
.tileMatrixSetLimitstileMatrixLimits[.T ileMatrix={TileMatrix}]MaxTileRow
. else SHALL be any integer value between 0 and
MatrixHeight – 1, see Table 14, both included 0
and
CapabilitiesContentsTileMatrixSet[ows:I dentifier={TileMatrixSet}]TileMatrix[ows:
Identifier={TileMatrix}]MatrixHeight – 1
One mandatory
a
64
Copyright © 2010 Open Geospatial Consortium Inc.
URL template variable
Meaning Possible values
Multiplicity
TileCol
col index of tile matrix
If TileMatrixSetLimits is present, see Table 10,
.TileMatrixSetLimits
, SHALL be any integer value between MinTileCol and MaxTileCol in
Table 12 both included
.tileMatrixSetLimitstileMatrixLimits[. TileMatrix={TileMatrix}]MinTileCol
and
.tileMatrixSetLimitstileMatrixLimits[.T ileMatrix={TileMatrix}]MaxTileCol
else SHALL be any integer value between 0 and MatrixWidth
– 1, see Table 14, both included 0 and
CapabilitiesContentsTileMatrixSet[ows:I dentifier={TileMatrixSet}]TileMatrix[ows:
Identifier={TileMatrix}] MatrixWidth – 1
One mandatory
a
a When a variable has only one possible value for this layer the use of the direct value instead of the variable is
recommended.
Any possible order of the variables and values in the URL template is valid. Neverdeless we recommend the following order:
style, firstDimension, ..., lastDimension, TileMatrixSet, TileMatrix, TileRow and TileCol
NOTE 1 It is not necessary for a file system with this particular structure to actually exist on the server.
A WMTS server implementation is free to parse the request URL itself and either remap the request to a different internal directory structure or generate the response on the fly at the expense of speed.
NOTE 2 This syntax and processing is in-line with the pre-existing templating schemas present in
OpenSearch, WSDL and WADL and is a simplification of the description made by the IETF Network Working Group in the Internet-Draft called URI Template draft-gregorio-uritemplate-03.