Zum Hauptinhalt springen

Vigicrues Smart-Home-Integration, kostenlos und Open Source

Vigicrues-Integration für Gladys Assistant

Hochwasserwarnung, Wasserstand und Abfluss der Flüsse nahe deinem Zuhause (Frankreich).

Auf GitHub ansehenAlle externen Integrationen

Bringt die offizielle französische Hochwasserwarnung (Vigicrues) und den Wasserstand und Abfluss der Flüsse in deiner Nähe nach Gladys, aus den offenen Daten von Vigicrues und Hub'Eau. Ohne Konto, ohne Schlüssel.

Das ist eine Ergänzung, kein Sicherheitswarnsystem. Die Daten können verspätet sein, fehlen oder falsch sein, und die Integration hängt von deinem Gladys, deinem Internetzugang und zwei öffentlichen Diensten ab. Folge bei Hochwasser den offiziellen Anweisungen (vigicrues.gouv.fr, Präfektur, Rathaus, 112). Diese Integration ist nicht mit dem französischen Staat (Vigicrues, SCHAPI) verbunden.

Was du bekommst​

  • Ein Gerät pro verfolgter Pegelstation: Wasserstand in Metern, Abfluss in m³/h (oder nach Wahl in m³/s), wenn die Station einen misst, die Hochwasserwarnstufe ihres Flussabschnitts (grün, gelb, orange, rot) und das Datum der letzten Messung.
  • Eine Station, die nichts mehr sendet, wird als solche angezeigt („Keine neue Messung seit…“): Ein alter Wert wird nie erneut gesendet, als wäre er frisch.
  • Zwei Szenen-Auslöser: „Hochwasserwarnung steigt“ (gelb, orange oder rot) und „Hochwasserwarnung sinkt“, gefiltert nach Station, Abschnitt und Farbe.
  • Ein Dashboard-Widget: deine Stationen, ihr Wasserstand, seine Tendenz (steigt, stabil, fällt) und die Warnfarbe.
  • Eine Schaltfläche „Stationen suchen“, die die Stationen rund um dein Haus, in einer Gemeinde oder einem Département mit ihrem Fluss auflistet.

Voraussetzungen​

  • Gladys Assistant 5.2.0 oder neuer.
  • Internetzugang von Gladys aus: Die Integration liest hubeau.eaufrance.fr und www.vigicrues.gouv.fr.
  • Für „Rund um mein Haus“: der Standort deines Hauses in Gladys (Einstellungen, Häuser). Bei mehreren Häusern wählst du deins in der Einstellung Haus. Die Integration fragt bei der Installation danach (Berechtigung „Standort“); er dient nur dazu, die nächsten Stationen zu finden, und wird weder gespeichert noch protokolliert.
  • Für die Warnstufe das französische Festland. Hub'Eau deckt auch die Überseedépartements ab: Die Stationen dort haben Wasserstand und Abfluss, ohne Warnstufe.

Konfiguration​

Einstellungen​

EinstellungWas sie bewirkt
StationscodesCodes durch Kommas getrennt (O200004001, B540001001) oder die Adressen der Stationsseiten auf vigicrues.gouv.fr.
Gemeinden (INSEE-Codes)Alle Stationen in Betrieb dieser Gemeinden: 31555 für Toulouse, 75056 für Paris. Der INSEE-Code ist nicht die Postleitzahl.
HausDas Haus, dessen Standort „Rund um mein Haus“ und „Stationen suchen“ verwenden. Leer: das erste Haus in Gladys mit einem Standort.
Rund um mein HausVerfolgt auch die 3 nächsten Stationen, die Messwerte senden, im Umkreis von 5, 10 oder 20 km um dein Haus.
Aktualisierungsintervall15 (Standard), 20 oder 30 Minuten. Die Warnstufe wird alle 30 Minuten gelesen.
Einheit des Abflussesm³/h (Standard): die Einheit, die Gladys überall anzeigt. m³/s: die Einheit von Vigicrues, in Gladys ohne Einheit (der Name der Funktion nennt sie).
Sprache der FunktionsnamenNamen der Funktionen neuer Geräte und Sprache ihrer Texte (Farbe, letzte Messung). Standardmäßig Französisch.

Aus der Konfiguration kommen höchstens 20 Stationen. Speichere, öffne dann den Tab Entdecken und lege die gewünschten Geräte an. Eine Station, deren Gerät du angelegt hast, bleibt verfolgt, auch wenn du sie aus den Einstellungen entfernst: Lösche das Gerät, um aufzuhören.

Deine Stationen finden​

Die Schaltfläche Stationen suchen der Konfiguration listet die Stationen in Betrieb auf, die nächsten zuerst, mit ihrem Fluss, ihrer Entfernung und ob sie in den letzten Stunden einen Messwert gesendet haben. Gib im Feld „Wo“ ein:

  • nichts: die Stationen rund um das in den Einstellungen gewählte Haus (10 km oder die gewählte Entfernung);
  • einen INSEE-Gemeindecode: 31555;
  • ein Département und einen Namen: 31 Toulouse, 75 Seine, 08 Meuse;
  • einen Stationscode: O200004001.

Kopiere die gewünschten Codes in Stationscodes und speichere. Der Code einer Station ist auch das Ende der Adresse ihrer Seite auf vigicrues.gouv.fr.

Geräte​

Ein Gerät pro Station, benannt wie bei Hub'Eau („La Meuse à Charleville-Mézières“). Seine Funktionen sind schreibgeschützt:

FunktionTyp (Gladys)Wert
WasserstandFlüssigkeitstiefe, in mStand am Pegel, über seinem Nullpunkt: Ein negativer Wert ist bei Niedrigwasser normal. Keine Höhe über dem Meer.
AbflussWasserdurchfluss, in m³/hUmgerechnet aus den m³/s von Vigicrues (1 m³/s = 3.600 m³/h). Mit der Einheit m³/s heißt die Funktion „Abfluss (m³/s)“ und hat keine Einheit: Gladys hat keine für m³/s. Nur wenn die Station einen Abfluss misst.
HochwasserwarnstufeRisikostufeDie Farbe des Abschnitts der Station, als Risiko-Badge von Gladys: 0 grün, 1 gelb, 2 orange, 3 rot. Nur für eine Vigicrues-Station.
WarnfarbeTextGrün, Gelb, Orange oder Rot.
Letzte MessungTextDatum der letzten Messung („29.09., 15:30“) oder „Keine neue Messung seit…“ nach 3 Stunden ohne Messung.

Wasserstand und Abfluss werden nur gesendet, wenn sie sich ändern, sonst einmal alle 12 Stunden. Nach 3 Stunden ohne neue Messung werden sie nicht mehr gesendet, damit Gladys ihr tatsächliches Alter zeigt. Eine Station, die später einen Abfluss misst, bekommt die Funktion: Der Tab „Entdecken“ bietet dann an, das Gerät zu aktualisieren.

Eine andere Einheit des Abflusses ändert die Struktur der Geräte: Der Tab Entdecken bietet für jede Station mit Abfluss „Aktualisieren“ an. Bis du das tust, wird der Abfluss weiter in der Einheit des angelegten Geräts gesendet, damit sich die beiden nie vermischen. Der Name einer Funktion wird beim Anlegen festgelegt: Benenne sie bei Bedarf im Gerät um („Abfluss“ oder „Abfluss (m³/s)“). Der bereits gespeicherte Verlauf behält seine alte Einheit.

Dashboard-Widget​

Füge das Widget Vigicrues zu einem Dashboard hinzu.

  • Ohne Einstellung: eine Zeile pro Station (höchstens 10) mit ihrem Wasserstand und ihrer Tendenz, gefärbt nach der Warnstufe ihres Abschnitts: grün, gelb, rot für Orange und Rot (die Widget-Palette hat kein Orange, die Überschrift nennt die genaue Farbe). Grau: kein Abschnitt oder keine aktuelle Messung.
  • Mit einer gewählten Station: ihre Kacheln für Wasserstand und Abfluss (mit seiner Einheit, m³/h oder m³/s), live, dann ihre Warnstufe mit dem Namen des Abschnitts, ihre Tendenz und ihre letzte Messung.

Das Widget endet mit der Quelle und ihrem Datum sowie einem Link zu Vigicrues.

Szenen-Auslöser​

Hochwasserwarnung steigt: Der Abschnitt einer verfolgten Station wechselt auf Gelb, Orange oder Rot oder auf eine höhere Farbe. Hochwasserwarnung sinkt: Er kehrt zu einer niedrigeren Farbe zurück.

Filter (alle optional): die Station, der Code des Abschnitts (sichtbar in den Parametern des Geräts, VIGICRUES_SECTION, z. B. LO18) und die neue Farbe. Ohne Stationsfilter startet eine Szene einmal pro verfolgter Station des Abschnitts.

Variablen für die Aktionen: station_name, river, section, section_name, color (green, yellow, orange, red), color_name (in der Sprache der Einstellungen), previous_color, previous_color_name.

Die Auslöser feuern nur für Stationen, deren Gerät existiert, nie beim ersten Lesen und nicht nach mehr als einem Tag ohne Warnstufe (Neustart, Vigicrues nicht erreichbar). Ein Schwellenwert des Wasserstands ist eine Szenenbedingung auf der Funktion „Wasserstand“, kein Auslöser.

Szenen-Beispiele​

  • Orange oder Rot in der Nähe: Auslöser „Hochwasserwarnung steigt“, Farbe Orange und Rot → sende die Nachricht „Warnstufe {{color_name}} auf {{section_name}}: sieh auf vigicrues.gouv.fr nach“ und schalte eine Lampe auf Rot.
  • Entwarnung: Auslöser „Hochwasserwarnung sinkt“, Farbe Grün → Nachricht „Wieder grün auf {{section_name}}“.
  • Schwellenwert des Wasserstands: Auslöser „Änderung von Gerätestatus“ auf „Wasserstand“ deiner Station, über 3,5 m → sende eine Nachricht an alle im Haus.
  • Stumme Station: nichts nötig, die Funktion „Letzte Messung“ zeigt es auf dem Dashboard.

Datenquellen, Lizenz und Kontingente​

  • Vigicrues (www.vigicrues.gouv.fr/services): die Warnstufe jedes Abschnitts (InfoVigiCru.geojson, etwa 2,2 MB, mindestens zweimal täglich herausgegeben), alle 30 Minuten gelesen, und die Stationen jedes Abschnitts (einmal pro Woche gelesen). © VIGICRUES.
  • Hub'Eau Hydrométrie (hubeau.eaufrance.fr/api/v2/hydrometrie): die Stationen und ihre Echtzeit-Messwerte, alle 5 Minuten aus der nationalen hydrometrischen Plattform aktualisiert, einen Monat lang aufbewahrt. Eine Anfrage pro Aktualisierung für alle deine Stationen.
  • Beide stehen unter der Licence Ouverte / Open Licence Etalab 2.0: freie Weiterverwendung mit Angabe der Quelle und ihres Datums – das Widget zeigt beides.
  • Keiner der beiden Dienste veröffentlicht ein Kontingent. Die Integration bleibt sparsam: eine Hub'Eau-Anfrage pro Aktualisierung (höchstens alle 15 Minuten), die Warnstufe alle 30 Minuten, das Verzeichnis einmal pro Woche, und sie nennt sich in ihren Anfragen. Hub'Eau kann missbräuchliche Nutzung ablehnen: Verkürze diese Abstände nicht.

Fehlerbehebung​

  • „Unbekannter Stationscode“: Hub'Eau kennt diesen Code nicht. Prüfe ihn mit „Stationen suchen“ oder auf vigicrues.gouv.fr (das Ende der Adresse der Stationsseite).
  • Keine Warnstufen-Funktion: Die Station liegt nicht auf einem Vigicrues-Abschnitt (viele kleine Flüsse werden nur gemessen), oder Vigicrues hat beim Veröffentlichen des Geräts nicht geantwortet: Die Integration versucht es jede Stunde erneut, dann bietet der Tab „Entdecken“ an, das Gerät zu aktualisieren.
  • Keine Abfluss-Funktion: Die Station misst nur den Wasserstand (zum Beispiel Charleville-Mézières).
  • „Keine neue Messung seit…“: Die Station sendet nichts mehr (Wartung, Ausfall, Hochwasserschaden). Hub'Eau bewahrt einen Monat auf: danach „Seit über einem Monat keine Messung“.
  • „Hub'Eau antwortet nicht“ oder „Vigicrues antwortet nicht“ in der Konfiguration: Der Dienst ist ausgefallen oder Gladys hat keinen Internetzugang. Die Werte kommen von selbst zurück.
  • „Rund um mein Haus“ bewirkt nichts: Gib deinem Haus in Gladys einen Standort (Einstellungen, Häuser); der Konfigurationsbildschirm weist darauf hin. Hast du in der Einstellung Haus ein Haus gewählt, zählt dessen Standort: Der Konfigurationsbildschirm nennt es, wenn es keinen Standort hat oder nicht mehr existiert (wähle ein anderes oder leere das Feld).
  • Protokolle: standardmäßig ruhig (Start, Station stumm oder zurück, Wechsel der Warnstufe, Ausfälle nur einmal). LOG_LEVEL=debug zeigt jede Aktualisierung.

Grenzen​

  • Kein Sicherheitswarnsystem: nur eine Ergänzung, ohne Garantie für Verzögerung oder Verfügbarkeit. Die offiziellen Anweisungen haben Vorrang.
  • Die Warnstufe deckt nur das französische Festland ab; die Überseedienste von Vigicrues werden nicht gelesen.
  • Die Wasserstände sind Pegelstände über dem Nullpunkt jeder Station: Man kann sie weder zwischen Stationen noch mit einer Höhe über dem Meer vergleichen.
  • Echtzeit-Messwerte sind roh und nicht validiert: Ausreißer kommen vor.
  • Manche Stationen senden einmal pro Stunde, mit bis zu etwa 75 Minuten Verzögerung.
  • Die Vorhersagen von Vigicrues werden nicht gelesen.
  • Getestet mit echten Antworten von Hub'Eau und Vigicrues, aufgezeichnet im September und Oktober 2026, noch nicht auf einem echten Gladys: Rückmeldungen willkommen.
  • Nicht mit dem französischen Staat (Vigicrues, SCHAPI) oder Hub'Eau verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt Vigicrues in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine StationensectionNeinVerfolge die Pegelstationen deiner Flüsse: per Code, per Gemeinde oder die nächsten zu deinem Haus. „Stationen suchen“ unten listet sie mit ihrem Fluss auf. Speichere und lege dann die Geräte im Tab „Entdecken“ an.
Quellen und GrenzensectionNeinDaten © Vigicrues und Hub'Eau (Licence Ouverte Etalab 2.0), ohne Konto gelesen. Eine Ergänzung, kein Sicherheitswarnsystem: Die offiziellen Anweisungen haben Vorrang. Nicht mit Vigicrues verbunden.
StationscodesstringNeinCodes durch Kommas getrennt, oder die Adressen ihrer Vigicrues-Seiten.
Gemeinden (INSEE-Codes)stringNeinAlle Stationen in Betrieb dieser Gemeinden, z. B. 31555 für Toulouse, 75056 für Paris.
HausselectNeinDas Haus, dessen Standort „Rund um mein Haus“ und „Stationen suchen“ verwenden. Leer: das erste Haus in Gladys mit einem Standort.
Rund um mein HausselectNeinVerfolge auch die 3 nächsten Stationen, die Messwerte senden, höchstens so weit vom Standort deines Hauses in Gladys entfernt.
AktualisierungsintervallselectNeinDie Stationen senden alle 5 bis 60 Minuten einen Messwert. Die Warnstufe wird alle 30 Minuten gelesen.
Einheit des AbflussesselectNeinm³/h: die Einheit, die Gladys überall anzeigt. m³/s: die Einheit von Vigicrues, ohne Einheit angezeigt (der Name der Funktion nennt sie). Nach einer Änderung: die Geräte im Tab „Entdecken“ aktualisieren.
Sprache der FunktionsnamenselectNeinNamen der Funktionen neuer Geräte (Wasserstand, Abfluss…) und Sprache ihrer Texte (Farbe, letzte Messung).

So installierst du Vigicrues in Gladys​

  1. Öffne in Gladys Integrationen: Vigicrues 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-vigicrues:1.1.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-vigicrues.

Vigicrues benötigt Gladys >=5.2.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​

Vigicrues 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.

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 🙂
Zuletzt aktualisiert am