GetResultTemplate KVP Binding GetResult KVP Binding

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