Exceptions Examples GetCapabilities Operation

28 Copyright © 2012 Open Geospatial Consortium. Other response formats may be supported as well. However, the way how such formats are supported needs to be described in a specific extension to this document.

8.1.3 Exceptions

Listing 1: exception codes applicable to the GetCapabilities operation  MissingParameterValue  InvalidParameterValue  VersionNegotiationFailed  InvalidUpdateSequence  OptionNotSupported  NoApplicableCode  InvalidRequest  RequestExtensionNotSupported

8.1.4 Examples

Example 3 An example request of the XML implementation of this operation can be found here: http:schemas.opengis.netsos2.0examplescoreGetCapabilities1.xml http:www.opengis.netspecSOS2.0reqcoregc-response-format-om20 Requirement 23 The responseFormat of each ObservationOffering shall have at least the value http:www.opengis.netom2.0. Requirement http:www.opengis.netspecSOS2.0reqcoregc-observation-result-type Requirement 24 The observation type identifiers listed in the observationType property of an ObservationOffering shall identify an observation type with unique result type, i.e. a unique combination of OM_Observation or derived type and one specific type that the result of the observation is provided in. Requirement http:www.opengis.netspecSOS2.0reqcoregc-exception Requirement 25 When an SOS server encounters an error while performing a GetCapabilities operation, it shall return an exception message encoded as specified in Clause 15 of [OGC 09-001] with applicable exception code as defined in Listing 1. The meaning of each exception code shall be as defined in OGC 06-121r3 and OGC 09-001. Copyright © 2012 Open Geospatial Consortium. 29 Example 4 An example response of the XML implementation of this operation can be found here: http:schemas.opengis.netsos2.0examplescoreGetCapabilities1_response.xml

8.2 DescribeSensor Operation

The DescribeSensor operation enables the retrieval of metadata descriptions of procedures or: sensors associated with an SOS. While the response to a GetCapabilities request lists procedures associated with the SOS the DescribeSensor operation can be used subsequently to retrieve detailed definitions for the listed procedures. The definition of this operation can be found in Clause 11 of [OGC 09-001].

8.2.1 Examples

Example 5 An example request of the XML implementation of this operation can be found here: http:schemas.opengis.netsos2.0examplescoreDescribeSensor1.xml

8.3 GetObservation Operation

The GetObservation operation is designed to query an SOS to retrieve observation data structured according to the OM specification. Other response formats are possible; however, OM is the default and mandatory format for every SOS server. Several parameters of the GetObservation operation allow extensive filtering of the observations requested from the SOS server. The conceptual model of the GetObservation operation is shown in the following UML diagram. Requirement http:www.opengis.netspecSOS2.0reqcoreds Requirement 26 Every SOS server shall support the DescribeSensor operation as defined in Clause 11 of [OGC 09-001]. When targetting procedures hosted by the SOS, the service attribute in the DescribeSensor request shall have the value “SOS” and the version attribute shall have the value “2.0.0”. Requirement http:www.opengis.netspecSOS2.0reqcorego Requirement 27 Every SOS server shall support the GetObservation operation as defined here.