GetFeatureInfo operation request GetFeatureInfo operation optional in procedure oriented architectural style

46 Copyright © 2010 Open Geospatial Consortium Inc. Figure 11 — GetFeatureInfo operation request UML class diagram OWService {Abstract} + getFeatureIntorequest : GetFeaturelnfo : FeatureInfoResponse Interface RequestBase Abstract from OWS Get Capabilities + service : CharacterString + request : CharacterString + version : CharacterString WMTSGetCapabilities from WMTS Service + service : CharacterString = WMTS {frozen} FeatureInfoResponse + featureInfo : byte[] + type : MimeType FeatureInfoRequest + request : CharacterString = GetFeatureInfo {frozen} DataType PixelPoint + i : integer + j : integer FeatureInfoRequestParameters + infoFormat : FormatType + point : PixelPoint 1 1 The use of GML Simple Features Profile [OGC 06- 049r1] is strongly recommended, as is texthtml 1 TileRequestParameters from WMTS Get Tile + layer : CharacterString + style : CharacterString 1 TileAttributes from WMTS Get Tile + format : ows:MimeType + tilePosition : TilePosition TilePosition from WMTS Get Tile + tileMatrixSet: CharacterString + tileCol : Integer + tileRow : Integer + tileMatrix : CharacterString SampleDimensions from WMTS Get Tile + elevation [0..1] : Double + otherSampleDimensions [0..]: CharacterString + time [0..1] : CharacterString 1 1 1 1 0..1 1 1 1 Copyright © 2010 Open Geospatial Consortium Inc. 47 Table 25 — Parameters in GetFeatureInfo operation request Names Definition Data type and values Multiplicity and use service Service Service type identifier Character String type, not empty SHALL be ―WMTS‖ One mandatory request Request Operation name Character String type, not empty SHALL be GetFeatureInfo‖ One mandatory version Version Standard version for operation Character String type, not empty SHALL contain 1.0.0 One mandatory layer, style, format, Sample dimension, tileMatrixSet, tileMatrix, tileRow, tileCol These correspond to the parameters of the same name in the corresponding GetTile request described in Table 22 The values of these parameters SHALL match those in the corresponding GetTile request described in Table 22 Multiplicity and use of these parameters SHALL match those in the corresponding GetTile request described in Table 22 j J Row index of a pixel within the tile a Non negative integer type value between 0 and TileHeight-1 of this tile matrix defined in the ServiceMetadata document One mandatory i I Column index of a pixel within the tile b Non negative integer type value between 0 and TileWidth-1 of this tile matrix defined in the ServiceMetadata document One mandatory infoFormat InfoFormat Output format of the retrieved information Character String type, not empty value that is defined in the ServiceMetadata document One mandatory a Number of full pixels in the Tile to the left of the requested location b Number of full pixels in the Tile to the top of the requested location NOTE 1 To reduce the need for readers to refer to other documents, the first three parameters listed are largely copied from Table 26 in subclause 9.2.1 of OWS Common [OGC 06-121r3]. NOTE 2 The UML class diagram in Figure 11 provides a useful graphical view of the contents of the GetFeatureInfo operation request listed in Table 25. Although some values listed in the Names column appear to contain white spaces, they SHALL not contain any spaces.

7.3.2.2 GetFeatureInfo exceptions in procedure oriented architectural style

When a WMTS server encounters an error while performing a GetFeatureInfo operation, it SHALL return an exception report message as specified in subclause 7.4 of OWS Common [OGC 06-121r3]. The allowed standard exception codes SHALL include those listed in Table 26. For each listed exceptionCode, the contents of the ―locator‖ parameter value SHALL be as specified in the right column of Table 26. 48 Copyright © 2010 Open Geospatial Consortium Inc. Table 26 — Exception codes for GetFeatureInfo operation exceptionCode value Meaning of code ―locator‖ value OperationNotSupported Request is for an operation that is not supported by this server or you are requesting a GetFeatureInfo response for a non queryable layer Name of operation not supported MissingParameterValue Operation request does not include a parameter value, and this server did not declare a default value for that parameter Name of missing parameter InvalidParameterValue Operation request contains an invalid parameter value Name of parameter with invalid value TileOutOfRange TileRow or TileCol out of range Name of the out-of- range parameter PointIJOutOfRange I or J out of range Name of the out-of- range parameter NoApplicableCode No other exceptionCode specified by this service and server applies to this exception None, omit ―locator‖ parameter NOTE To reduce the need for readers to refer to other documents, the first four values listed below are copied from Table 25 in subclause 8.3 of OWS Common [OGC 06-121r3]. If the client sends a GetFeatureInfo request using unknown parameters for example time, elevation or any other dimension that are not advertised in the ServiceMetadata document these unknown parameters SHALL be ignored by the server and will not cause an exception to be generated. When a WMTS server responds with an ExceptionReport and the report is transmitted via HTTP the WMTS server should s et the HTTP response’s status code to the corresponding value for the given exceptionCode values, as shown in Table 27. When the ExceptionReport contains more than one Exception then the HTTP status code value should be based upon the exceptionCode of the first Exception in the ExceptionReport. Table 27 — HTTP exception codes and meanings on GetFeatureInfo operation exceptionCode value HTTP Status Code Code Message OperationNotSupported 501 Not implemented MissingParameterValue 400 Bad request InvalidParameterValue 400 Bad request TileOutOfRange 400 Bad request PointIJOutOfRange 400 Bad request NoApplicableCode 500 Internal server error