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
This requirements class defines a KVP binding for the GetResult and GetResultTemplate operations.
The here defined KVP binding of the GetResult and GetResultTemplate operations is a realization of the conceptual model of these operations as defined in Subclause 11.2. In general, all
requirements defined for the conceptual model of the GetResult and GetResultTemplate operations apply for its realization as a KVP binding. However, due to the limitations of a KVP
binding, the parameterization of the operations needs to be restricted and further defined as described below.
13.4.1 GetResultTemplate KVP Binding
Table 52: GetResultTemplate 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: “
GetResultTemplate
”. Mandatory
offering A URL-encoded URI pointing to the requested
ObservationOffering.
1
Mandatory observedProperty
A URL-encoded URI pointing to the observed property for which to retrieve observation results.
1
Mandatory 1 The context of this filter parameter is specified in Requirement 91.
Requirements Class
http:www.opengis.netspecSOS2.0reqkvp-result Target Type
Web Service
Dependency http:www.opengis.netspecSOS2.0reqkvp-core
Dependency
http:www.opengis.netspecSOS2.0reqresultRetrieval
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgrt-request
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgrt-response
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgr-request
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgr-response-xml
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgr-response-raw
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgrt-request
Requirement 121 The KVP encoding of a GetResultTemplate request shall be as defined in Table 52.
92 Copyright © 2012 Open Geospatial Consortium.
Example 34 The following example shows a KVP-encoded GetResultTemplate request:
http:myserver.org:portpath ?service=SOS
version=2.0.0 request=GetResultTemplate
offering=http:www.my_namespace.orgthermometer1_observations observedProperty=http:sweet.jpl.nasa.gov2.0atmoThermo.owlEffectiveTemp
erature
13.4.2 GetResult KVP Binding
Table 53: GetResult 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: “
GetResult
”. Mandatory
offering A URL-encoded URI pointing to the requested
ObservationOffering.
1
Mandatory observedProperty
A URL-encoded URI pointing to the observed property for which to retrieve observation results.
1
Mandatory featureOfInterest Comma-separated unordered list of one or more URL-
encoded URIs pointing to features of interest of observations for which result values are requested.
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
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgrt-response
Requirement 122 The response behaviour of the GetResultTemplate operation shall be as defined in
Subclause 11.2.1.2 of this document and encoded in XML as defined by the “XML Encoding” requirements class.
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgr-request
Requirement 123 The KVP encoding of a GetResult request shall be as defined in Table 53.
Copyright © 2012 Open Geospatial Consortium. 93
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
xmlWrapper Specifies whether the response should be wrapped into an
XML element or if the SWE Common encoded results should be provided raw. Default is: “false”
NOTE: Raw binary encoded results can only be sent if xmlWrapper is set to false.
Optional
1 The context of this filter parameter is specified in Error Reference source not found..
Example 35 The following example shows a KVP-encoded GetResult request
18
: http:myserver.org:portpath
?service=SOS version=2.0.0
request=GetResult
offering=http:www.my_namespace.orgthermometer1_observations observedProperty=http:sweet.jpl.nasa.gov2.0atmoThermo.owlEffectiveTemp
erature 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
18
For the purpose of better readability, this example contains URL-decoded query parameter values.
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgr-response-xml
Requirement 124 When the xmlWrapper request argument is set to true, the response behaviour of the
GetResult operation shall be as defined in Subclause 11.2.2.2 of this document and encoded in XML as defined by the “XML Encoding” requirements class.
Requirement http:www.opengis.netspecSOS2.0reqkvp-resultgr-response-raw
94 Copyright © 2012 Open Geospatial Consortium.
13.5 Requirements Class: SOAP Binding