sos4R (version 0.1-15)

GetObservation: GetObservation and GetObservationById Request Objects

Description

Classes (and their construction functions) to request observations from a Sensor Observation Service.

Usage

SosGetObservation(service, version, offering, observedProperty, responseFormat, srsName = as.character(NA), eventTime = list(NA), procedure = as.character(NA), featureOfInterest = NULL, result = NULL, resultModel = as.character(NA), responseMode = as.character(NA), BBOX = as.character(NA))
SosGetObservationById(service, version, observationId, responseFormat, srsName = as.character(NA), resultModel = as.character(NA), responseMode = as.character(NA))

Arguments

service

The service attribute of the request, e.g. SOS.

version

The version attribute of the request, e.g. 1.0.0.

observationId

The value of the ObservationId element in the request, e.g. o_12345, which is to be optained. This could have been obtained by the client via a URL in a feed, alert, or some other notification.

offering

The offering element value in the request, e.g. "temperatures". All other parameters are depending on the selected offering.

observedProperty

A list of values for observedProperty elements in the request, e.g. "urn:property:AirTemperature". IDs of phenomena are advertised in capabilities document.

responseFormat

The responseFormat element value in the request, e.g. text/xml;subtype="om/1.0.0". ID of the output format to be used for the requested data. The supported output formats are listed in the selected offering capabilities.

srsName

The srsName attribute of the request, e.g. urn:ogc:def:crs:EPSG:4326.

eventTime

A list of objects of class SosEventTime-class which are added as eventTime elements to the request. Allows a client to request observations from a specific instant, multiple instances or periods

procedure

A list of procedure identifiers added to the request as procedure elements.

featureOfInterest

An object of class SosFeatureOfInterest added to the request as the featureOfInterest element, or NULL. Specifies target feature for which observations are requested.

result

An object of class OgcComparisonOps-class added to the request as result element, or NULL, or any element that can be encoded using encodeXML(...) and then be added

resultModel

The resultModel element of the request, e.g. om:Measurement, which is an identifier of the result model to be used for the requested data. The resultModel values supported by a service are listed in the contents section of the se

responseMode

The responseMode element of the request, e.g. inline, which allows the client to request the form of the response.

BBOX

A bounding box to be used only with KVP encoding in request via HTTP GET, in the format minlon,minlat,maxlon,maxlat,srsURI?, with the spatial reference system being optional. This element is ignored for POST

Value

• An object of class SosGetObservation-class or SosGetObservationById-class respectively.

Objects from the Class

Objects can be created by calls to the construction functions of the form SosGetObservationById(...) or SosGetObservationById(...).

Extends

SosGetObservation: Class "OwsServiceOperation", directly.

SosGetObservationById: Class "OwsServiceOperation", directly.

Details

Please consult the specification for details on possible contents of the request.

References

See OGC 06-009r6 section 8.4, or the XSD schema file at http://schemas.opengis.net/sos/1.0.0/sosGetObservation.xsd.

See OGC 06-009r6 section 10.1, or the XSD schema file at http://schemas.opengis.net/sos/1.0.0/sosGetObservationById.xsd.

See Also

SosGetObservation-class, SosGetObservationById-class

Examples

showClass("SosGetObservation")
showClass("SosGetObservationById")

observationRequest <- SosGetObservation(service = "SOS", version = "1.0.0", offering = "temperatures", observedProperty = list("urn:property:AirTemperature"), responseFormat = "text/xml;subtype="om/1.0.0"")
print(observationRequest)

observationByIdRequest <- SosGetObservationById(service = "SOS", version = "1.0.0", observationId = "o_12345", responseFormat = "text/xml;subtype="om/1.0.0"")
print(observationByIdRequest)

sos <- SOS("http://mysos.net/sos")
encodeXML(observationByIdRequest, sos = sos)