Environment Agency Flood Smart-Home-Integration, kostenlos und Open Source

Pegelstände und Hochwasserwarnungen in England, von der Environment Agency.

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

Auf GitHub ansehenAlle Integrationen

Bringt die Wasserstände der Flüsse, der Küste und des Grundwassers in England (rund 4.000 Stationen: Themse, Severn, Trent, die Küste…) und die aktiven Hochwasserwarnungen rund um dein Haus nach Gladys, aus der Echtzeit-API zur Hochwasserüberwachung der Environment Agency. Ohne Konto, ohne Schlüssel.

Das ist kein Hochwasserwarndienst. Die Daten können verspätet, lückenhaft oder falsch sein, und die Integration hängt von deinem Gladys, deinem Internetzugang und einem öffentlichen Dienst ab. Bei Hochwasser folge den amtlichen Warnungen: Melde dich für die kostenlosen Warnungen der Environment Agency an, sieh auf Check for flooding nach oder ruf Floodline unter 0345 988 1188 an; wähle 999 bei Lebensgefahr. Diese Integration ist nicht mit der Environment Agency verbunden.

Was du bekommst

• Ein Gerät pro verfolgter Station: den Wasserstand in Metern, seine Lage im Vergleich zum üblichen Bereich der Station (niedrig, normal, hoch), den höchsten Stand der letzten Jahre, den Abfluss in m³/s, wenn die Station ihn misst, und das Datum der letzten Messung.
• Ein Gerät „Hochwasserwarnungen“ für die Umgebung deines Hauses: die Stufe der schwersten aktiven Warnung (keine, Vorwarnung, Warnung, schwere Warnung), die Zahl der aktiven Warnungen und die letzte davon als Text.
• Eine Station, die nichts mehr sendet, wird so angezeigt („Keine neue Messung seit…“): Ein alter Wert wird nie wieder als frisch gesendet.
• Vier Szenenauslöser: Eine Hochwasserwarnung wird ausgegeben oder verschärft, eine Hochwasserwarnung wird aufgehoben, die Lage einer Station ändert sich (niedrig, normal, hoch), ein Referenzstand wird überschritten (üblicher Bereich, höchster Stand der letzten Jahre, Rekord).
• Ein Dashboard-Widget: die aktiven Warnungen rund um dein Haus, dann deine Stationen, ihr Stand, seine Tendenz (steigt, gleichbleibend, fällt) und ihre Lage.
• Eine Schaltfläche „Stationen suchen“, die die Stationen rund um dein Haus, nach Name, Gewässer oder Ort oder nach Kennung mit ihrem aktuellen Stand auflistet.

Voraussetzungen

• Gladys Assistant 5.1.0 oder neuer.
• Internetzugang für Gladys: Die Integration liest environment.data.gov.uk.
• Für die Hochwasserwarnungen und „Stationen rund um mein Haus“: der Standort deines Hauses in Gladys (Einstellungen, Häuser). Die Integration fragt ihn bei der Installation an (Berechtigung „Standort“). Er wird nur im Container verwendet, um die nächsten Stationen und Gebiete zu wählen: nie an die Environment Agency gesendet, nie gespeichert oder protokolliert.
• Nur England: Wales, Schottland und Nordirland haben eigene Dienste.

Konfiguration

Einstellungen

Einstellung	Wirkung
Stationen	Stationskennungen oder -namen, durch Kommas getrennt: 3400TH, Bewdley, E71539. Die Adresse einer Stationsseite von „Check for flooding“ funktioniert auch.
Stationen rund um mein Haus	Verfolgt auch die 3 nächsten Stationen, die Messwerte senden, im Umkreis von 10, 20 oder 50 km um dein Haus.
Hochwasserwarnungen rund um mein Haus	Legt das Gerät „Hochwasserwarnungen“ an, für die Gebiete, deren Mitte höchstens 5, 10 (Standard), 20 oder 50 km von deinem Haus entfernt ist. „Nein“ entfernt es aus der Suche.
Aktualisierungsintervall	15, 20 oder 30 Minuten. Eine Anfrage deckt alle Stationen ab, eine die Warnungen.
Sprache der Funktionsnamen	Namen der Funktionen neuer Geräte (Wasserstand, Abfluss…) und Sprache der Texte („Letzte Messung“, „Letzte Warnung“) und der Szenenvariablen.

Speichere, öffne dann den Tab Entdecken der Integration und lege die gewünschten Geräte an. Eine verfolgte Station bleibt verfolgt, solange ihr Gerät existiert, auch wenn du sie aus der Konfiguration entfernst.

Deine Stationen finden

Klicke in der Konfiguration auf „Stationen suchen“. Lass das Feld leer, um die Stationen rund um dein Haus aufzulisten (10 km oder die gewählte Entfernung), oder gib ein:

• einen Stationsnamen: Kingston, Bewdley (Groß- und Kleinschreibung und Akzente werden ignoriert);
• ein Gewässer oder einen Ort: Severn, Shrewsbury (die 10 nächsten oder die ersten 10 nach Gewässer);
• beides: Thames Windsor;
• eine Stationskennung: 3400TH oder die Adresse ihrer Seite bei „Check for flooding“.

Jede Zeile nennt Kennung, Name, Gewässer und Ort, die Entfernung zu deinem Haus und den aktuellen Stand oder „keine aktuelle Messung“. Kopiere die Kennungen in „Stationen“ und speichere.

Geräte

Stationen

Funktion	Typ in Gladys	Wert
Wasserstand	Flüssigkeitstiefe (m)	Der Stand der Station in Metern (siehe unten).
Wasserstandslage (üblicher Bereich)	Flüssigkeitsstand	Niedrig unter dem üblichen Bereich der Station, Hoch darüber, Normal dazwischen.
Höchster Stand der letzten Jahre	Flüssigkeitstiefe (m)	Der höchste Stand der letzten Jahre, ein Bezugswert für den Verlauf.
Abfluss (m³/s)	Wasserdurchfluss	In m³/s (Gladys kennt keine Einheit m³/s: Der Name sagt es), wenn die Station ihn misst.
Letzte Messung	Text	Datum der letzten Messung oder „Keine neue Messung seit…“.

Eine Funktion gibt es nur, wenn die Station sie liefert. Der Wasserstand ist keine Tiefe: Bei einem Fluss ist es der Pegelstand über dem Nullpunkt der Station (mASD), bei Gezeiten- und Grundwasserstationen eine Höhe über dem Meeresspiegel (mAOD, Ordnance Datum): Der Parameter LEVEL_DATUM des Geräts sagt, welche. Vergleiche ihn mit dem üblichen Bereich derselben Station (auf ihrer Seite bei „Check for flooding“), nicht mit einer anderen Station. Die Geräteparameter enthalten die Stationskennung, ihre RLOI-Nummer (die Nummer ihrer Seite bei „Check for flooding“), ihr Gewässer und ihren Ort.

Wasserstand und Abfluss sind numerische Funktionen: Gladys-Szenen können sie schon mit jedem eigenen Wert vergleichen („Wasserstand über 4,8 m“).

Hochwasserwarnungen

Funktion	Typ in Gladys	Wert
Hochwasser-Warnstufe	Risikostufe	0 keine, 1 Vorwarnung, 2 Warnung, 3 schwere Warnung: die schwerste aktive.
Aktive Warnungen	Zähler	Die aktiven Vorwarnungen und Warnungen rund um dein Haus.
Letzte Warnung	Text	„Hochwasserwarnung: Lyme Brook at Newcastle under Lyme (23.10., 13:41)“ oder keine aktive.

Die Environment Agency kennt drei Stufen: flood alert, hier „Vorwarnung“ (Hochwasser ist möglich, sei vorbereitet), flood warning, „Warnung“ (Hochwasser wird erwartet, handle jetzt) und severe flood warning, „schwere Warnung“ (Lebensgefahr). Eine Warnung gilt „rund um dein Haus“, wenn die Mitte ihres Gebiets in der gewählten Entfernung liegt: Ein großes Gebiet kann dein Haus abdecken, obwohl seine Mitte weiter weg ist; wähle im Zweifel 20 km.

Dashboard-Widget

Füge das Widget Hochwasser England einem Dashboard hinzu.

• Ohne Einstellung: eine Überschrift mit der schwersten aktiven Warnung, eine Zeile pro Warnung rund um dein Haus (höchstens 4, oder „Keine aktiv“), dann eine Zeile pro verfolgter Station mit Stand und Tendenz, gefärbt nach ihrer Lage: blau niedrig, grün normal, rot hoch, grau ohne üblichen Bereich oder ohne aktuelle Messung.
• Mit gewählter Station: ihr Stand und Abfluss live, dann Lage, höchster Stand der letzten Jahre, Tendenz und letzte Messung sowie ein Link zu ihrer Seite bei „Check for flooding“.
• Mit gewählten Hochwasserwarnungen: alle aktiven Warnungen rund um dein Haus.

Szenenauslöser

Auslöser	Filter	Variablen
Hochwasserwarnung ausgegeben oder verschärft	Stufe (severe, warning, alert)	Stufe und vorherige Stufe (Kürzel und Text), Kennung und Name des Gebiets, Gewässer oder Meer, Grafschaft, Nachricht, ausgegeben am
Hochwasserwarnung aufgehoben	Stufe, die sie hatte	Stufe (Kürzel und Text), Kennung und Name des Gebiets, Gewässer oder Meer, Grafschaft
Wasserstandslage ändert sich	Station, neue Lage (low, normal, high)	Name der Station, Gewässer, Wasserstand, Lage, vorherige Lage (Kürzel und Text)
Referenzstand überschritten	Station, Stand, Richtung (rising, falling)	Name der Station, Gewässer, Wasserstand, Kürzel und Name des Stands, seine Höhe, Richtung

„Ausgegeben oder verschärft“ löst bei einer neuen Warnung rund um dein Haus aus und bei einer Warnung, die schwerer wird (aus einer Vorwarnung wird eine Warnung). „Aufgehoben“ löst aus, wenn eine Warnung nicht mehr gilt oder zwei Abfragen nacheinander im Datenstrom fehlt (ein Aussetzer hebt nichts auf); eine geänderte Entfernung löst nichts aus. Die angebotenen Referenzstände sind Unter- und Obergrenze des üblichen Bereichs, der höchste Stand der letzten Jahre und der höchste gemessene Stand; eine Station löst nur die aus, die sie hat. Das Fallen zählt, sobald der Stand 2 cm unter dem Referenzstand liegt, und erst danach kann ein neues Steigen zählen: Ein Stand, der darum pendelt, löst einmal aus.

Die Auslöser feuern nur für ein Gerät, das du angelegt hast (die Station oder „Hochwasserwarnungen“), bei frischen Daten und nicht nach einem Neustart von mehr als einem Tag. Die erste Abfrage nach der Installation löst nichts aus: Die schon aktiven Warnungen zeigen das Gerät und das Widget.

Szenenbeispiele

• Hochwasserwarnung zu Hause: „Hochwasserwarnung ausgegeben oder verschärft“, Stufen warning und severe → Nachricht „{{severity_name}}: {{area_name}}. {{message}}“ senden, das Licht im Flur einschalten und die Steckdosen im Keller ausschalten.
• Entwarnung: „Hochwasserwarnung aufgehoben“ → Nachricht „Aufgehoben: {{area_name}}“.
• Der Fluss steigt: „Wasserstandslage ändert sich“, deine Station, neue Lage Hoch → der Familie Bescheid geben, das Auto umzuparken.
• Neuer Höchststand: „Referenzstand überschritten“, Stand „Höchster Stand der letzten Jahre“, steigt darüber → Nachricht „{{station_name}}: {{height}} m, über dem {{mark_name}}“.

Datenquellen, Lizenz und Kontingente

• Daten: Environment Agency, Echtzeit-API zur Hochwasserüberwachung, Lizenz Open Government Licence v3.0 („Contains public sector information licensed under the Open Government Licence v3.0“; das Widget nennt die Quelle).
• Die Messwerte sind nahezu in Echtzeit und ungeprüft: Die Environment Agency kann sie später korrigieren. Die Stationen senden alle 15 Minuten, manche seltener; die Warnungen werden alle 15 Minuten aktualisiert.
• Kein Konto, kein Schlüssel, kein dokumentiertes Kontingent. Die Integration bleibt sparsam: eine Anfrage pro Aktualisierung für die letzten Messwerte aller verfolgten Stationen und eine für die aktiven Warnungen in England (standardmäßig 15 Minuten, nie schneller), die Details jeder Station einmal am Tag, die Stationsliste (rund 4 MB) und die Liste der Gebiete (rund 3 MB) einmal pro Woche und nur bei Bedarf.

Fehlerbehebung

• „Unbekannte Station“: Prüfe die Schreibweise oder nutze „Stationen suchen“ und kopiere dann die Kennung.
• „Die Environment Agency antwortet nicht“: Der Dienst oder dein Internetzugang ist gestört; die Werte kommen von selbst zurück.
• „Rund um mein Haus“ fügt nichts hinzu, oder kein Gerät „Hochwasserwarnungen“: Gib deinem Haus einen Standort (Einstellungen, Häuser) oder wähle eine größere Entfernung.
• Keine Funktion für die Lage: Die Station hat keinen üblichen Bereich. Gezeitenstationen haben hier nie einen: Die Gezeiten durchqueren ihn zweimal am Tag.
• „Keine neue Messung seit…“: Die Station sendet verspätet oder gar nicht; manche senden ihre Werte gebündelt, einige Stunden später.
• Eine Warnung, die ich bekomme, fehlt: Die Mitte ihres Gebiets liegt weiter weg als die gewählte Entfernung: Wähle eine größere.
• Protokolle: in Gladys die Protokolle der Integration; LOG_LEVEL=debug zeigt jeden Zyklus.

Grenzen

• Keine Hardware nötig; gegen den echten Dienst und gegen aufgezeichnete Antworten getestet, aber noch nicht in einer echten Gladys-Installation: Rückmeldungen willkommen.
• Nur England und nur, was die Environment Agency veröffentlicht: keine Vorhersagen, keine Warnungen zu Oberflächenwasser oder Grundwasser anderer Stellen.
• Die Entfernung einer Warnung wird zur Mitte ihres Gebiets gemessen, nicht zu seinem Rand.
• Höchstens 20 Stationen aus der Konfiguration (plus die, deren Gerät du angelegt hast).
• Die Funktionsnamen werden beim Anlegen des Geräts festgelegt: Eine spätere Änderung der Sprache ändert nur die danach gesendeten Texte.

Konfigurationseinstellungen

Diese Einstellungen fragt Environment Agency Flood in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Deine Stationen und Hochwasserwarnungen	section	Nein	Verfolge die Wasserstände der Stationen der Environment Agency in England, per Kennung, Name oder nahe deinem Haus, und die Hochwasserwarnungen rund um dein Haus. „Stationen suchen“ listet sie auf. Speichere und lege dann die Geräte im Tab „Entdecken“ an.
Quellen und Grenzen	section	Nein	Daten: Echtzeit-API der Environment Agency zur Hochwasserüberwachung, Open Government Licence v3.0, ohne Konto gelesen. Nur England. Kein Hochwasserwarndienst: Verlass dich auf die amtlichen Warnungen (Floodline 0345 988 1188). Nicht mit der Environment Agency verbunden.
Stationen	string	Nein	Stationskennungen oder -namen, durch Kommas getrennt.
Stationen rund um mein Haus	select	Nein	Verfolge auch die 3 nächsten Stationen, die Messwerte senden, höchstens so weit vom Standort deines Hauses in Gladys entfernt.
Hochwasserwarnungen rund um mein Haus	select	Nein	Ein Gerät „Hochwasserwarnungen“ verfolgt die Warnungen, deren Gebietsmitte höchstens so weit von deinem Haus entfernt ist.
Aktualisierungsintervall	select	Nein	Die Stationen senden alle 15 Minuten einen Messwert, die Warnungen werden alle 15 Minuten aktualisiert. Eine einzige Anfrage deckt alle Stationen ab.
Sprache der Funktionsnamen	select	Nein	Namen der Funktionen neuer Geräte (Wasserstand, Abfluss…) und Sprache ihrer Texte und der Szenenvariablen.

So installierst du Environment Agency Flood in Gladys

1. Öffne in Gladys Integrationen: Environment Agency Flood 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-ea-flood: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-ea-flood.

Environment Agency Flood 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

Environment Agency Flood 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 🙂