Requirements Class: GetFeatureOfInterest KVP Binding

Copyright © 2012 Open Geospatial Consortium. 89

13.3 Requirements Class: GetFeatureOfInterest KVP Binding

This requirements class defines a KVP binding for the GetFeatureOfInterest operation. The here defined KVP binding of the GetFeatureOfInterest operation is a realization of the conceptual model of that operation as defined in Subclause 9.1.1. In general, all requirements defined for the conceptual model of the GetFeatureOfInterest operation apply for its realization as a KVP binding. However, due to the limitations of a KVP binding, the parameterization of the operation needs to be restricted and further defined as described below. Table 51: GetFeatureOfInterest request KVP encoding Name Definition and format Optionality service Identifier of the OGC service. Fixed value: “ SOS ”. Mandatory version Request protocol version. Fixed value “ 2.0.0 ”. Mandatory request Request type name. Fixed value: “ GetFeatureOfInterest ”. Mandatory featureOfInterest Comma-separated unordered list of one or more URL- encoded URIs pointing to requested features of interest. 1 Optional observedProperty Comma-separated unordered list of one or more URL- encoded URIs pointing to observed properties which are properties of the requested features of interest. 1 Optional procedure Comma-separated unordered list of one or more URL- encoded URIs pointing to procedures which observe the requested features of interest. 1 Optional namespaces Defines the mapping of XML prefixes used in Conditional; Requirement http:www.opengis.netspecSOS2.0reqkvp-corego-response Requirement 118 The response behaviour of the GetObservation operation shall be as defined in Subclause 8.3.2 of this document. If the response format chosen in the request requires that a GetObservationResponse be returned then it shall be encoded as defined in subclause 13.1 Requirements Class http:www.opengis.netspecSOS2.0reqkvp-foiRetrieval Target Type Web Service Dependency http:www.opengis.netspecSOS2.0reqkvp-core Dependency http:www.opengis.netspecSOS2.0reqfoiRetrieval Requirement http:www.opengis.netspecSOS2.0reqkvp-foiRetrievalrequest Requirement http:www.opengis.netspecSOS2.0reqkvp-foiRetrievalbbox-encoding Requirement http:www.opengis.netspecSOS2.0reqkvp-foiRetrievalrequest Requirement 119 The KVP encoding of a GetFeatureOfInterest request shall be as defined in Table 51. 90 Copyright © 2012 Open Geospatial Consortium. valueReferences included in other request parameters to their respective XML namespace URIs. See Requirement 109 for further details. include if spatialFilter is contained in request and uses XML prefixes in path expression of valueReferenc e spatialFilter Specifies a bounding box used as a spatial filter which applies to a spatial property identified by its valueReference of the requested features. 1 The bounding box is encoded as defined in Requirement 120. Optional 1 The context of this filter parameter is specified in Requirement 46. Example 33 The following example shows a KVP-encoded GetFeatureOfInterest request 17 : http:myserver.org:portpath ?service=SOS version=2.0.0 request=GetFeatureOfInterest observedProperty=http:sweet.jpl.nasa.gov2.0atmoThermo.owlEffectiveTemp erature procedure=http:www.my_namespace.orgsensorsthermometer1 namespaces=xmlnssams,http:www.opengis.netsamplingSpatial2.0,xmlnsom, http:www.opengis.netom2.0 17 For the purpose of better readability, this example contains URL-decoded query parameter values Requirement http:www.opengis.netspecSOS2.0reqkvp-foiRetrievalbbox-encoding Requirement 120 For the KVP binding, a bounding box shall be used as spatialFilter as defined in the conceptual model of the GetFeatureOfInterest operation Subclause 9.1.1. The encoding of the bounding box shall be a list of comma separated values. The first value shall be the valueReference that identifies the spatial property of the features to which this bounding box, as a spatial filter, is applied – following the requirements on ValueReference as defined by ISO 19143OGC 09-026r1. The following values shall be as defined in Subclause 10.2.3 of [OGC 06-121r3]. This results in the following encoding: valueReference,minCoordinate1,minCoordinate2,...,minCoordinateN,maxCoordin ate1,maxCoordinate2,...,maxCoordinateN,crsURI The crsURI is optional. An example value for crsURI is “ urn:ogc:def:crs:EPSG::4326 ”. Copyright © 2012 Open Geospatial Consortium. 91 spatialFilter=om:featureOfInterestsams:shape,22.32,11.2,32.32,22.2,urn:o gc:def:crs:EPSG::4326

13.4 Requirements Class: KVP Binding for Result Retrieval