Zum Hauptinhalt springen

US Wildfires Smart-Home-Integration, kostenlos und Open Source

US Wildfires-Integration für Gladys Assistant

Aktive Waldbrände nahe deinem Zuhause in den USA, vom NIFC: Entfernung, Fläche, Eindämmung.

Auf GitHub ansehenAlle Integrationen

Verfolge in Gladys die aktiven Waldbrände rund um dein Zuhause in den USA, mit den offiziellen Daten des National Interagency Fire Center (NIFC): die Einsätze und die kartierten Brandumrisse von WFIGS (Wildland Fire Interagency Geospatial Services), gemeinfrei, alle paar Minuten aktualisiert. Ohne Konto und ohne API-Schlüssel.

Für jeden Brand in deinem Radius: sein Name, seine Entfernung (zum Rand seines kartierten Umrisses, wenn es einen gibt), seine Fläche, seine Eindämmung, sein County und sein Bundesstaat.

Dies ist kein offizieller Warndienst: Im Notfall befolge die Anweisungen deiner örtlichen Behörden, die Notfallwarnungen deines Countys und die Evakuierungsanordnungen. Nicht mit dem NIFC verbunden, auch nicht mit dem US Forest Service oder einer anderen Behörde.

Was du bekommst​

  • Ein Gerät Brände um das Haus: Anzahl der Brände im Radius, Entfernung des nächsten Brandes, der nächste Brand ausgeschrieben und die verbrannte Gesamtfläche, mit ihrem Verlauf.
  • Ein Dashboard-Widget, das die Brände nach Entfernung auflistet, mit Fläche und Eindämmung.
  • Drei Szenenauslöser: ein neuer Brand im Radius, ein Brand nähert sich (innerhalb der Warnentfernung), ein Brand zu 100 % eingedämmt.
  • Eine Szenenaktion, die die Brände in der Nähe als einen Satz liest, zum Senden per Nachricht oder zum Vorlesen.

Voraussetzungen​

  • Gladys Assistant 5.3 oder neuer.
  • Internetzugang vom Gladys-Rechner (die Integration liest services3.arcgis.com, den ArcGIS-Dienst des NIFC).
  • Ein Standort für dein Haus in Gladys (Einstellungen → Häuser) oder in der Konfiguration eingetragene Koordinaten. Die Daten decken nur die USA (und Puerto Rico) ab.

Konfiguration​

Einstellungen​

EinstellungWirkung
Breiten- und Längengrad des MittelpunktsMittelpunkt des Gebiets. Leer lassen, um den Standort deines Hauses zu verwenden. Dezimalkomma wird akzeptiert.
Radius10, 25, 50 (Standard), 100 oder 150 Meilen.
Warnentfernung1 bis 25 Meilen (Standard 10): Der Auslöser „Brand nähert sich“ löst aus, wenn ein Brand so nah kommt.
Kontrolliertes Abbrennen einbeziehenAuch die von Landverwaltern geplanten Brände („RX“) verfolgen. Standardmäßig aus.
Vollständig eingedämmte Brände ignorierenBrände mit 100 % Eindämmung ausblenden, die bis zur Löschmeldung gelistet bleiben. Standardmäßig aus.
EinheitenMeilen und Acres (Standard) oder Kilometer und Hektar.
Aktualisierungsintervall10, 15 (Standard), 30 oder 60 Minuten.
Sprache der TexteNamen der Funktionen (bei ihrer Erstellung) und Texte für die Szenen. Standardmäßig Französisch.

Speichere, öffne dann den Tab Entdecken der Integration und lege das Gerät Brände um das Haus an. Die Schaltfläche Aktuelle Brände anzeigen der Konfiguration listet sofort die Brände in der Nähe auf: ein schneller Weg, die Einstellungen zu prüfen.

Die verfolgten Brände​

Ein Brand wird verfolgt, wenn das NIFC ihn als aktiv listet, es ein Waldbrand ist (oder ein kontrolliertes Abbrennen, falls gewählt) und seine Entfernung im Radius liegt. Die Entfernung wird zum Rand seines kartierten Umrisses gemessen, wenn das NIFC einen hat (0, wenn dein Haus darin liegt), sonst zu seinem Ausgangspunkt. Große Brände sind über ihren Umriss oft viel näher als über ihren Punkt: Der Brand Hagen der Testaufnahme ist über seinen Punkt 25 Meilen entfernt, über seinen Umriss 21.

Datenschutz: Der an das NIFC gesendete Standort wird auf 0,1° gerundet (etwa 11 km), mit entsprechend erweitertem Radius; die genaue Entfernung wird im Container berechnet. Der Standort des Hauses wird nie in die Protokolle oder nach /data geschrieben.

Gerät​

FunktionTypWert
Brände im RadiusZählerAnzahl der verfolgten Brände
Entfernung des nächsten BrandesEntfernung (mi, km)Entfernung zum nächsten Brand; 1 000 ohne Brand, damit eine Bedingung „unter 10“ falsch bleibt
Nächster BrandTextz. B. North Cayuse · 24 km · 1.978 ha · zu 97 % eingedämmt · Umatilla, OR
Verbrannte GesamtflächeFläche (km²)Fläche der verfolgten Brände. Gladys kennt keine Acres: 1 km² sind 247 Acres

Die Einheit der Entfernung ist die der Einstellung Einheiten beim Anlegen des Geräts; danach bleibt sie gleich (lösche das Gerät und lege es neu an, um sie zu ändern). Wenn das NIFC nicht antwortet, wird nichts veröffentlicht: Die letzten Werte bleiben, und der Konfigurationsbildschirm meldet es. Die Werte werden im Container in jedem Intervall gelesen: Gladys fragt das Gerät nicht ab.

Dashboard-Widget​

Brände in der Nähe: eine Überschrift mit der Anzahl der Brände, dann bis zu 8 Brände, der nächste zuerst. Jede Zeile zeigt Name, Entfernung, Fläche und County, und die Eindämmung als Abzeichen (grün bei 100 %). Tippe auf eine Zeile, um Entdeckungsdatum, Ursache, NIFC-Kennung und eine Karte des Brandorts zu sehen. Die Entfernungen folgen den Einheiten deines Gladys-Kontos. Die Fußzeile nennt die Quelle und die Zeit der letzten Abfrage; die Schaltfläche InciWeb (Einsatzmeldungen) lässt sich in den Einstellungen des Widgets ausblenden.

Szenenauslöser​

US-Waldbrände: neuer Brand im Radius löst aus, wenn ein bisher unbekannter Brand in den Radius kommt. Filter: Einsatztypen (Waldbrand, kontrolliertes Abbrennen).

US-Waldbrände: Brand nähert sich löst aus, wenn ein Brand näher als die Warnentfernung der Konfiguration kommt, neue Brände eingeschlossen. Filter: Einsatztypen.

US-Waldbrände: Brand zu 100 % eingedämmt löst aus, wenn ein verfolgter Brand 100 % Eindämmung erreicht.

Jeder Auslöser löst einmal pro Brand aus: Ein Umriss, der mal diesseits, mal jenseits der Warnentfernung neu gezeichnet wird, löst nicht erneut aus. Die beim allerersten Start oder bei einer Änderung der Konfiguration bereits gelisteten Brände lösen nichts aus: Das ist keine Neuigkeit. Was gesehen wurde, wird unter /data gespeichert: Ein Neustart löst für bereits gesehene Brände nichts aus. Höchstens 20 Ereignisse pro Aktualisierung.

Variablen der drei Auslöser: name, incident_type (wildfire, prescribed), distance und distance_unit (mi oder km), area und area_unit (acres oder ha), containment (Prozent, leer, wenn das NIFC sie nicht angibt), state (CA, OR…), county, cause (Human, Natural, Undetermined, wie veröffentlicht) und summary (eine Zeile, wie die Funktion Nächster Brand).

Szenenaktion​

US-Waldbrände: Brände in der Nähe lesen liest das NIFC erneut, wenn die letzte Abfrage älter als ein Intervall ist, und liefert dann:

  • text: die Brände in einem Satz, z. B. 5 Brände im Umkreis von 80 km: North Cayuse, 24 km entfernt; Hagen, 33 km entfernt; … (höchstens 5 Brände, dann „und N weitere“);
  • count: die Anzahl der Brände.

Szenenbeispiele​

  • Nachricht, wenn ein Brand näher kommt: Auslöser „US-Waldbrände: Brand nähert sich“, Aktion „Nachricht senden“ mit {{triggerEvent.data.summary}}.
  • Morgenbericht in der Brandsaison: jeden Tag um 7:30 „US-Waldbrände: Brände in der Nähe lesen“, dann „Nachricht senden“ mit ihrem text, nur wenn count größer als 0 ist.
  • Fenster schließen und Lüftung stoppen: Wenn „Entfernung des nächsten Brandes“ unter 10 fällt, die Lüftungsanlage ausschalten und eine Erinnerung zum Schließen der Fenster senden (Rauch).
  • Gute Nachricht: Bei „US-Waldbrände: Brand zu 100 % eingedämmt“ \{\{triggerEvent.data.name\}\} ist eingedämmt senden.

Datenquellen, Bedingungen und Kontingente​

  • Daten: NIFC, WFIGS-Ebenen „Incident Locations Current“ und „Interagency Perimeters Current“, gemeinfrei, ohne Konto aus den offenen Daten des NIFC gelesen. Die Einsätze stammen aus IRWIN, dem gemeinsamen System der Feuerwehrbehörden von Bund, Bundesstaaten und Kommunen.
  • Die Daten werden von den Behörden erfasst, manchmal verspätet: Ein neuer Brand kann mit Verzögerung erscheinen, Fläche und Eindämmung sind die zuletzt gemeldeten, kleine Brände haben oft keinen Umriss, und ein Brand bleibt „aktiv“, bis er für gelöscht erklärt wird. Diese Daten ersetzen nie die Warnungen und Evakuierungsanordnungen deiner örtlichen Behörden. Siehe Ready.gov, um dich vorzubereiten.
  • Kontingente: Das NIFC veröffentlicht keine für diese öffentlichen Ebenen. Die Integration stellt zwei Anfragen pro Intervall (Standard 15 Minuten), nur für das Gebiet um dein Haus, mit vereinfachten Umrissen (Genauigkeit etwa 200 m): einige zehn Kilobyte pro Zyklus.

Fehlerbehebung​

  • „Kein Mittelpunkt“ in der Konfiguration: Gib deinem Haus in Gladys einen Standort (Einstellungen → Häuser) oder trage Koordinaten ein.
  • „NIFC antwortet nicht“: Der ArcGIS-Dienst ist ausgefallen oder vom Gladys-Rechner nicht erreichbar. Die letzten Werte bleiben; die Integration versucht es in jedem Intervall erneut und meldet es einmal in ihren Protokollen.
  • Gar kein Brand: Prüfe, ob der Mittelpunkt in den USA liegt, und vergrößere den Radius; außerhalb der Brandsaison gibt es vielleicht einfach keinen.
  • Zu viele kleine, unwichtige Brände: Schalte „Vollständig eingedämmte Brände ignorieren“ ein und lass das kontrollierte Abbrennen aus.
  • Kein Auslöser nach einer Änderung der Einstellungen: erwartet, die schon vorhandenen Brände sind keine Neuigkeit.
  • Namen der Funktionen in der falschen Sprache oder Entfernung in der falschen Einheit: Beides wird beim Anlegen des Geräts festgelegt. Ändere die Einstellung, lösche das Gerät und lege es dann im Tab „Entdecken“ neu an.
  • Protokolle: Seite der Integration in Gladys, Tab Protokolle. LOG_LEVEL=debug gibt eine Zeile pro Abfrage aus.

Grenzen​

  • Nur USA und Puerto Rico: WFIGS deckt weder Kanada noch Mexiko ab.
  • Die Entfernung wird zum kartierten Umriss gemessen, der einen Tag oder älter sein kann; zwischen zwei Kartierungen kann ein schneller Brand näher sein als angezeigt. Kleine Brände haben nur einen Punkt.
  • Fläche, Eindämmung und Ursache sind die von den Behörden gemeldeten und können der Lage vor Ort hinterherhinken.
  • Das NIFC veröffentlicht die InciWeb-Seite eines Einsatzes nicht: Das Widget verlinkt die Startseite von InciWeb.
  • Gegen den echten NIFC-Dienst getestet (Aufnahme vom 7. November 2026 um Pendleton, Oregon), nicht bei einem echten Brand nahe einem Gladys-Haus: Rückmeldungen sind im Forum willkommen.

Konfigurationseinstellungen​

Diese Einstellungen fragt US Wildfires in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Dein GebietsectionNeinDie Waldbrände des National Interagency Fire Center in einem Radius um dein Haus (oder um Koordinaten). Speichere und lege dann das Gerät im Tab „Entdecken“ an.
Quellen und GrenzensectionNeinDaten: NIFC WFIGS, gemeinfrei, ohne Konto gelesen. Kein offizieller Warndienst: Befolge deine örtlichen Behörden und Notfallwarnungen. Nicht mit dem NIFC verbunden.
Breitengrad des MittelpunktsstringNeinLass beide Koordinaten leer, um den Standort deines Hauses in Gladys zu verwenden.
Längengrad des MittelpunktsstringNeinDezimalgrad, in den USA negativ (Westen).
RadiusselectNeinBrände, deren Umriss (oder Position, wenn kein Umriss kartiert ist) innerhalb dieser Entfernung liegt.
WarnentfernungselectNeinDer Szenenauslöser „Brand nähert sich“ löst aus, wenn ein Brand näher als diese Entfernung kommt.
Kontrolliertes Abbrennen einbeziehenbooleanNeinGeplante Brände der Landverwalter („RX“). Im Herbst mehr als die Hälfte der Einsätze.
Vollständig eingedämmte Brände ignorierenbooleanNeinEin Brand bleibt nach 100 % Eindämmung wochenlang gelistet, bis er für gelöscht erklärt wird.
EinheitenselectNeinDer Texte und der Entfernung (beim Anlegen des Geräts festgelegt). Die Fläche ist in km².
AktualisierungsintervallselectNeinDas NIFC aktualisiert die Einsätze alle paar Minuten, die Umrisse bei jeder neuen Kartierung.
Sprache der TexteselectNeinNamen der Funktionen (bei ihrer Erstellung) und Texte für die Szenen.

So installierst du US Wildfires in Gladys​

  1. Öffne in Gladys Integrationen: US Wildfires 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-wildfires-us: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-wildfires-us.

US Wildfires 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​

US Wildfires 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