PEGELONLINE Web Feature Service (WFS)
PEGELONLINE WFS stellt kostenfrei tagesaktuelle Wasserstände der Binnen- und Küstenpegel der Wasserstraßen des Bundes als WFS zur Verfügung.
Hierbei können aktuelle Wasserstände der Pegel als Vektordaten bezogen werden und in eine Kartenanwendung integriert werden. Der WFS steht unter folgender URL zur Verfügung:
https://pegelonline-test.wsv.de/webservices/gis/aktuell/wfs
Hinweis: Bei manchen Clients werden keine Pegel bzw. Fatures in der WFS Version 1.1.0 angezeigt. Um WFS Version 1.0.0 zu erzwingen, sollte folgende URL angegeben werden: https://pegelonline-test.wsv.de/webservices/gis/aktuell/wfs?version=1.0.0
Eigenschaften pro Pegel bzw. pro Feature:
Neben den Positionsangaben werden folgende Sachdaten mitgeliefert:- water: Name des Gewässers
- station: Name des Pegels
- station_id: Pegelnummer
- station_ud: Pegel-UUID
- kilometer: Flusskilometer
- date: Zeitpunkt der aktuellen Messung als ISO_8601 codierter Zeitstempel. Beispiel: 2010-09-24T17:15:00+02:00
- value: Der Messwert der aktuellen Messung
- unit: Die Maßeinheit der aktuellen Messung
- chart_url: Http-URL zur interaktiven OnlineVisualisierung
- status: Status bezogen auf die Aktualität des Messwerts: up-to-date, out-dated, commented. Als up-to-date gilt ein Messwert im Regelfall dann, wenn er nicht älter als 25 Stunden ist.
- comment: Kommentar, z.B. bei einem ausgefallenem oder gestörtem Pegel. Im Normalfall ist dieses Feld leer.
-
mnwmhw_st: Die Höhe des aktuellen Wasserstandes bezogen auf den MNW und den MHW. Dieses Attribut kann folgende Werte annehmen:
- low: Aktueller Wasserstand unterhalb/gleich des MNW
- normal: Aktueller Wasserstand zwischen MNW und MHW
- high: Aktueller Wasserstand oberhalb/gleich MHW
- unknown: Unbekannt, da MHW/MNW für Pegel nicht vorhanden
- commented: Fehlfunktion oder Störung. Siehe Attribut comment
- out-dated: Aktueller Wasserstand veraltet (älter als 25 Stunden)
-
nswhsw_st: Die Höhe des aktuellen Wasserstandes bezogen auf den HSW. Dieses Attribut kann folgende Werte annehmen:
- normal: Aktueller Wasserstand unterhalb des HSW
- high: Aktueller Wasserstand oberhalb/gleich des HSW
- unknown: Unbekannt, da HSW für Pegel nicht vorhanden
- commented: Fehlfunktion oder Störung. Siehe Attribut comment
- out-dated: Aktueller Wasserstand veraltet (älter als 25 Stunden)
Weitere Eigenschaften:
- unterstützt WFS Spezifikation 1.0.0 und 1.1.0. Welche Version verwendet wird, bestimmt der WFS-Client.
- es werden die Operationen eines Basic-WFS angeboten: nur-lesender Zugriff auf die Operationen GetCapabilities, DescribeFeatureType und GetFeature
-
als natives Koordinatenbezugssystem wird WGS 84 (EPSG:4326) verwendet. Mit Hilfe des URL-Parameters srsName, können die nativen
Koordinaten in ein anderes Bezugsssystem projiziert werden.
Bindet man PEGELONLINE WFS beispielsweise mit https://pegelonline-test.wsv.de/webservices/gis/aktuell/wfs?srsName=epsg:31467 ein, so wird die Position aller Pegel bzw. Features innerhalb des Gauß-Krüger/Zone 3 Bezugssystems angegeben.
Beispielabfragen:
- GetCapabilities-Operation in WFS 1.1.0: https://pegelonline-test.wsv.de/webservices/gis/aktuell/wfs?service=wfs&version=1.1.0&request=GetCapabilities
- DescribeFeatureType-Operation in WFS 1.1.0: https://pegelonline-test.wsv.de/webservices/gis/aktuell/wfs?service=wfs&version=1.1.0&request=DescribeFeatureType&typeName=gk:waterlevels
- GetFeature-Operation in WFS 1.1.0: https://pegelonline-test.wsv.de/webservices/gis/aktuell/wfs?service=wfs&version=1.1.0&request=GetFeature&typeName=gk:waterlevels
- GetFeature-Operation in WFS 1.0.0: https://pegelonline-test.wsv.de/webservices/gis/aktuell/wfs?service=wfs&version=1.0.0&request=GetFeature&typeName=gk:waterlevels
- GetFeature-Operation mit Filter in WFS 1.1.0, nur Pegel bzw. Feature des Gewässers Elbe: https://pegelonline-test.wsv.de/webservices/gis/aktuell/wfs?service=wfs&version=1.1.0&request=GetFeature&typeName=gk:waterlevels&Filter=<Filter><And><PropertyIsEqualTo><PropertyName>water</PropertyName><Literal>ELBE</Literal></PropertyIsEqualTo></And></Filter>