WSV
PEGELONLINE PEGELONLINE Webservices PEGELONLINE

PEGELONLINE Downloads

Freier Download gewässerkundlicher Daten

Über diesen Dienst können Tagesdateien mit Messwerten verschiedener gewässerkundlicher Parameter aus den letzten 31 Tagen bezogen werden.
Die Zeitstempel in den Dateien liegen ganzjährig in mitteleuropäischer Winterzeit vor.

Webadresse: https://www.pegelstaende.de/webservices/files

Abo

Mit einem Abonnement fassen Sie regelmäßig mehrere Rohzeitreihen eines Zeitraumes zusammen und laden sich diese als Datei via HTTPS, manuell oder automatisiert, herunter. Das Abo können Sie sich alternativ auch per Email zustellen lassen. Abo-Dateien werden im proprietären ZRXP-Format oder in einem ASCII-Format erstellt. Es wird empfohlen alle im Abo ausgewählten Zeitreihen in einer Datei zusammenzufassen und zu komprimieren (ZIP). Für diesen Service ist eine Anmeldung nötig. Bitte nutzen Sie dafür das Formular am Ende der Seite. Näheres zur Anmeldung und zu den Abonnements finden Sie hier.

Nach erfolgreicher Anmeldung und erstmaligem Login auf PEGELONLINE zur Änderung des Passworts können Sie diesen Dienst unter folgender Webadresse verwenden: https://www.pegelstaende.de/webservices/nutzer/files

Maschineller Abruf

Alle zur Verfügung gestellten Dateien können auch automatisiert mit HTTP-Clientprogrammen heruntergeladen werden. Als Beispiel wird hier "curl" und "wget" verwendet. curl und wget sind freie Kommandozeilenprogramme zum Herunterladen von Dateien aus dem Internet und dienen im Verbund mit HTTPS dem verschlüsselten Download Ihres Abos von PEGELONLINE.

Curl und Wget gibt es sowohl für Linux als auch für Windows.

Wie allgemein üblich werden Leerzeichen in der URL mit "%20" oder "+" ersetzt. So führt folgender Aufruf zu einem Fehler

curl -O "https://www.pegelstaende.de/webservices/files/Wasserstand Rohdaten/ELBE/70272185-b2b3-4178-96b8-43bea330dcae/Thu Oct 31 00:38:03 CET 2024/down.txt"
Wohingegen folgende Aufrufe beide erfolgreich sind
curl -O "https://www.pegelstaende.de/webservices/files/Wasserstand+Rohdaten/ELBE/70272185-b2b3-4178-96b8-43bea330dcae/Thu Oct 31 00:38:03 CET 2024/down.txt"
curl -O "https://www.pegelstaende.de/webservices/files/Wasserstand%20Rohdaten/ELBE/70272185-b2b3-4178-96b8-43bea330dcae/Thu Oct 31 00:38:03 CET 2024/down.txt"

Die Messstellen werden in der URL mit ihrer UUID referenziert (Im Beispiel handelt es sich um Pegel Dresden). Die UUIDs sind in der Pegeltabelle aufgelistet.

Beispiele für freien Download mittels curl/wget

curl -O "https://www.pegelstaende.de/webservices/files/Wasserstand+Rohdaten/ELBE/70272185-b2b3-4178-96b8-43bea330dcae/Thu Oct 31 00:38:03 CET 2024/down.txt"
wget "https://www.pegelstaende.de/webservices/files/Wasserstand+Rohdaten/ELBE/70272185-b2b3-4178-96b8-43bea330dcae/Thu Oct 31 00:38:03 CET 2024/down.txt"

Download des Abo mit curl/wget und Authentifizierung

Der Download eines Abos mit Autorisierung/Authentifizierung ist ausschließlich über HTTPS möglich.

curl --basic --user "ihr_login:ihr_passwort" -O https://www.pegelstaende.de/webservices/nutzer/files/testdatei.txt

Sollte es Inkompatibilitäten mit dem Zertifikat und Curl bzw. Wget geben, kann man als Workaround die Verifizierung des Zertifikates mittels einer zusätzlichen Option auslassen.

curl --basic --user "ihr_login:ihr_passwort" --insecure -O https://www.pegelstaende.de/webservices/nutzer/files/testdatei.txt
curl --basic --user "ihr_login:ihr_passwort" -k -O https://www.pegelstaende.de/webservices/nutzer/files/testdatei.txt
wget --http-user="ihr_login" --http-password="ihr_passwort" --no-check-certificate "https://www.pegelstaende.de/webservices/nutzer/files/testdatei.txt"

Mit Wget können Sie auch bestimmte Dateitypen von PEGELONLINE herunterladen.
Folgendes Beispiel lädt alle Dateien mit der Erweiterung .dat herunter:

wget -r -nd -A .dat --http-user="ihr_login" --http-password="ihr_passwort" --no-check-certificate "https://www.pegelstaende.de/webservices/nutzer/files"

Haftung und Lizenz

Die Wasserstraßen- und Schifffahrtsverwaltung des Bundes (WSV) stellt ungeprüfte 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.