70 Copyright © 2012 Open Geospatial Consortium.
Table 40: default context for GetResultTemplate request parameters with pre-defined target property
Filter Property
Target property for PropertyIsEqualTo comparison operator
offering Capabilities.contents.offering observedProperty OM_Observation.observedProperty
NOTE
: in an XML based SOS implementation the filter context can be defined via XPath expressions – see Table 48 in Subclause 13.1.
11.2.1.2 Response
The SOS
GetResultTemplateResponse
data type derives from the SWES
ExtensibleResponse
data type defined in OGC 09-001 and inherits its properties.
Table 41: Properties of GetResultTemplateResponse data type Name
Definition Data type and values
Multiplicity and use
resultStructure The structure of the results which
may be requested in subsequent GetResult calls.
AbstractDataComponent see [OGC 08-094]
One mandatory
resultEncoding The encoding of the results which
may be requested in subsequent GetResult calls.
AbstractEncoding see [OGC 08-094]
One mandatory
Note: different to the result insertion extension, in the result retrieval extension the intention is not to construct complete observations with the result values returned via the
GetResultResponse . Consequently, there is no
requirement on SOS services to include components in the sos:GetResultResponsesos:resultStructure
to provide the phenomenon or result time of observations in. Such components may of course be part of an observation result. As such, SWE Common defined observation
results can easily be retrieved via the GetResultTemplateGetResult operations.
11.2.1.3 Exceptions
Requirement http:www.opengis.netspecSOS2.0reqresultRetrievalgrt-response-structure
Requirement 92 In addition to the properties inherited from SWES
ExtensibleResponse
, the SOS
GetResultTemplateResponse
shall include the properties according to Table 41.
Requirement http:www.opengis.netspecSOS2.0reqresultRetrievalgrt-exception
Requirement 93 When an SOS server encounters an error while performing a GetResultTemplate
operation, it shall return an exception message as specified in Clause 15 of [OGC 09-001] with applicable exception code as defined in
Copyright © 2012 Open Geospatial Consortium. 71
Table 42: InvalidPropertyOfferingCombination Exception exceptionCode value
Meaning of code “locator” value
InvalidPropertyOfferin gCombination
The service is unable to fulfill the request because the observations with the
specific combination of observedProperty and offering as
requested by the client do NOT have a SWE Common encoded result.
None, omit “locator” parameter
Listing 8: exception codes applicable to the GetResultTemplate operation
OperationNotSupported
MissingParameterValue
InvalidParameterValue
OptionNotSupported
NoApplicableCode
InvalidRequest
RequestExtensionNotSupported
InvalidPropertyOfferingCombination
Requirement 94 Table 42: InvalidPropertyOfferingCombination Exception
exceptionCode value Meaning of code
“locator” value
InvalidPropertyOfferin gCombination
The service is unable to fulfill the request because the observations with the
specific combination of observedProperty and offering as
requested by the client do NOT have a SWE Common encoded result.
None, omit “locator” parameter
Requirement 95 Listing 8. The meaning of each exception code shall be as defined in OGC 06-
121r3,OGC 09-001 and Table 42 in this standard.
72 Copyright © 2012 Open Geospatial Consortium.
11.2.1.4 Examples