Avalanche bulletins Smart-Home-Integration, kostenlos und Open Source
Lawinengefahr pro Massiv oder Zone: Météo-France (BERA) in Frankreich, Lawinenzentren in den USA.
Veröffentlicht von guim31
- Geräte
- Version 1.1.0
- Erfordert Gladys >=5.3.0
- ★ 0
Der Lawinenlagebericht (BERA) von Météo-France in Gladys, für die 35 französischen Massive der Alpen, der Pyrenäen und Korsikas: ein Gerät pro Massiv, mit Gefahrenstufe von 1 bis 5, Tendenz für den Folgetag, gefährlichsten Expositionen und Schneehöhe. Dazu Szenenauslöser und ein Dashboard-Widget.
Lies vor jeder Tour den ganzen Bericht. Diese Integration zeigt eine Zusammenfassung und ersetzt weder den Bericht noch den Text des Vorhersagers noch deine eigene Beurteilung im Gelände.
Nicht mit Météo-France verbunden.
Neu in 1.1: die Lawinenzentren der USA. Siehe US-Lawinenzentren.
Was du bekommst
- Ein Gerät pro gewähltem Massiv: Mont-Blanc, Belledonne, Aspe-Ossau, Cinto-Rotondo…
- Die Gefahrenstufe des Berichtstags (europäische Skala, 1 Gering bis 5 Sehr groß) und die Tendenz für den Folgetag.
- Die Stufe unter und über der Höhengrenze und diese Höhe (0, wenn der Bericht eine Stufe für das ganze Massiv angibt).
- Die gefährlichsten Expositionen, das Erstellungsdatum und das Ende der Gültigkeit.
- Die Schneehöhe auf der Nord- und Südseite auf der höchsten Höhe der Tabelle des Berichts (2000 m in den Voralpen, auf Korsika und im Baskenland, sonst 2500 m).
- Bericht gültig: 1, solange ein Bericht die aktuelle Zeit abdeckt, sonst 0 (außerhalb der Saison).
- Zwei Szenenauslöser und ein Dashboard-Widget.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- Internetzugang für Gladys. Kein Konto und kein Schlüssel: Die Berichte stammen aus dem offenen Archiv von Météo-France auf data.gouv.fr.
- Météo-France gibt die Berichte von Anfang November bis Anfang Juni heraus, meist gegen 16 Uhr für den Folgetag. Außerhalb der Saison zeigen die Geräte „kein gültiger Bericht“, ohne Fehler.
Konfiguration
Einstellungen
| Einstellung | Standard | Wirkung |
|---|---|---|
| Massive und Zonen | keines | Die zu verfolgenden Massive (Frankreich) und Zonen (USA), je ein Gerät. |
| API-Schlüssel von Météo-France | leer | Optional: liest die Berichte über die DPBRA-API statt über das Archiv. |
| Sprache der Funktionsnamen | Französisch | Namen der Funktionen neuer Geräte, Sprache ihrer Texte und Variablen. |
Speichere, öffne dann den Tab Entdecken der Integration und lege die gewünschten Geräte an.
Optional: der API-Schlüssel von Météo-France
Das offene Archiv genügt normalerweise. Hinkt es hinterher (der Bericht des Tages erscheint abends nicht), lege ein kostenloses Konto im API-Portal von Météo-France an, abonniere die API „Bulletin d'estimation du risque d'avalanche“ (DPBRA), erzeuge einen API-Schlüssel und füge ihn in die Konfiguration ein. Die Integration fragt dann direkt bei Météo-France, eine Anfrage pro Massiv alle 30 Minuten. Dieser Weg wurde nach der API-Dokumentation entwickelt, ohne Schlüssel: Rückmeldungen willkommen. Den Link zum PDF des Berichts gibt es nur mit dem Archiv.
US-Lawinenzentren
Die Vorhersagezonen der US-Lawinenzentren (83 Zonen in 12 Bundesstaaten: Alaska, Utah, Washington, Montana, Wyoming, Idaho, Kalifornien…) stehen in derselben Liste, nach den französischen Massiven, als „Bundesstaat · Zentrum · Zone“, zum Beispiel „Utah · UAC · Salt Lake“. Jede wird ein Gerät mit der Gefahrenstufe des Tages und des Folgetags (die nordamerikanische Skala hat dieselben fünf Stufen), den gefährlichsten Expositionen, dem Erstellungsdatum, dem Ende der Gültigkeit und „Bericht gültig“. Ein Zentrum gibt weder Höhengrenze noch Schneehöhe an: Diese Funktionen fehlen, nie 0. Das Widget zeigt die Stufen unter, an und über der Waldgrenze, die „Bottom Line“ des Zentrums (auf Englisch) und eine Schaltfläche zur offiziellen Vorhersage der Zone auf der Website des Zentrums. Die Szenenauslöser funktionieren genauso.
- Die US-Zentren veröffentlichen nur in ihrer Saison (etwa von November bis April, jedes Zentrum mit eigenen Daten). Außerhalb der Saison oder an einem Tag ohne Gefahrenstufe zeigt das Gerät nur „kein gültiger Bericht“, und das Widget verweist auf die Vorhersage des Zentrums.
- Nicht angeboten: das Colorado Avalanche Information Center (CAIC), dessen Zonen während der Saison neu gezeichnet werden und keinen festen Namen haben.
- Die Vorhersagen kommen aus der öffentlichen API von avalanche.org, ohne Konto, eine Anfrage pro Zone alle 30 Minuten. Nicht mit avalanche.org oder den Zentren verbunden.
Geräte
| Funktion | Typ | Wert |
|---|---|---|
| Lawinengefahr (1-5) | Zahl | Höchste Stufe des Berichtstags |
| Tendenz der Gefahr, Folgetag | Zahl | Vorhergesagte Stufe für den nächsten Tag |
| Gefahr unter der Höhengrenze | Zahl | Stufe unter der Höhengrenze (oder ganzes Massiv) |
| Gefahr über der Höhengrenze | Zahl | Stufe über der Höhengrenze (oder ganzes Massiv) |
| Höhengrenze | Meter | 0 ohne Höhengrenze |
| Gefährlichste Expositionen | Text | „N, NO, NW“, „Alle Expositionen“ oder „Keine Exposition genannt“ |
| Bericht erstellt am | Text | Datum und Uhrzeit der Erstellung |
| Gültig bis | Text | Ende der Gültigkeit (18 Uhr am Folgetag) |
| Schnee Nord- / Südseite | Zentimeter | Schneehöhe auf 2000 oder 2500 m je nach Massiv |
| Bericht gültig | an / aus | 1, solange der Bericht gilt |
Die Stufen sind Zahlen (nicht das „Risiko“-Abzeichen von Gladys, das nur vier Stufen kennt): Eine Szenenbedingung wie „Gefahr ≥ 4“ funktioniert. Ohne gültigen Bericht wird nur „Bericht gültig“ aktualisiert: Die anderen Werte werden nicht erfunden und altern einfach.
Dashboard-Widget
Lawinengefahr: ohne gewähltes Massiv eine Zeile pro verfolgtem Massiv (höchstens 10) mit seiner Stufe wie auf dem offiziellen Piktogramm („4 · Groß“) und der Tendenz für den Folgetag, grün (1), gelb (2) oder rot (ab 3). Mit gewähltem Massiv: die Kacheln der Gefahr und des Folgetags, die Stufen unter und über der Höhengrenze, die Expositionen, die Schneehöhe, die Gültigkeit, der Kommentar des Vorhersagers und eine Schaltfläche zum PDF des Berichts. Kommentar und Schaltfläche lassen sich jeweils per Einstellung ausblenden.
Szenenauslöser
- Lawinengefahr erreicht eine Stufe: Ein neuer Bericht hebt die Gefahr eines Massivs auf die gewählte Stufe (2 bis 5) oder höher. Er löst einmal aus, wenn die Stufe nach oben überschritten wird: Von 2 auf 4 lösen „erreicht 3“ und „erreicht 4“ beide aus. Variablen: Massiv, Stufe, Name der Stufe, Ende der Gültigkeit.
- Neuer Lawinenbericht: Météo-France gibt einen neuen Bericht für ein Massiv heraus. Variablen: Massiv, Stufe, Name der Stufe, Tendenz Folgetag, Ende der Gültigkeit, Zusammenfassung des Berichts (auf Französisch, wie von Météo-France geschrieben), Link zum PDF.
Der allererste nach der Installation gelesene Bericht setzt nur die Referenz: Er löst nichts aus.
Szenenbeispiele
- Um 18 Uhr, wenn die Gefahr in deinem Massiv 4 oder mehr beträgt, eine Nachricht „Lawinengefahr {{level}} morgen“ senden.
- Bei jedem neuen Bericht seine Zusammenfassung und den Link zum PDF an die Familiengruppe senden.
Datenquellen, Lizenz und Kontingente
- Berichte © Météo-France, Archiv der Lawinenberichte auf data.gouv.fr, Licence Ouverte 2.0. Alle 30 Minuten gelesen: eine kleine Indexdatei, und der Bericht eines Massivs nur, wenn ein neuer erscheint.
- Optionale DPBRA-API von Météo-France: eine Anfrage pro Massiv alle 30 Minuten, weit unter den 50 Anfragen pro Minute des Portals.
- US-Vorhersagen: öffentliche API von avalanche.org (National Avalanche Center und US-Lawinenzentren), eine Anfrage pro Zone alle 30 Minuten.
Fehlerbehebung
- „Kein gültiger Bericht“ in der Saison am Abend: Das Archiv kann hinterherhinken; warte den nächsten Zyklus ab (30 Minuten) oder trage einen API-Schlüssel ein (siehe oben).
- „Météo-France lehnt den API-Schlüssel ab“: Prüfe den Schlüssel in der Konfiguration oder leere ihn, um das Archiv zu nutzen.
- Der Verbindungsstatus meldet, dass die Berichte nicht lesbar sind: data.gouv.fr oder Météo-France ist nicht erreichbar. Die letzten Werte bleiben erhalten, die Integration versucht es alle 30 Minuten erneut.
Grenzen
- Außerhalb der Saison entwickelt: Die Berichte der Saison 2025-2026 dienten für die Tests, aber die Verzögerung des Archivs mitten in der Saison ist noch nicht gemessen. Rückmeldungen willkommen.
- Nur eine Zusammenfassung des Berichts: Die Texte zur Schneedecke, zum Wetter und zur Schneequalität bleiben im PDF.
- Andorra ist nicht abgedeckt: Météo-France veröffentlicht dafür keinen Bericht.
- US-Zonen: ganz am Anfang der Saison entwickelt, mit wenigen bewerteten Zonen; gegen die echte API getestet, aber Rückmeldungen sind willkommen. Eine ohne neues Erstellungsdatum korrigierte Vorhersage wird erst mit der nächsten gelesen.
Konfigurationseinstellungen
Diese Einstellungen fragt Avalanche bulletins in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine Massive und Zonen | section | Nein | Wähle die Massive (Frankreich) oder Vorhersagezonen (USA) aus: je ein Gerät, mit Gefahrenstufe (1 bis 5), Tendenz für den Folgetag und gefährlichsten Expositionen, in Frankreich auch die Schneehöhe. Speichere und lege dann die Geräte im Tab „Entdecken“ an. |
| Quellen und Grenzen | section | Nein | Frankreich: Berichte © Météo-France (Licence Ouverte 2.0), Anfang November bis Anfang Juni. USA: Vorhersagen der Lawinenzentren über avalanche.org, nur in der Saison. Eine Zusammenfassung, kein Sicherheitswerkzeug: Lies den ganzen Bericht. Nicht mit ihnen verbunden. |
| Massive und Zonen | multi_select | Nein | Ein Gerät pro gewähltem Massiv oder gewählter Zone. Die US-Zonen folgen den französischen Massiven, nach Bundesstaat. |
| API-Schlüssel von Météo-France (optional) | secret | Nein | Leer lassen: Das offene Archiv von data.gouv.fr genügt. Hinkt es hinterher, liest ein kostenloser Schlüssel des API-Portals von Météo-France (DPBRA-API) die Berichte direkt bei Météo-France. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen neuer Geräte (Lawinengefahr, Gültig bis…) und Sprache ihrer Texte (Expositionen, Daten, Szenenvariablen). |
So installierst du Avalanche bulletins in Gladys
- Öffne in Gladys Integrationen: Avalanche bulletins erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-avalanche:1.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-avalanche.
Avalanche bulletins benötigt Gladys >=5.3.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
Avalanche bulletins 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