Copyright © 2012 Open Geospatial Consortium. 41
Table 26: default context for GetFeatureOfInterest request parameters without pre-defined target property
Filter Property Context for ValueReference in filter operator
spatialFilter OM_Observation
Table 27: default context for GetFeatureOfInterest request parameters with pre-defined target property
Filter Property
Target property for PropertyIsEqualTo comparison operator
observedProperty OM_Observation.observedProperty procedure OM_Observation.procedure
featureOfInterest OM_Observation.featureOfInterest
NOTE
: in an XML based SOS implementation the filter context can be defined via XPath expressions – see Table 48 in Subclause 13.1.
9.1.1.2 Response
The SOS
GetFeatureOfInterestResponse
data type derives from the SWES
ExtensibleResponse
data type defined in OGC 09-001 and inherits its properties.
http:www.opengis.netspecSOS2.0reqfoiRetrievalfilter-context Requirement 46
The default context for the ValueReferences used in the expression of a filter operator see OGC 09-026r1ISO 19143 for further details for the GetFeatureOfInterest request
parameters that do not have a pre-defined target property and operator for filtering shall be as defined in Table 26. The default context for GetFeatureOfInterest request parameters that have a
pre-defined target property shall be as defined in Table 27.
Requirement http:www.opengis.netspecSOS2.0reqfoiRetrievalresponse-structure
Requirement 47 In addition to the properties inherited from SWES
ExtensibleResponse
, the SOS
GetFeatureOfInterestResponse
shall include the property according to Table 28.
Requirement http:www.opengis.netspecSOS2.0reqfoiRetrievalempty-response
42 Copyright © 2012 Open Geospatial Consortium.
Table 28: Properties of GetFeatureOfInterestResponse data type Name
Definition Data type and values
Multiplicity and use
featureMember Feature of interest of observations
matching the request parameters specified by the client.
GFI_Feature see [OGC 10-
004r3ISO 19156] Zero or many
optional
9.1.1.3 Exceptions
Listing 3: exception codes applicable to the GetFeatureOfInterest operation
OperationNotSupported
MissingParameterValue
InvalidParameterValue
OptionNotSupported
NoApplicableCode
InvalidRequest
RequestExtensionNotSupported
ResponseExceedsSizeLimit
9.1.1.4 Examples
Example 14 An example request of the XML implementation of the GetFeatureOfInterest operation with a
specified observedProperty
and procedure
can be found here: http:schemas.opengis.netsos2.0examplesenhancedOperationsGetFOI1.xml
Example 15 An example request of the XML implementation of the GetFeatureOfInterest operation with
specified featureOfInterest
can be found here:
Requirement 48 An instance of
GetFeatureOfInterestResponse
type shall be empty if none of the features of interest associated to observations stored by the SOS fulfill the
GetFeatureOfInterest parameters specified by the client.
Requirement http:www.opengis.netspecSOS2.0reqfoiRetrievalexception
Requirement 49 When an SOS server encounters an error while performing a GetFeatureOfInterest
operation, it shall return an exception message as specified in Clause 15 of [OGC 09-001] with applicable exception code as defined in Listing 3. The meaning of each exception code shall be as
defined in OGC 06-121r3, OGC 09-001 and Table 23 in this document.
Copyright © 2012 Open Geospatial Consortium. 43
http:schemas.opengis.netsos2.0examplesenhancedOperationsGetFOI2.xml
Example 16 An example request of the XML implementation of the GetFeatureOfInterest operation with a
specified observedProperty
and spatialFilter
can be found here: http:schemas.opengis.netsos2.0examplesenhancedOperationsGetFOI3.xml
9.2 Requirements Class: Observation Retrieval By ID