Response Exceptions Examples GetObservationById operation

Copyright © 2012 Open Geospatial Consortium. 45 Table 30: default context for GetObservationById request parameters with pre-defined target property Filter Property Target property for PropertyIsEqualTo comparison operator observation OM_Observation NOTE: in an XML based SOS implementation the filter context can be defined via XPath expressions – see Table 48 in Subclause 13.1.

9.2.1.2 Response

The SOS GetObservationByIdResponse data type derives from the SWES ExtensibleResponse data type defined in OGC 09-001 and inherits its properties. Requirement http:www.opengis.netspecSOS2.0reqgobifilter-context Requirement 51 The default context for the ValueReferences used in the expression of a filter operator see OGC 09-026r1ISO 19143 for further details for the GetObservationById request parameters that have a pre-defined target property shall be as defined in Table 30. Requirement http:www.opengis.netspecSOS2.0reqobsByIdRetrievalresponse-structure Requirement 52 In addition to the properties inherited from SWES ExtensibleResponse , the SOS GetObservationByIdResponse shall include the property according to Table 31. Requirement http:www.opengis.netspecSOS2.0reqobsByIdRetrievalresponse-behavior Requirement 53 The GetObservationById operation response shall contain OM observations that have a gml:identifier value equal to one of the values of the observation parameter provided in the operation request. Requirement http:www.opengis.netspecSOS2.0reqobsByIdRetrievalempty-response Requirement 54 An instance of GetObservationByIdResponse type shall be empty if none of the observations associated with the SOS fulfill the GetObservationById parameter specified by the client. 46 Copyright © 2012 Open Geospatial Consortium. Table 31: Properties of GetObservationByIdResponse data type Name Definition Data type and values Multiplicity and use observation OM Observation matching one of the values of the observation request parameter specified by the client. OM_Observation see [OGC 10- 004r3ISO 19156] Zero or many optional

9.2.1.3 Exceptions

Listing 4: exception codes applicable to the GetObservationById operation  OperationNotSupported  MissingParameterValue  InvalidParameterValue  OptionNotSupported  NoApplicableCode  InvalidRequest  RequestExtensionNotSupported

9.2.1.4 Examples

Example 17 An example request of the XML implementation of the GetObservationById operation can be found here: http:schemas.opengis.netsos2.0examplesenhancedOperationsGetObservationById.xml Requirement http:www.opengis.netspecSOS2.0reqgobiexception Requirement 55 When an SOS server encounters an error while performing a GetObservationById operation, it shall return an exception message as specified in Clause 15 of [OGC 09-001] with applicable exception code as defined in Listing 4. The meaning of each exception code shall be as defined in OGC 06-121r3 and OGC 09-001. Copyright © 2012 Open Geospatial Consortium. 47 10 Transactional Extension

10.1 Requirements Class: InsertionCapabilities