86 Copyright © 2012 Open Geospatial Consortium.
Example 31 The following KVP structure requests metadata about a procedure
15
: http:www.myserver.org:portpath
?service=SOS version=2.0.0
request=DescribeSensor procedure=urn:ogc:object:Sensor:MyOrg:thermometer1
procedureDescriptionFormat=http:www.opengis.netsensorML1.0.1 validTime=2010-01-01T18:31:42Z
13.2.3 GetObservation KVP Binding
This KVP binding is a realization of the conceptual model of the GetObservation operation as defined in Subclause 8.3. In general, all requirements defined for the conceptual model of the
GetObservation 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 50: GetObservation 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: “
GetObservation
”. Mandatory
offering Comma-separated unordered list of one or more URL-
encoded URIs pointing to the requested observation offerings.
1
Optional observedProperty Comma-separated
unordered list of one or more URL- encoded URIs pointing to the observed properties of the
Optional
15
For the purpose of better readability, this example contains URL-decoded query parameter values.
Requirement http:www.opengis.netspecSOS2.0reqkvp-coreds-response
Requirement 114 The response behaviour of the DescribeSensor operation shall be as defined in
Subclause 8.2 of this document. The operation response shall be encoded as defined in Annex B of OGC 09-001
Requirement http:www.opengis.netspecSOS2.0reqkvp-corego-request
Requirement 115 The KVP encoding of a GetObservation request shall be as defined in Table 50.
Copyright © 2012 Open Geospatial Consortium. 87
requested observations.
1
procedure Comma-separated unordered list of one or more URL- encoded URIs pointing to procedures of the requested
observations.
1
Optional featureOfInterest Comma-separated unordered list of one or more URL-
encoded URIs pointing to specific features of interest of observations stored by the service.
1
Optional namespaces
Defines the mapping of XML prefixes used in valueReferences included in other request parameters to
their respective XML namespace URIs. See Requirement 109 for further details.
Conditional; include if
spatialFilter andor
temporalFilter 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 observations.
1
The bounding box is encoded as defined in Requirement 116.
Optional
temporalFilter Specifies a temporal filter which applies to a temporal
property identified by its valueReference of the requested observations.
1
The filter is encoded as defined in Requirement 117. Optional
responseFormat Specifies the desired response format for transport of the
observations. The supported output formats are listed in the ObservationOffering in the Capabilities document.
By default this is OM 2.0 [OGC 10-025] identified by the value
“
http3A2F2Fwww.opengis.net2Fom2F2.0
” URL-encoded namespace.
Optional
1 The context of this filter parameter is specified in 0.
Requirement http:www.opengis.netspecSOS2.0reqkvp-corego-bbox-encoding
Requirement 116 For the KVP binding, a bounding box shall be used as the
spatialFilter
as defined in the conceptual model of the GetObservation operation Subclause 8.3.
The encoding of the bounding box shall be a list of comma separated values. The first value shall be the
valueReference
of the spatial property of the observations to which this bounding box, as a spatial filter, is applied – following the requirements on ValueReference as defined by [ISO 19143]
[OGC 09-026r1]. The following values shall be as defined in Subclause 10.2.3 of [OGC 06-121r3].
88 Copyright © 2012 Open Geospatial Consortium.
Example 32 The following example shows a KVP-encoded GetObservation request
16
: http:myserver.org:portpath
?service=SOS version=2.0.0
request=GetObservation offering=http:www.my_namespace.orgthermometer1_observations
observedProperty=http:sweet.jpl.nasa.gov2.0atmoThermo.owlEffectiveTemp erature
procedure=http:www.my_namespace.orgsensorsthermometer1 featureOfInterest=http:wfs.example.org?request=getFeatureamp;featureid=b
uilding1 namespaces=xmlnssams,http:www.opengis.netsamplingSpatial2.0,xmlnsom,
http:www.opengis.netom2.0 spatialFilter=om:featureOfInterestsams:shape,22.32,11.2,32.32,22.2,urn:o
gc:def:crs:EPSG::4326 temporalFilter=om:phenomenonTime,2009-01-10T10:00:00Z2009-01-10T11:00:00Z
16
For the purpose of better readability, this example contains URL-decoded query parameter values.
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
”.
Requirement http:www.opengis.netspecSOS2.0reqkvp-corego-temporalFilter-encoding
Requirement 117 As defined in the conceptual model of the GetObservation operation Subclause 8.3,
the
temporalFilter
parameter shall be used to filter on a temporal property of the requested observations e.g., the
phenomenonTime
property.The value of the
temporalFilter
parameter shall be encoded compliant to [ISO 8601]. Instances and periods of time shall be supported. Periods
of time start and end are separated by “”. If the
temporalFilter
consists of a time instant, it shall apply the semantics of the TEquals
operator. If the
temporalFilter
consists of a time period, it shall apply the semantics of the During
operator. The encoding of the
temporalFilter
shall be a list of two comma separated values. The first value shall be the
valueReference
of the temporal property of the observations to which the temporal filter is applied – following the requirements on ValueReference as defined by [ISO
19143] [OGC 09-026r1]. This results in the following encoding:
valueReference,iso8601Time
Copyright © 2012 Open Geospatial Consortium. 89
13.3 Requirements Class: GetFeatureOfInterest KVP Binding