...
| Code Block |
|---|
<?xml version="1.0" encoding="UTF-8"?>
<wfs:FeatureCollection xmlns:wfs="http://www.opengis.net/wfs/2.0" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:gsml="urn:cgi:xmlns:CGI:GeoSciML:2.0" xmlns:om="http://www.opengis.net/om/2.0" xmlns:sa="http://www.opengis.net/sampling/2.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:wml2="http://www.opengis.net/waterml/2.0" xmlns:gmd="http://www.isotc211.org/2005/gmd" xmlns:sf="http://www.opengis.net/sampling/2.0" xmlns:sams="http://www.opengis.net/samplingSpatial/2.0" xsi:schemaLocation="http://www.opengis.net/om/2.0 ../observation.xsd http://www.opengis.net/gml/3.2 http://schemas.opengis.net/gml/3.2.1/gml.xsd http://www.opengis.net/sampling/2.0 ../samplingFeature.xsd http://www.opengis.net/waterml/2.0 ../waterml2.xsd http://www.opengis.net/swe/2.0 http://schemas.opengis.net/sweCommon/2.0/swe.xsd">
<wfs:member>
<om:featureOfInterest>
<wml2:WaterMonitoringPoint gml:id="0">
<sf:parameter>
<om:NamedValue>
<om:name xlink:title="Location name"/>
<om:value>0</om:value>
</om:NamedValue>
</sf:parameter>
<sams:shape>
<gml:Point gml:id="0">
<gml:pos srcName="Rijks Driehoekstelsel">53.64671168116518 5.175518773508316</gml:pos>
</gml:Point>
</sams:shape>
</wml2:WaterMonitoringPoint>
</om:featureOfInterest>
</wfs:member>
<wfs:member>
<om:featureOfInterest>
<wml2:WaterMonitoringPoint gml:id="1">
<sf:parameter>
<om:NamedValue>
<om:name xlink:title="Location name"/>
<om:value>1</om:value>
</om:NamedValue>
</sf:parameter>
<sams:shape>
<gml:Point gml:id="1">
<gml:pos srcName="Rijks Driehoekstelsel">53.3835058954904 4.560651062185197</gml:pos>
</gml:Point>
</sams:shape>
</wml2:WaterMonitoringPoint>
</om:featureOfInterest>
</wfs:member>
<wfs:member>
<om:featureOfInterest>
<wml2:WaterMonitoringPoint gml:id="2">
<sf:parameter>
<om:NamedValue>
<om:name xlink:title="Location name"/>
<om:value>2</om:value>
</om:NamedValue>
</sf:parameter>
<sams:shape>
<gml:Point gml:id="2">
<gml:pos srcName="Rijks Driehoekstelsel">52.48257667744973 4.283120419290973</gml:pos>
</gml:Point>
</sams:shape>
</wml2:WaterMonitoringPoint>
</om:featureOfInterest>
</wfs:member>
<wfs:member>
<om:featureOfInterest>
<wml2:WaterMonitoringPoint gml:id="3">
<sf:parameter>
<om:NamedValue>
<om:name xlink:title="Location name"/>
<om:value>3</om:value>
</om:NamedValue>
</sf:parameter>
<sams:shape>
<gml:Point gml:id="3">
<gml:pos srcName="Rijks Driehoekstelsel">51.493692036021535 3.0541898956873954</gml:pos>
</gml:Point>
</sams:shape>
</wml2:WaterMonitoringPoint>
</om:featureOfInterest>
</wfs:member>
<wfs:member>
<om:featureOfInterest>
<wml2:WaterMonitoringPoint gml:id="4">
<sf:parameter>
<om:NamedValue>
<om:name xlink:title="Location name"/>
<om:value>4</om:value>
</om:NamedValue>
</sf:parameter>
<sams:shape>
<gml:Point gml:id="4">
<gml:pos srcName="Rijks Driehoekstelsel">50.99065599128154 3.0796721627765615</gml:pos>
</gml:Point>
</sams:shape>
</wml2:WaterMonitoringPoint>
</om:featureOfInterest>
</wfs:member>
<wfs:member>
<om:featureOfInterest>
<wml2:WaterMonitoringPoint gml:id="5">
<sf:parameter>
<om:NamedValue>
<om:name xlink:title="Location name"/>
<om:value>5</om:value>
</om:NamedValue>
</sf:parameter>
<sams:shape>
<gml:Point gml:id="5">
<gml:pos srcName="Rijks Driehoekstelsel">51.01107956492021 4.6177610376887515</gml:pos>
</gml:Point>
</sams:shape>
</wml2:WaterMonitoringPoint>
</om:featureOfInterest>
</wfs:member>
<wfs:member>
<om:featureOfInterest>
<wml2:WaterMonitoringPoint gml:id="6">
<sf:parameter>
<om:NamedValue>
<om:name xlink:title="Location name"/>
<om:value>6</om:value>
</om:NamedValue>
</sf:parameter>
<sams:shape>
<gml:Point gml:id="6">
<gml:pos srcName="Rijks Driehoekstelsel">50.59113044096123 5.4719202115344</gml:pos>
</gml:Point>
</sams:shape>
</wml2:WaterMonitoringPoint>
</om:featureOfInterest>
</wfs:member>
<wfs:member>
<om:featureOfInterest>
<wml2:WaterMonitoringPoint gml:id="7">
<sf:parameter>
<om:NamedValue>
<om:name xlink:title="Location name"/>
<om:value>7</om:value>
</om:NamedValue>
</sf:parameter>
<sams:shape>
<gml:Point gml:id="7">
<gml:pos srcName="Rijks Driehoekstelsel">50.58761564487022 6.290845285636415</gml:pos>
</gml:Point>
</sams:shape>
</wml2:WaterMonitoringPoint>
</om:featureOfInterest>
</wfs:member>
</wfs:FeatureCollection>
|
Retrieve Pi Parameters file containing all parameters that are available for the passed 'filterId' argument.
If argument 'null' is passed then all parameters configured in the pre-defined filter will be returned.
The PiVersion defines the format of the return file content. If omitted the latest version of the Pi file format will be used. (Expected 1.9 or higher).
- clientId <id not used>.
- filterId Filter id (optional).
- piVersion File format version (optional)
- returns PiTimeSeriesParameters XML file content.
| Code Block |
|---|
String getTimeSeriesHeadersForFilter(String clientId, Date startTime, Date timeZero, Date endTime, String filterId, String[] locationIds, String[] parameterIds, boolean useDisplayUnits, String piVersion);
|
Read the timeseries header information from the webservice. Returns a pi timeseries xml file containing the timeseries headers information belonging to the filter defined by the 'filterId'.
Retrieve the timeseries data using the method getTimeSeriesForFilter
The PiVersion defines the format of the return file content. If omitted the latest version of the Pi file format will be used. (Expected 1.9 or higher).
- clientId <id not used>.
- startTime start date/time of run.
- timeZero Forecast time zero. If missing System time is used (optional)
- endTime end date/time of run.
- filterId Filter id (optional).
- locationIds Subset of locations for which to retrieve timeseries (optional).
- parameterIds Subset of parameters for which to retrieve timeseries (optional).
- useDisplayUnits Export values using display units (optional).
- piVersion File format version (optional)
- return PiTimeseries xml file content.
...
Get Observations
The GetObservations call supports two types of requests:
- Firstly the HTTP-GET request where all request parameters are entered in the URL string.
The HTTP-GET option supports the following URL parameters
- request=GetObservations: Always required
- featureId=<location id>: Returns the observations for a given location. It is possible to enter multiple location ids separated by ','.
- observedProperty=<parameter id>: Returns the observations for a given parameter. It is possible to enter multiple parameters ids separated by ','.
- beginPosition=<date time, yyyy-MM-dd'T'HH:mm:ssZ>: Represents the start time of the period for which to return observations.
- endPosition=<date time, yyyy-MM-dd'T'HH:mm:ssZ>: Represents the end time of the period for which to return observations.
- analysisTime=<date time, yyyy-MM-dd'T'HH:mm:ssZ>: Optional value. Used to return forecast values. If omitted the values of the current forecast are always returned. Corresponds to the T0 of the forecast that produced the requested values.
| Code Block |
|---|
http://localhost:8081/WaterMlService/waterml?request=GetObservation&featureId=1&observedProperty=Parameter&beginPosition=2013-02-01T00:00:00%2B01:00&endPosition=2013-03-01T00:00:00%2B01:00&analysisTime=2013-02-01T00:00:00%2B01:00
|
The HTTP-POST option supports the following parameters
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" ?>
<sos:GetObservation version="2.0.0" service="SOS"
maxFeatures="3"
xmlns:sos="http://schemas.opengis.net/sos/2.0.0/"
xmlns:wfs="http://www.opengis.net/wfs"
xmlns:ogc="http://www.opengis.net/ogc"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:om="http://www.opengis.net/om/2.0"
xmlns:fes="http://www.opengis.net/fes/2.0"
xmlns:xlink="http://www.w3.org/1999/xlink"
xsi:schemaLocation="http://www.opengis.net/sos/2.0 http://schemas.opengis.net/sos/2.0.0/sos.xsd">
<sos:featureOfInterest>0</sos:featureOfInterest>
<sos:observedProperty>T.for</sos:observedProperty>
<sos:temporalFilter>
<fes:During>
<fes:ValueReference>phenomenonTime</fes:ValueReference>
<gml:TimePeriod gml:id="tp_1">
<gml:beginPosition>2013-02-15T01:00:00.000+01:00</gml:beginPosition>
<gml:endPosition>2013-03-01T01:00:00.000+01:00</gml:endPosition>
</gml:TimePeriod>
</fes:During>
</sos:temporalFilter>
<sos:temporalFilter>
<fes:TEquals>
<fes:ValueReference>analysisTime</fes:ValueReference>
<gml:TimeInstant gml:id="ti_2">
<gml:timePosition>2013-03-02T00:00:00.000+01:00</gml:timePosition>
</gml:TimeInstant>
</fes:TEquals>
</sos:temporalFilter>
</sos:GetObservation>
|
Secondly the HTTP-POST request where the request is written as a XML document.
Returns a pi timeseries xml file containing the timeseries data belonging to the filter defined by the 'filterId'.
The 'convertDatum' argument is to allow timeseries that support a global datum to have their values converted from a value relative to the location height to an absolute value.
...
- clientId <id not used>.
- startTime start date/time of run.
- timeZero Forecast time zero. If missing System time is used (optional)
- endTime end date/time of run.
- filterId Filter id (optional).
- locationIds Subset of locations for which to retrieve timeseries (optional).
- parameterIds Subset of parameters for which to retrieve timeseries (optional).
- convertDatum Convert values from relative location height to absolute height values (optional).
- useDisplayUnits Export values using display units (optional).
- piVersion File format version (optional)
- return PiTimeseries xml file content.
...
| language | java |
|---|
...
QueryParameters is defined by following schema definition:
...