Überblick

Über die PEGELONLINE-Webservices können Drittanbieter kostenlos ihre Angebote mit Daten von PEGELONLINE erweitern. Diese umfassen tagesaktuelle Rohdaten verschiedener hydrologischer Parameter, wie zum Beispiel Wasserstände, von Binnen- und Küstenpegeln entlang der Bundeswasserstraßen.

Die Wasserstraßen- und Schifffahrtsverwaltung des Bundes (WSV) stellt diese ungeprüften Rohdaten bereit. Daher wird keine Haftung oder Gewährleistung für die inhaltliche Richtigkeit, Genauigkeit, Aktualität, Zuverlässigkeit oder Vollständigkeit der Daten übernommen. Die Daten sind unter der Lizenz DL-DE->Zero-2.0 ↗ frei verfügbar.

Bei Fragen oder Hinweisen, verwenden Sie bitte das Kontaktformular.

REST- und XML-basierte Webservices

REST-API

Über die REST-API können die Daten in unterschiedlichen Formaten mittels HTTP-URLs abgefragt werden. Diese Schnittstelle eignet sich besonders für mobile Clients oder für JavaScript.

HyDAS-API Beta

Die HyDAS-API ist die Umsetzung des HydroDaten-API-Standards ↗ auf PEGELONLINE. Sie liefert Messstellen, deren Parameter und die zugehörigen Messwerte (Rohdaten) im JSON-Format. Die Schnittstelle befindet sich derzeit in der Beta-Phase und kann sich noch inkompatibel ändern.

Bezug von Ganglinien

Mit Online-Visualisierung Ganglinien können grafische Anzeigen aktueller gewässerkundlicher Zeitreihen (z.B. Wasserstandsdaten einer Messstelle der letzten drei Tage) dynamisch bezogen werden und in eine externe Webseite integriert werden. (Beispiel).

Die Online-Visualisierung Ganglinien kann in statischer Form oder in interaktiver Form verwendet werden.

Aus der interaktiven Online-Visualisierung auf PEGELONLINE ist das Open Source Projekt GIMV ↗ hervorgegangen. Es basiert auf Google Web Toolkit ↗ und erlaubt Entwicklern, interaktive Zeitreihendarstellung in eine browserbasierte Anwendung zu integrieren.

XML-Dokument "Pegelstände"

Aktuelle Informationen zu den Pegelständen in PEGELONLINE kann auch über eine direkt adressierbare URL als XML bezogen werden. Die Zeitpunkte der aktuellen Messwerte liegen hier ganzjährig in mitteleuropäischer Winterzeit vor.

Abruf von Dateien

Über diesen Service können Tagesdateien verschiedener gewässerkundlicher Parameter der letzten 31 Tage bezogen werden.

Nach der Anmeldung auf PEGELONLINE stehen weitere Funktionen zur Verfügung.

Geografische Informationsdienste

Mit PEGELONLINE WMS können gewässerkundliche Informationen als OGC Web Map Service (WMS) in eine Kartenanwendung integriert werden.

Weiterhin sind die Informationen auch mit PEGELONLINE WFS als OGC Web Feature Service (WFS) beziehbar.

Um die PEGELONLINE Kartendarstellung in eine externe Webseite einzubetten, kann eine einbettbare Version mittels eines HTML IFrames ↗ abgerufen werden.

Über eine KML-Datei können aktuelle Pegelstände auch auf einer Google Maps Karte oder in Google Earth eingebettet werden (Prototyp mit drei Pegeln).

Die PEGELONLINE SOS Schnittstelle basiert auf dem OGC Sensor Observation Service Interface Standard 2.0 (SOS 2.0) ↗

Diese Daten werden auch zur Visualisierung im PEGELONLINE Sensorwebclient genutzt.

EDIS Dict-API

Die Dict-API ist ein zentraler Baustein, um die Nutzung der PEGELONLINE-Echtzeitdateninfrastruktur (EDIS) zu unterstützen. Ziel von EDIS ist eine möglichst schnelle und effiziente Auslieferung von Messdaten (weitere Informationen siehe: EDIS ↗ ). Hierzu werden entsprechende Messdatenströme über einen MQTT-Broker angeboten.

Nicht mehr weiterentwickelte Dienste

Der PEGELONLINE SOAP Webservice wird nicht mehr weiterentwickelt und ist keine empfohlene Schnittstelle zu PEGELONLINE mehr. Für neue Integrationen nutzen Sie bitte die REST-API. Bestehende Integrationen werden bis auf Weiteres weiterhin bedient.

Entwurf und Implementierung

Im Auftrag des: