Copyright © 2010 Open Geospatial Consortium Inc.
59
TextPayload Format
texthtml Format
TextContent [CDATA[
DOCTYPE HTML PUBLIC -W3CDTD HTML 3.2 FinalEN HTML
titleGetFeatureInfoResponsetitle bElevationb503.0br
bTileRowb1br bTileColb2br
bJb86br bIb132br
HTML ]]
TextContent TextPayload
FeatureInfoResponse soap:Body
soap:Envelope NOTE
The use of [CDATA[ ]] is needed for embedded HTML data but will not be needed for XHTML.
A GetFeatureInfo operation SOAP response with the same information in arbitrary xml encoding may look like this:
?xml version=1.0 encoding=UTF-8? soap:Envelope
xmlns:soap =
http:www.w3.org200305soap-envelope xmlns:xsi
= http:www.w3.org2001XMLSchema-instance
xmlns:xsd =
http:www.w3.org2001XMLSchema xsi:schemaLocation
= http:www.w3.org200305soap-envelope
http:www.w3.org200305soap-envelope.xsd soap:Body
FeatureInfoResponse xmlns
= http:www.opengis.netwmts1.0
xmlns:gml =
http:www.opengis.netgml xsi:schemaLocation
= http:www.opengis.netwmts1.0
wmtsGetFeatureInfo_response.xsd AnyContent
GridPoint_etopo2 elevation
503.0 elevation
TileRow 1
TileRow TileCol
2 TileCol
J 86
J I
132 I
GridPoint_etopo2 AnyContent
FeatureInfoResponse soap:Body
soap:Envelope
9.4 Exceptions in SOAP encoding
If an error is detected while processing an operation request encoded in a SOAP envelope, the WMTS server SHALL generate a SOAP 1.2 response message where the
content of the Body element is a Fault element containing an ExceptionReport element as defined in clause 8.5 of OWS Common [OGC 06-121r3]. This SHALL be done
using the following XML fragment:
60
Copyright © 2010 Open Geospatial Consortium Inc. ?xml version=1.0 encoding=UTF-8?
soap:Envelope xmlns:soap
= http:www.w3.org200305soap-envelope
soap:Body soap:Fault
soap:Code soap:Value
soap:Receiver soap:Value
soap:Code soap:Reason
soap:Text A server exception was encountered.
soap:Text soap:Reason
soap:Detail ows:ExceptionReport
xmlns:ows =
http:www.opengis.netows1.1 …
ows:ExceptionReport soap:Detail
soap:Fault soap:Body
soap:Envelope
The Code element SHALL have the Value soap:server indicating that this is a server exception. The Reason element SHALL have the Text A Server exception was
encountered. This fixed string is used since the details of the exception SHALL be specified in the Detail element using an ows:ExceptionReport element.
10 WMTS using RESTful
A WMTS server that supports HTTP RESTful SHALL declare support for each resource by means of the ServiceMetadataURL see Table 3 and the ResourceURL see Table 6
elements of its ServiceMetadata document as explained in this clause. An example of this practice can be seen in the Annex D.
The first step in the resource oriented architectural style is to identify the resources and the relations between the resources. This version of WMTS standard identifies 3
resources: the service ServiceMetadata, the map tiles Tile and the feature information related to a pixel of a tile FeatureInfo. The RESTful approach provides a way to
manipulate these resources via standard HTTP requests. This standard only defined the use of HTTP GET to download resource representations that are equivalent to the ones
that can be retrieved by the GetCapabilities, GetTile and GetFeatureInfo operations in the procedure oriented architectural style.
NOTE 1 Some RESTful literature calls this action of retrieval downloading of a resource using HTTP GET GetResource or GetResourceRepresentation, the action to delete a resource using HTTP DELETE
DeleteResource, etc. This is useful to clarify the action of the HTTP operation but note that there is no operation called explicitly GetResourceRepresentation operation in RESTful. The WMTS standard also
adopts this notation allowing easy extension to other future RESTful actions.
The RESTful encoding for WMTS consists of a set of canonical URLs to the service metadata document, to tiles, and to FeatureInfo documents one for each pixel. The
service metadata document is the single entry point and all other URL endpoints can be obtained by analyzing the templates contained in the ResourceURL elements of each
layer element in the ServiceMetadata document.
