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