Zum Hauptinhalt springen

US Drought Monitor Smart-Home-Integration, kostenlos und Open Source

US Drought Monitor-Integration für Gladys Assistant

Dürrestufe deines US-Countys laut US Drought Monitor: D0 bis D4, Änderungen, Auslöser.

Auf GitHub ansehenAlle Integrationen

Die Dürrestufe deines US-Countys laut US Drought Monitor (USDM), der wöchentlichen Dürrekarte der Vereinigten Staaten, erstellt vom National Drought Mitigation Center (University of Nebraska-Lincoln), dem USDA und der NOAA. Ein Gerät pro verfolgtem County, mit seiner Dürrekategorie, dem Anteil des Countys in jeder Kategorie und der Änderung in 1 und 4 Wochen; Szenenauslöser, wenn sich die Dürre verschärft, eine Stufe erreicht oder nachlässt; ein fertiger Satz für eine Benachrichtigung; und ein Widget in den Farben der USDM-Karte.

Der USDM beschreibt die Dürre; er legt keine Wasserbeschränkungen fest: Diese beschließt deine Stadt, dein County oder dein Wasserversorger.

Was du bekommst​

  • ein Gerät pro County, mit seiner Stufe (0 bis 5), seiner Kategorie („D2 · Schwere Dürre“), dem Anteil des Countys in D1 oder schlimmer, D2 oder schlimmer, D3 oder schlimmer und D4, der Änderung in 1 und 4 Wochen und dem Datum der Karte;
  • drei Szenenauslöser: Die Dürre verschärft sich, erreicht eine Stufe, lässt nach;
  • eine Szenenaktion, die die letzte Karte in einem Satz liefert;
  • ein Widget mit dem Anteil jeder Kategorie als farbiger Streifen in den offiziellen USDM-Farben.

Voraussetzungen​

  • Gladys Assistant 5.3 oder neuer.
  • Internetzugang für Gladys (Datendienste des USDM, ohne Konto und ohne Schlüssel).
  • Der 5-stellige FIPS-Code deines Countys (siehe unten).

Konfiguration​

  1. Finde den FIPS-Code deines Countys: 2 Ziffern für den Bundesstaat, 3 für das County. Harris County (Texas) hat 48201, Los Angeles County (Kalifornien) 06037. Das US Census listet alle auf (https://www.census.gov/library/reference/code-lists/ansi.html), und eine Suche nach „FIPS code“ und dem Namen des Countys liefert ihn ebenfalls.
  2. Gib im Tab Konfiguration die Codes ein, durch Kommas getrennt, und speichere.
  3. Lege die Geräte im Tab Entdecken an.

Einstellungen​

  • FIPS-Codes der Countys — höchstens 10 Countys. Ein Code, den der USDM nicht kennt, wird im Status der Integration gemeldet, und es wird kein Gerät dafür angeboten. Ein 4-stelliger Code wird mit führender Null gelesen (6037 ist 06037).
  • Nötiger Anteil für eine Kategorie — die Stufe eines Countys ist die stärkste Kategorie, die mindestens diesen Anteil seiner Fläche abdeckt, standardmäßig 1 %. Der USDM zeichnet seine Kategorien auf eine Karte: In einem großen County sagt ein schmaler D3-Streifen am Rand wenig über dein Haus. Wähle „Jeder Anteil“, um der stärksten Kategorie zu folgen, die das County berührt, oder einen höheren Anteil, um dem Großteil des Countys zu folgen.
  • Sprache der Funktionsnamen — Namen neuer Funktionen und Sprache ihrer Texte (Kategorien, Änderungen, Daten, Szenenvariablen und Zusammenfassung).

Geräte​

FunktionInhalt
Dürrestufe (0–5)0 keine Dürre, 1 D0 ungewöhnlich trocken, 2 D1 mäßig, 3 D2 schwer, 4 D3 extrem, 5 D4 außergewöhnlich
Dürrekategorie„D2 · Schwere Dürre“, „Keine Dürre“
Fläche in D1 oder schlimmerAnteil des Countys in Dürre, in %
Fläche in D2/D3 oder schl.Anteil des Countys in D2 oder schlimmer, D3 oder schlimmer, in %
Fläche in D4Anteil des Countys in außergewöhnlicher Dürre, in %
Änderung in 1 / 4 Wochen„D1 → D2, schlechter · D1+ +12,5 Pkt.“: Stufen und Änderung des D1+-Anteils in Punkten
Datum der Karteder Dienstag, den die Karte beschreibt

D0 (ungewöhnlich trocken) ist für den USDM keine Dürre: Es kennzeichnet ein Gebiet, das in eine Dürre gerät oder sie verlässt. Hier ist es eine eigene Stufe.

Die Anteile folgen dem USDM: „D2 oder schlimmer“ enthält D3 und D4. Stufe, Kategorie und Anteile behalten ihren Verlauf.

Dashboard-Widget​

Dürre (USA): das gewählte County (oder das erste verfolgte), mit seinem Namen in Gladys, ein Streifen, aufgeteilt nach dem Anteil jeder Kategorie in den Farben der USDM-Legende (dunkelrot D4, rot D3, orange D2, beige D1, gelb D0, grau ohne Dürre), die Kategorie, die Anteile, die Änderungen und das Datum der Karte. Jeder Block lässt sich in den Widget-Einstellungen ausblenden.

Szenenauslöser​

  • Die Dürre verschärft sich — eine neue Wochenkarte stuft das County in eine stärkere Kategorie ein als die vorherige Karte.
  • Die Dürre erreicht eine Stufe — eine neue Karte stuft das County in die gewählte Kategorie (D0 bis D4) oder eine stärkere ein, vorher lag es darunter.
  • Die Dürre lässt nach — eine neue Karte stuft das County in eine schwächere Kategorie ein.

Jeder Auslöser lässt sich auf ein County beschränken. Die Auslöser lösen einmal pro neuer Karte aus (donnerstags), nie bei der ersten gelesenen Karte, die nur als Referenz dient. Variablen: County, Kategorie (none, D0 bis D4), vorherige Kategorie, Name der Kategorie, Stufe (0–5), Fläche in D1 oder schlimmer, Datum der Karte.

Szenenaktion​

Dürre: die Karte des Countys in einem Satz abrufen liefert für das gewählte County (oder das erste verfolgte) einen Satz wie „Harris County, TX, Karte vom 3. Nov. 2026: D3 · Extreme Dürre, 83,2 % des Countys in Dürre (D1+). Schlechter als vor 4 Wochen.“ sowie Kategorie, Stufe, Anteile und Datum der Karte für die folgenden Aktionen.

Szenenbeispiele​

  • Die Dürre erreicht D2 → Benachrichtigung „Denk an Bewässerungsverbote: Prüfe die Regeln deiner Stadt.“
  • Jeden Donnerstagabend → den Satz abrufen und per Telegram senden.
  • Die Dürre lässt nach → die Gartenbewässerung wieder auf den normalen Plan stellen.

Datenquellen, Lizenz und Kontingente​

  • Datendienste des US Drought Monitor, usdmdataservices.unl.edu, County-Statistiken in Prozent der Fläche. Ohne Konto, ohne Schlüssel, ohne dokumentiertes Kontingent.
  • Die Karte wird mit den Daten vom Dienstag gezeichnet und donnerstags veröffentlicht. Die Integration liest jedes County einmal am Tag und ab Donnerstagnachmittag (UTC) alle 3 Stunden, bis die neue Karte da ist: wenige Anfragen pro County und Tag.
  • „The U.S. Drought Monitor is jointly produced by the National Drought Mitigation Center at the University of Nebraska-Lincoln, the United States Department of Agriculture, and the National Oceanic and Atmospheric Administration. Map courtesy of NDMC.“
  • Steht in keiner Verbindung zum US Drought Monitor, zum NDMC, zum USDA oder zur NOAA.

Fehlerbehebung​

  • Kein Gerät im Tab „Entdecken“ — prüfe die FIPS-Codes: Ein Code, den der USDM nicht kennt, wird im Status der Integration genannt.
  • Status „nicht lesbar“ — die Datendienste des USDM antworten nicht; die Integration versucht es jede Stunde erneut und behält die letzte Karte drei Wochen lang.
  • Protokolle: Protokollseite der Integration in Gladys; LOG_LEVEL=debug für die Details jedes Lesevorgangs.

Grenzen​

  • Nur Vereinigte Staaten, auf County-Ebene (keine Stadt, keine Postleitzahl).
  • Wöchentliche Daten: Die Karte vom Donnerstag beschreibt den Dienstag davor.
  • Wasserbeschränkungen gehören nicht zum USDM: Frag deine Stadt oder deinen Wasserversorger.
  • Nach drei Wochen ohne neue Karte erhalten die Geräte keine Werte mehr.

Konfigurationseinstellungen​

Diese Einstellungen fragt US Drought Monitor in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine CountyssectionNeinGib den 5-stelligen FIPS-Code jedes Countys ein, das du verfolgen willst (Harris County, Texas: 48201): ein Gerät pro County, mit seiner Dürrekategorie, dem Flächenanteil jeder Kategorie und der Änderung in 1 und 4 Wochen. Speichere und lege dann die Geräte im Tab „Entdecken“ an.
Quellen und GrenzensectionNeinKarte des US Drought Monitor (NDMC, USDA, NOAA), ohne Konto gelesen, jeden Donnerstag mit den Daten vom Dienstag veröffentlicht. Die Karte legt keine Wasserbeschränkungen fest: Diese hängen von deiner Stadt oder deinem Wasserversorger ab. Steht in keiner Verbindung zum US Drought Monitor.
FIPS-Codes der CountysstringNeinJe 5 Ziffern, durch Kommas getrennt, höchstens 10.
Nötiger Anteil für eine KategorieselectNeinDie Stufe eines Countys ist die stärkste Kategorie, die mindestens diesen Anteil seiner Fläche abdeckt.
Sprache der FunktionsnamenselectNeinNamen neuer Funktionen und Sprache ihrer Texte (Kategorien, Änderungen, Daten, Szenenvariablen und Zusammenfassung).

So installierst du US Drought Monitor in Gladys​

  1. Öffne in Gladys Integrationen: US Drought Monitor 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-us-drought: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-us-drought.

US Drought Monitor 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 Drought Monitor 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