Hochwasserportal Smart-Home-Integration, kostenlos und Open Source

Wasserstände, Abflüsse und Hochwasser-Meldestufen der Landespegel (Hochwasserportal).

• Veröffentlicht von guim31
• Geräte
• Version 1.0.0
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Bringt die Wasserstände, Abflüsse und Hochwasser-Meldestufen der Landespegel in Gladys: die kleineren Flüsse, die die Hochwasserzentralen der Länder beobachten (Isar, Neckar, Lahn, Ruhr, Mulde…), mit ihren amtlichen Meldestufen 1 bis 4. Die Daten stammen von den Landesportalen, die im Länderübergreifenden Hochwasserportal (LHP, hochwasserzentralen.de) zusammengeschlossen sind. Kein Konto, kein Schlüssel.

Unterstützte Länder: Bayern, Baden-Württemberg, Sachsen, Nordrhein-Westfalen, Hessen und Rheinland-Pfalz (rund 2.100 Pegel, davon 900 mit Meldestufen).

Kein Warndienst. Die Daten können verspätet, lückenhaft oder falsch sein, und die Integration hängt von deinem Gladys, deinem Internetzugang und öffentlichen Diensten ab. Bei Hochwasser gelten die amtlichen Warnungen (die Hochwasserzentrale deines Landes, deine Gemeinde, 112). Diese Integration ist nicht mit den Hochwasserzentralen der Länder verbunden.

Unterschied zur Integration PEGELONLINE: PEGELONLINE deckt die Bundeswasserstraßen ab (Rhein, Elbe, Donau, Kanäle) mit ihren Mittel- und Schifffahrtswasserständen; diese hier die Landespegel mit den Meldestufen, die die Länder veröffentlichen. Beide können nebeneinander laufen.

Was du bekommst

• Ein Gerät pro verfolgtem Pegel: der Wasserstand (in cm wie im Landesportal; in m über NN bei Seen und Talsperren), der Abfluss in m³/s, wenn der Pegel ihn misst, die Hochwasser-Meldestufe von 0 (kein Hochwasser) bis 4, wenn das Land den Pegel einstuft, die Tendenz (steigt, gleichbleibend, fällt) und das Datum der letzten Messung.
• Ein Pegel, der nichts mehr sendet, wird als solcher angezeigt („Keine neue Messung seit…“): Ein alter Wert wird nie so gesendet, als wäre er frisch.
• Vier Szenen-Auslöser: Die Meldestufe steigt, die Meldestufe sinkt, ein Pegel sendet keine Messwerte mehr, und sendet wieder.
• Ein Dashboard-Widget: deine Pegel, ihr Wasserstand und seine Tendenz, eingefärbt nach ihrer Meldestufe.
• Eine Schaltfläche „Stationen suchen“, die die Pegel rund um dein Haus, nach Name, nach Gewässer oder nach ID mit ihrem aktuellen Wasserstand auflistet.

Voraussetzungen

• Gladys Assistant 5.1.0 oder neuer.
• Internetzugang von Gladys aus: Die Integration liest die Landesportale (www.hnd.bayern.de, www.hvz.baden-wuerttemberg.de, www.umwelt.sachsen.de, www.hochwasserportal.nrw, www.hlnug.de, hochwasser.rlp.de) und die LHP-Karte (www.hochwasserzentralen.de) für die Koordinaten.
• Für „Rund um mein Haus“: der Standort deines Hauses in Gladys (Einstellungen, Häuser). Die Integration fragt bei der Installation danach (Berechtigung „Standort“). Er dient nur im Container dazu, die nächsten Pegel zu finden: Er wird nie an ein Portal gesendet, nie gespeichert und nie protokolliert.

Konfiguration

Einstellungen

• Stationen: Stations-IDs, Pegelnummern oder Namen, durch Kommas getrennt. Die ID besteht aus dem Länderkürzel, einem Unterstrich und der Pegelnummer: BY_16005701 (München, Isar). Es ist die ID der Home-Assistant-Integration „hochwasserportal“: Eine Liste aus Home Assistant kannst du unverändert einfügen. Ein Name kann sein Gewässer tragen: Plochingen Neckar, Marburg / Lahn; Groß- und Kleinschreibung, Akzente und Umlaute spielen keine Rolle (Muenchen findet München).
• Rund um mein Haus: Verfolge auch die 3 nächsten Pegel, die Messwerte senden, im Umkreis von 10, 20 oder 50 km. Es zählen nur Pegel mit bekannten Koordinaten: alle in Baden-Württemberg, Nordrhein-Westfalen und Hessen, die Hochwassermeldepegel der LHP-Karte in Bayern, Sachsen und Rheinland-Pfalz.
• Aktualisierungsintervall: 15 (Standard), 20 oder 30 Minuten. Die meisten Pegel senden alle 15 Minuten einen Messwert.
• Sprache der Funktionsnamen: Namen der Funktionen neuer Geräte (standardmäßig Französisch) und Sprache der Texte (Tendenz, letzte Messung) und der Szenenvariablen.

Speichere, öffne dann den Tab Entdecken und lege die gewünschten Geräte an.

Deine Stationen finden

Die Schaltfläche Stationen suchen der Konfiguration listet bis zu 10 Pegel mit ID, Gewässer, Entfernung zu deinem Haus und aktuellem Wasserstand auf:

• leer: die Pegel rund um dein Haus (20 km oder die gewählte Entfernung);
• ein Name oder ein Gewässer: München, Isar, Neckar Plochingen;
• ein Land: BY_, SN_…;
• eine ID oder eine Nummer: BY_16005701, 16005701.

Kopiere die IDs in Stationen und speichere. Du kannst einen Pegel auch im Portal seines Landes finden (siehe „Datenquellen“) und seine Nummer aus der Adresse seiner Seite übernehmen.

Geräte

Jedes Gerät heißt „Station / Gewässer“ (München / Isar), Modell „Hochwasserportal · Bayern“. Seine Funktionen, sofern der Pegel sie hat:

Funktion	Typ in Gladys	Wert
Wasserstand	Füllhöhe (cm, m)	wie im Landesportal
Abfluss (m³/s)	Wasserdurchfluss	m³/s (Gladys hat keine Einheit m³/s)
Hochwasser-Meldestufe (0 bis 4)	Risikostufe	0 kein Hochwasser, 1 bis 4 die Meldestufe
Tendenz	Text	Steigt, Gleichbleibend, Fällt (etwa 1 Std.)
Letzte Messung	Text	Datum oder „Keine neue Messung seit…“

Die Meldestufe ist die des Landes: Meldestufe in Bayern, Baden-Württemberg, Hessen und Rheinland-Pfalz, Alarmstufe in Sachsen, Informationsstufe in Nordrhein-Westfalen (dort und in Hessen 3 Stufen). Bayern und Sachsen veröffentlichen die Stufe selbst; für die anderen Länder wird sie aus den amtlichen Schwellenwerten berechnet, die das Land veröffentlicht, wie es die Home-Assistant-Integration tut. Ein Pegel ohne Meldestufen hat diese Funktion nicht.

Ein eigener Schwellenwert („die Lahn über 300 cm“) ist eine eingebaute Szenenbedingung von Gladys auf der Funktion Wasserstand: Dafür braucht es keinen Auslöser der Integration.

Dashboard-Widget

Füge das Widget Hochwasserportal zu einem Dashboard hinzu.

• Ohne Einstellung: eine Zeile pro Pegel (höchstens 10), Wasserstand und Tendenz, eingefärbt nach Meldestufe (grün 0, orange 1 und 2, rot 3 und 4, grau ohne Stufe oder ohne aktuelle Messung). Eine Überschrift nennt die Pegel mit Warnung.
• Mit einer gewählten Station: ihr Live-Wasserstand und -Abfluss, ihre Meldestufe, Tendenz und letzte Messung sowie eine Schaltfläche zu ihrer Seite im Landesportal.

Szenen-Auslöser

• Meldestufe erreicht oder erhöht: Die Meldestufe eines Pegels steigt. Filter nach Station und neuer Stufe (1 bis 4).
• Meldestufe gesunken: Die Meldestufe sinkt. Filter nach Station und neuer Stufe (0 bis 3).
• Pegel sendet keine Messwerte mehr: seit 6 Stunden keine neue Messung (Ausfall, Wartung, vom Hochwasser beschädigter Pegel…).
• Pegel sendet wieder Messwerte.

Variablen: Name der Station, Gewässer, Bundesland, neue und vorherige Stufe (Zahl und ausgeschrieben), Wasserstand und seine Einheit, Abfluss; das Datum der letzten Messung bei den letzten beiden.

Szenen-Beispiele

• Hochwasser an der Isar: Auslöser „Meldestufe erreicht oder erhöht“, Station München / Isar, Stufe 2, 3 oder 4 → Nachricht „{{triggerEvent.data.station_name}}: {{triggerEvent.data.level_name}}, {{triggerEvent.data.height}} cm“ senden und eine Lampe rot einschalten.
• Entwarnung: Auslöser „Meldestufe gesunken“, Stufe 0 → Nachricht „Wieder normal in {{triggerEvent.data.station_name}}“.
• Dein eigener Schwellenwert: Gladys-Auslöser „eine Gerätefunktion ändert sich“, Wasserstand von Marburg / Lahn über 350 → Kellerpumpe einschalten, benachrichtigen.
• Stiller Pegel bei Hochwasser: Auslöser „Pegel sendet keine Messwerte mehr“ → Nachricht „Keine Daten von {{triggerEvent.data.station_name}} seit {{triggerEvent.data.last_reading}}“.

Datenquellen, Lizenz und Kontingente

• Bayern: Hochwassernachrichtendienst Bayern (Bayerisches Landesamt für Umwelt), www.hnd.bayern.de, eine Seite für alle Pegel.
• Baden-Württemberg: Hochwasservorhersagezentrale (LUBW), www.hvz.baden-wuerttemberg.de, eine Datei für alle Pegel.
• Sachsen: Landeshochwasserzentrum (LfULG), www.umwelt.sachsen.de, eine Seite für alle Pegel.
• Nordrhein-Westfalen: Hochwasserportal NRW (LANUK), eine Datei pro Pegel.
• Hessen: HLNUG, eine Datei pro Pegel und Parameter, die Schwellenwerte einmal am Tag.
• Rheinland-Pfalz: Hochwassermeldedienst (LfU), hochwasser.rlp.de, eine Anfrage pro Pegel.
• Koordinaten: die Karte des Länderübergreifenden Hochwasserportals, einmal pro Woche.

Die Daten sind öffentlich und werden ohne Konto gelesen; die Integration fragt höchstens alle 15 Minuten, nennt sich in ihren Anfragen (User-Agent) und hält die Stationslisten eine Woche im Speicher. Die Portale veröffentlichen keine API-Nutzungsbedingungen: Bitte verkürze das Intervall nicht. Dank: Das Auslesen folgt der Python-Bibliothek lhpapi (Apache 2.0) der Home-Assistant-Integration „hochwasserportal“.

Fehlerbehebung

• „Unbekannte Station“: Prüfe die ID mit „Stationen suchen“. Andere Länder als die sechs oben werden noch nicht unterstützt.
• „Das Portal von … antwortet nicht“: Dieses Landesportal ist ausgefallen oder hat sich geändert; die anderen Länder laufen weiter. Die Messwerte kommen mit ihm zurück. Wenn es anhält, eröffne ein Issue: Die Portale sind Webseiten, und ihr Format kann sich ändern.
• Keine Meldestufe bei einem Pegel: Das Land stuft diesen Pegel nicht ein (kein Hochwassermeldepegel).
• „Keine neue Messung seit…“: Der Pegel sendet nichts (Ausfall, Wartung, Eis). Manche Pegel liefern ihre Werte gebündelt, einige Stunden verspätet.
• „Rund um mein Haus“ fügt nichts hinzu: kein Pegel mit bekannten Koordinaten in dieser Entfernung; wähle eine größere Entfernung oder gib die Stationen ein.
• Protokolle: LOG_LEVEL=debug zeigt jeden Aktualisierungszyklus.

Grenzen

• Sechs von sechzehn Ländern: Berlin, Brandenburg, Bremen, Hamburg, Mecklenburg-Vorpommern, Niedersachsen, Saarland, Sachsen-Anhalt, Schleswig-Holstein und Thüringen werden noch nicht unterstützt (siehe README).
• Die Portale von Bayern und Sachsen sind Webseiten, die als solche gelesen werden: Eine Änderung ihres Aufbaus stoppt ihre Messwerte, bis die Integration aktualisiert ist.
• Kein Abfluss in Nordrhein-Westfalen (nicht als Datei veröffentlicht), keine Vorhersage.
• Die Tendenz braucht nach dem Start etwa eine Stunde Messwerte.
• Höchstens 20 Stationen aus der Konfiguration.

Konfigurationseinstellungen

Diese Einstellungen fragt Hochwasserportal in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Deine Stationen	section	Nein	Verfolge Pegel in Bayern, Baden-Württemberg, Sachsen, Nordrhein-Westfalen, Hessen und Rheinland-Pfalz: per ID, Nummer oder Name, oder die nächsten zu deinem Haus. „Stationen suchen“ listet sie auf. Speichere und lege dann die Geräte im Tab „Entdecken“ an.
Quellen und Grenzen	section	Nein	Daten: Hochwasserzentralen der Länder (HND Bayern, HVZ Baden-Württemberg, LHWZ Sachsen, LANUK NRW, HLNUG, LfU Rheinland-Pfalz), vereint im Länderübergreifenden Hochwasserportal. Kein Warndienst: Die amtlichen Warnungen haben Vorrang. Nicht mit diesen Behörden verbunden.
Stationen	string	Nein	Stations-IDs (BY_16005701), Pegelnummern oder Stationsnamen, durch Kommas getrennt.
Rund um mein Haus	select	Nein	Verfolge auch die 3 nächsten Pegel, die Messwerte senden, höchstens so weit vom Standort deines Hauses in Gladys entfernt. Nur Pegel mit bekannten Koordinaten (die meisten Hochwassermeldepegel).
Aktualisierungsintervall	select	Nein	Die Pegel senden alle 15 Minuten einen Messwert, manche stündlich.
Sprache der Funktionsnamen	select	Nein	Namen der Funktionen neuer Geräte (Wasserstand, Abfluss…) und Sprache ihrer Texte und der Szenenvariablen.

So installierst du Hochwasserportal in Gladys

1. Öffne in Gladys Integrationen: Hochwasserportal erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-lhp:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-lhp.

Hochwasserportal benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

Hochwasserportal ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂