Zum Hauptinhalt springen

USGS Volcanoes Smart-Home-Integration, kostenlos und Open Source

USGS Volcanoes-Integration für Gladys Assistant

Warnstufen der US-Vulkane (Hawaii, Alaska, Kaskaden, Yellowstone…) vom USGS

Verfolge in Gladys die Warnstufen der Vulkane der Vereinigten Staaten: Hawaii, Alaska, die Kaskaden, Kalifornien, Yellowstone, die Nördlichen Marianen und Amerikanisch-Samoa. Die fünf Vulkanobservatorien des USGS (United States Geological Survey) bewerten jeden überwachten Vulkan zweifach:

  • die Vulkan-Warnstufe für die Menschen am Boden: Normal, Hinweis (Advisory), Beobachtung (Watch), Warnung (Warning);
  • den Luftfahrt-Farbcode für die Flugzeuge: Grün, Gelb, Orange, Rot.

Die Integration liest sie aus HANS, dem öffentlichen Meldesystem des USGS. Kein Konto, kein API-Schlüssel.

Dies ist eine Ergänzung, kein Sicherheitswarnsystem: Folge im Notfall den offiziellen Meldungen und den Anweisungen der örtlichen Behörden. Nicht mit dem USGS verbunden.

Was du bekommst​

  • Ein Gerät pro verfolgtem Vulkan: Warnstufe, Luftfahrt-Farbcode und die neueste USGS-Meldung (Art, Datum und, bei den aktivsten Vulkanen, eine einzeilige Zusammenfassung), mit ihrem Verlauf.
  • Ein Gerät Vulkane in der Nähe: die höchste Warnstufe der überwachten Vulkane in einem Umkreis um dein Haus, die Zahl der Vulkane über normal und der betroffene Vulkan.
  • Ein Dashboard-Widget, das deine Vulkane auflistet, die aktivsten zuerst, jeweils mit Meldung und USGS-Seite.
  • Ein Szenen-Auslöser, wenn sich die Warnstufe oder der Farbcode eines verfolgten oder nahen Vulkans ändert.
  • Eine Szenen-Aktion, die die Stufen als einen Satz liest, per Nachricht zu senden oder vorzulesen.

Voraussetzungen​

  • Gladys Assistant 5.3 oder neuer.
  • Internetzugang vom Gladys-Rechner (die Integration liest volcanoes.usgs.gov).
  • Für die Vulkane in der Nähe: ein Standort für dein Haus in Gladys (Einstellungen → Häuser) oder in der Konfiguration eingetragene Koordinaten.

Konfiguration​

Installiere die Integration aus dem Store (oder Integrationen → Von GitHub installieren, mit der Adresse https://github.com/guim31/gladys-usgs-volcanoes) und öffne dann ihren Reiter Konfiguration.

Einstellungen​

EinstellungStandardWirkung
Verfolgte VulkaneleerNamen, Vulkannummern oder Observatoriumscodes, durch Kommas getrennt
Vulkane in der Nähe: Radius200 kmAus, 50, 100, 200, 500 oder 1.000 km um den Mittelpunkt
Breitengrad des MittelpunktsleerLass beide Koordinaten leer, um den Standort deines Hauses zu verwenden
Längengrad des MittelpunktsleerDezimalgrad, Westen negativ (-121.7603)
Aktualisierungsintervall15 Minuten10, 15, 30 oder 60 Minuten
Sprache der TexteFranzösischNamen der Geräte und Funktionen (bei der Erstellung) und Texte der Szenen

Speichere und öffne dann den Reiter Entdeckung: ein Gerät pro verfolgtem Vulkan, dazu Vulkane in der Nähe, wenn ein Radius gewählt ist. Füge die gewünschten zu Gladys hinzu.

Vulkane wählen​

Trage die Namen so ein, wie der USGS sie schreibt, durch Kommas getrennt. Groß- und Kleinschreibung, Akzente und „Mount“/„Mt“ spielen keine Rolle: kilauea, Kīlauea, St. Helens und mt rainier funktionieren, ebenso ein Teil eines einzigen Namens (shasta). Ein Teil, den mehrere Vulkane teilen (sitkin: Great Sitkin und Little Sitkin), ist mehrdeutig und wird ignoriert. Du kannst auch die Smithsonian-Vulkannummer (332010) oder einen Observatoriumscode eintragen, um alle seine Vulkane zu verfolgen. Der Reiter Konfiguration listet die nicht gefundenen Namen auf.

Die überwachten Vulkane am 12.11.2026, nach Observatorium:

  • avo, Alaska Volcano Observatory: Akutan, Aniakchak, Atka volcanic complex, Augustine, Cleveland, Dutton, Edgecumbe, Fisher, Gareloi, Great Sitkin, Griggs, Iliamna, Isanotski, Kanaga, Katmai, Korovin, Little Sitkin, Mageik, Makushin, Martin, Novarupta, Okmok, Pavlof, Redoubt, Semisopochnoi, Shishaldin, Snowy Mountain, Spurr, Takawangha, Tanaga, Trident, Ugashik-Peulik, Ukinrek Maars, Veniaminof, Westdahl, Wrangell.
  • calvo, California Volcano Observatory: Clear Lake Volcanic Field, Coso Volcanic Field, Lassen Volcanic Center, Long Valley Caldera, Mammoth Mountain, Medicine Lake volcano, Mono Lake Volcanic Field, Mono-Inyo Craters, Mount Shasta, Salton Buttes, Ubehebe Craters.
  • cvo, Cascades Volcano Observatory: Crater Lake, Glacier Peak, Mount Adams, Mount Baker, Mount Hood, Mount Jefferson, Mount Rainier, Mount St. Helens, Newberry, Three Sisters.
  • hvo, Hawaiian Volcano Observatory: Haleakala, Hualalai, Kilauea, Mauna Kea, Mauna Loa und in Amerikanisch-Samoa Ofu-Olosega, Ta'u Island, Tutuila Island.
  • nmi, Nördliche Marianen: Ahyi Seamount.
  • yvo, Yellowstone Volcano Observatory: Yellowstone.

Die anderen US-Vulkane haben keine Warnstufe (keine Echtzeitüberwachung) und lassen sich nicht verfolgen.

Geräte​

Jeder verfolgte Vulkan ist ein Gerät mit seinem Namen („Vulkan Kilauea“):

FunktionWerte
Vulkan-Warnstufe0 Normal, 1 Hinweis, 2 Beobachtung, 3 Warnung (Risikostufe)
Luftfahrt-Farbcode0 Grün, 1 Gelb, 2 Orange, 3 Rot (Risikostufe)
Neueste USGS-Meldung„Tägliche Meldung, 11.11.2026: …“ — Art, Datum, Text

Vulkane in der Nähe fasst die überwachten Vulkane im Umkreis zusammen:

FunktionWerte
Höchste Warnstufe0 bis 3, wie oben
Vulkane über normalZahl der Vulkane über Normal oder Grün
Aktivster Vulkan„Mount Rainier: Beobachtung / Orange, 94 km entfernt“

Die Warnstufen haben einen Zahlenwert: Eine Szenenbedingung „Warnstufe größer oder gleich 2“ reagiert auf Beobachtung und Warnung, die Fälle, in denen der USGS einen Ausbruch für wahrscheinlich oder im Gange hält. Der Verlauf der Warnstufen-Funktion gibt das Datum jeder Änderung.

Dashboard-Widget​

Füge das Widget USGS-Vulkane zu einem Dashboard hinzu: die Zahl der Vulkane über normal, dann deine verfolgten Vulkane und die nahen über normal (höchstens 8), die aktivsten zuerst. Jede Zeile zeigt den Luftfahrt-Farbcode, das Observatorium und die Entfernung; tippe darauf für die neueste Meldung, ihre Zusammenfassung, das Datum der letzten Stufenänderung (sobald die Integration eine gesehen hat) und die Links zur Meldung und zur Vulkanseite.

Zwei Einstellungen: Nur Vulkane über normal blendet die ruhigen aus, Link zu USGS HANS zeigt oder verbirgt die Schaltfläche unten.

Szenen-Auslöser​

USGS-Vulkan: Warnstufe geändert löst aus, wenn sich die Warnstufe oder der Luftfahrt-Farbcode eines verfolgten Vulkans oder eines Vulkans im Umkreis ändert. Filter, alle optional: die neue Warnstufe, die neue Luftfahrtfarbe und die Richtung (erhöht oder gesenkt).

Variablen: alert_level, aviation_color und direction (feste englische Wörter), volcano, vnum, observatory, alert_level_name und aviation_color_name (in der Sprache der Konfiguration), previous_alert_level, previous_aviation_color, distance_km (leer ohne Mittelpunkt), summary („Kilauea: Beobachtung / Orange, 4.317 km entfernt“) und notice_url.

Die beim ersten Start schon vorhandenen Stufen lösen nichts aus, ebenso wenig ein Vulkan, den du neu verfolgst: Nur die von der Integration gesehenen Änderungen zählen. Die letzten Stufen bleiben gespeichert: Eine Änderung, während die Integration gestoppt ist, löst beim nächsten Start aus, sonst nichts.

Szenen-Aktion​

USGS-Vulkane: Stufen lesen liest HANS bei Bedarf neu und gibt zurück:

  • text: einen Satz, zum Beispiel „1 Vulkan über normal: Kilauea: Hinweis / Gelb; Mount Rainier: Normal / Grün, 94 km entfernt.“ (höchstens 5 Vulkane, dann „und N weitere“);
  • max_level: none, normal, advisory, watch oder warning;
  • elevated_count: die Zahl der Vulkane über normal.

Die Schaltfläche Aktuelle Stufen anzeigen im Reiter Konfiguration gibt denselben Satz.

Szenen-Beispiele​

  • Eine Nachricht bekommen, wenn ein naher Vulkan auf Beobachtung oder Warnung steigt: Auslöser „USGS-Vulkan: Warnstufe geändert“, Filter „Beobachtung, Warnung“ und „Erhöht“, dann summary und notice_url senden.
  • Jeden Morgen die Stufen vorlesen: zeitgesteuerter Auslöser, Aktion „USGS-Vulkane: Stufen lesen“, dann text sagen.
  • Eine Lampe orange leuchten lassen, solange der Mount Rainier über normal ist: Bedingung auf sein Warnstufen-Gerät.

Datenquellen, Bedingungen und Kontingente​

Die Daten stammen aus dem Volcano Hazards Program des USGS, über die öffentliche HANS-API (https://volcanoes.usgs.gov/hans-public/api/): die überwachten Vulkane und ihre Stufen bei jeder Aktualisierung, die Zusammenfassungen der aktivsten (CAP-Warnungen) und die Positionen der US-Vulkane einmal am Tag. Die Daten des USGS sind gemeinfrei; die Integration nennt die Quelle im Widget. HANS veröffentlicht kein Kontingent: Die Integration fragt höchstens drei kleine Dokumente pro Aktualisierung ab, standardmäßig alle 15 Minuten.

Lies die Warnstufen, erklärt vom USGS (auf Englisch).

Fehlerbehebung​

  • „Nicht unter den überwachten Vulkanen gefunden oder mehrdeutig“: Prüfe die Schreibweise in der Liste oben oder trage die Vulkannummer ein. Ein Vulkan ohne Echtzeitüberwachung hat keine Stufe.
  • „Kein Mittelpunkt für die Vulkane in der Nähe“: Gib deinem Haus in Gladys einen Standort oder trage Koordinaten ein.
  • „Der USGS (HANS) antwortet nicht“: Die Werte bleiben, wie sie waren; die Integration versucht es bei der nächsten Aktualisierung erneut. Prüfe den Internetzugang des Gladys-Rechners.
  • Kein neues Gerät nach einer Änderung der Liste: Öffne den Reiter Entdeckung und füge es hinzu.
  • Starte den Container mit LOG_LEVEL=debug, um jede Aktualisierung in seinen Protokollen zu sehen.

Grenzen​

  • Nur vom USGS überwachte Vulkane der Vereinigten Staaten; die Stufen sind die der neuesten Meldung.
  • Das Datum der letzten Stufenänderung kennt nur die Beobachtung der Integration (HANS gibt es nicht an); der Verlauf der Funktion in Gladys bewahrt es.
  • Die Meldungen und Zusammenfassungen sind auf Englisch, wie der USGS sie schreibt.
  • Der Name eines Geräts und seiner Funktionen wird bei der Erstellung festgelegt, in der damals gewählten Sprache.

Konfigurationseinstellungen​

Diese Einstellungen fragt USGS Volcanoes in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine VulkanesectionNeinDie Vulkanobservatorien des USGS bewerten die überwachten US-Vulkane: Warnstufe am Boden (Normal, Hinweis, Beobachtung, Warnung) und Luftfahrt-Farbcode (Grün bis Rot). Verfolge Vulkane nach Namen und/oder alle rund um dein Haus.
Verfolgte VulkanestringNeinNamen durch Kommas getrennt (Kilauea, Mount St. Helens…), Vulkannummern oder ein Observatorium (avo, calvo, cvo, hvo, nmi, yvo) für alle seine Vulkane. Ein Gerät pro Vulkan.
Vulkane in der Nähe: RadiusselectNeinEin Gerät „Vulkane in der Nähe“ zeigt die höchste Warnstufe der überwachten Vulkane in diesem Umkreis um dein Haus. Aus: kein solches Gerät.
Breitengrad des MittelpunktsstringNeinLass beide Koordinaten leer, um den Standort deines Hauses in Gladys zu verwenden.
Längengrad des MittelpunktsstringNeinDezimalgrad, Westen negativ.
AktualisierungsintervallselectNeinDie Observatorien veröffentlichen höchstens einige Meldungen am Tag; eine Stufenänderung kommt immer mit einer Meldung.
Sprache der TexteselectNeinNamen der Geräte und Funktionen (bei ihrer Erstellung) und an Szenen gesendete Texte.
Quellen und GrenzensectionNeinDaten: USGS Volcano Hazards Program (gemeinfrei), ohne Konto gelesen. Nicht mit dem USGS verbunden. Kein Sicherheitswarnsystem: Folge den offiziellen Meldungen und den örtlichen Behörden.

So installierst du USGS Volcanoes in Gladys​

  1. Öffne in Gladys Integrationen: USGS Volcanoes 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-usgs-volcanoes: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-usgs-volcanoes.

USGS Volcanoes 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​

USGS Volcanoes 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 🙂