Node-RED Node zum Abfragen von Wetterwarnungen des Deutschen Wetterdienstes (DWD).

Fig. 1: Darstellung des Nodes

Remark: This Node is only useful if you're interested in weather warnings for Germany, it can't be used for other countries.

Die Wetterdaten werden vom DWD (Deutscher Wetterdienst, Frankfurter Straße 135, 63067 Offenbach) bereitgestellt.
Sie können folgende Wetterwarnungen beinhalten:

• Wind (Böen, Sturm, Orkan)
• Gewitter
• Starkregen, Dauerregen
• Schneefall, Schneeverwehungen
• Glatteis, Glätte, Frost
• Nebel
• Tauwetter
• Hitze
• UV-Strahlung

• Über Manage palette -> Nach "node-red-contrib-dwd" suchen und installieren

• Ins Node-RED Installationsverzeichnis gehen, z.B.: ~/.node-red
• Ausführen von npm install node-red-contrib-dwd

Die Verwendung des Nodes ist wie folgt:

Fig. 2: Grundsätzliche Verwendung des Nodes

Der Node wird über eine Eingangs-Message getriggert und gibt an seinem Ausgang die Wetterdaten aus.

In den Eigenschaften des Nodes ist lediglich die Einstellung der Region notwendig.

Fig. 3: Node Eigenschaftendialog

Die auswählbaren Regionen bzw. Städte können durch Klicken in das Feld und Drücken z.B. der Leertaste dargestellt werden. Es öffnet sich dann ein Pulldown-Menü mit einer Auflistung:

Fig. 4: Pulldown-Menü mit einstellbaren Regionen/Städte

Der Node wird über jede Eingangs-Message msg mit beliebigem Inhalt getriggert.

Der Node gibt eine msg an seinem Ausgang aus, sobald er über den Eingang getriggert wird.

Die Elemente der msg sind:

• payload - Maximale Warnstufe aktueller Warnungen (level im Array warnings)
• count - Anzahl der Warnungen (im Array warnings)
• events - Kommagetrennte Aufzählungen der Warnungskategorien (z.B. "BÖEN","STARKWIND","NEBEL")
• warnings - Array mit den detaillierten Daten der Warnungen
• html - HTML-Output zur Anzeige im Dashboard

Das Array beinhaltet alle Warnungen, die für die selektierte Region/Stadt aktiv sind. Oftmals ist dies maximal eine einzige Warnung, in diesem Falle enthält das Array nur ein Element (array[1] wie i Fig. 5 dargestellt). Das Array besitzt die folgende Elementstruktur:

Fig. 5: Beispielinhalt des Ausgangsarray warnings

Zu den Details der Strukturelemente siehe auch unten die Informationen zu den DWD-Wetterdaten.

Hervorzuheben sind folgende Strukturelemente:

• type: Dies beinhaltet die Warnungskategorie (siehe auch Element typeName und event). Inhalte sind:
  • 0: Gewitter
  • 1: Sturm
  • 2: Regen
  • 3: Schnee
  • 4: Nebel
  • 5: Frost
  • 6: Glatteis
  • 7: Tauwetter
  • 8: Hitze
  • 9: UV-Strahlung
  • 10: Warnungen der Küstenbereiche
  • 11: Warnungen der Binnenseen
• start bzw. end: Start- und Endezeit der Wetterwarnung
• level: Dies ist die Warnstufe der Warnung
• instructions: Hinweise zum eigenen Verhalten gegenüber der Wetterwarnung
• description: Dies ist die textuelle Darstellung der Inhalte von type bzw. typeName bzw. event in Kombination mit level
• icon und frame: Verlinkung auf Images, die kombiniert ein Warnungssymbol ergeben

Ein Beispiel für die Kombination aus Icon (Wind) und Warnstufe (Warnstufe 1, gelber Rand) sieht wie folgt aus:

Fig. 6: Beispiel eines Warnungs-Icons (Quelle: Deutscher Wetterdienst DWD)

Dieses Element gibt einen HTML-String mit einigen Warnungsdaten aus. Dieser String wird u.a. vom Wetterwarnungs-Dashboard-Template verwendet.

Das Ausgabeformat von html sieht wie folgt aus:

<div class="dwd-warning-container">
    <div class="dwd-icon-container">
        <img class="dwd-icon" src="${warnings[i].icon}">   
        <img class="dwd-icon-frame" src="${warnings[i].frame}">
    </div>
    <div class="dwd-event">${warning.event}</div>
    <div class="dwd-time">${warning.time}</div>
    <div class="dwd-description">${warning.description}</div>
    <div class="dwd-instruction">${warning.instruction}</div>
</div>                             

Diese HTML-Code-Generierung befindet sich in dwd.js und kann ggfs. persönlichen Bedürfnissen angepasst werden. In solch einem Falle muss Node-RED neu gestartet werden, um die Änderungen wirksam werden zu lassen.
Zu beachten ist jedoch, dass Änderungen ggfs. auch zum Inhalt des Wetterwarnungs-Dashboard-Template passen müssen, wenn dieses verwendet werden soll.

Das Wetterwarnungs-Dashboard-Template wird in einem template-Node des Node-RED Dashboards verwendet. Hierfür ist die Bibliothek node-red-dashboard nötig.
Das Template nutzt die Ausgangsdaten des Nodes inclusive eines Icons und eines Rahmens von der DWD-Website und generiert die Wettermeldung.

Zur Nutzung des Templates wird einfach der folgende Code-Snippet in einen template-Node kopiert (z.B. via copy&paste) und das Template dann einer Dashboard UI Gruppe hinzugefügt.
Hiermit ergibt sich eine Dashboard-Ausgabe wie folgt:

Fig. 7: Beispiel im Dashboard unter Verwendung des Wetterwarnungs-Dashboard-Templates

<style>
    .dwd-icon-container {
        display: inline-block;    
    }
    .dwd-event {
        display: inline-block;
        vertical-align: 60px;
        font-weight: bold;
        padding-left: 20px;
    }
    .dwd-icon, .dwd-icon-frame {
        position: absolute;
    }
    .dwd-icon-container, .dwd-icon, .dwd-icon-frame {
        width: 100px;
        height: 100px;
    }
    .dwd-time {
        color: grey;
    }

</style>
<div ng-bind-html="msg.html"></div>

Hinweis: Die Beispiel-Flows liegen im Unterverzeichnis 'examples'. In Node-RED können sie einfach importiert werden, indem sie über das Menü der Importfunktion und dort im vertikalen Tab-Reiter Examples selektiert werden können.
Alle Beispiel-Flows können somit im 'example'-Verzeichnis der jeweiligen Bibliothek gefunden werden.

Dieses Beispiel zeigt wie die Ausgangsdaten msg.payload zu interpretieren sind.

basic flow
Fig. 8: Flow des einfachen Beispiels

Dieses Beispiel gibt die einzelnen Elemente der Ausgangs-msg aus:

output data flow
Fig. 9: Flow mit mehreren Ausgangsdatenelementen

Der folgende Flow zeigt die Verwendung des Wetterwarnungs-Dashboard-Templates:

dashboard template flow
Fig. 10: Flow mit dem Wetterwarnungs-Dashboard-Template

Warnkarte des DWD

https://www.dwd.de/DE/wetter/warnungen_aktuell/kriterien/warnkriterien.html
https://www.dwd.de/DE/wetter/warnungen_aktuell/kriterien/uv_hitze_warnungen.html
https://www.dwd.de/DE/wetter/warnungen_aktuell/kriterien/seewarnungen.html

Details zu den 4 Warnstufen und deren farblicher Darstellung findet sich dort:
https://www.dwd.de/DE/wetter/warnungen_aktuell/kriterien/warnstufen.html

Alle vom DWD bereitgestellten Orte sind in dieser Tabelle dargestellt:
https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv

Es sind jedoch nicht alle in dieser Tabelle vorhandenen Orte im Node-Konfigurations-Dialog auswählbar.
Der Grund dafür ist, dass diese Liste ständigen Änderungen unterworfen ist.

Es kann jedoch die .html-Datei recht einfach um eigene benötigte Orte erweitert werden. Dazu ist der entsprechende, neue Ort mit seiner WARNCELLID eingetragen und Node-RED neu gestartet werden. Danach ist der hinzugefügte Ort in der Auswahlliste enthalten.
Die .html-Datei befindet sich im Unterverzeichnis der Bibliothek node-red-contrib-dwd. Zur Änderung sind meist root-Rechte notwendig.

In der folgenden Fig. 11 ist dargestellt, wie beispielsweise der Ort Rheda-Wiedenbrück in die Tabelle mit aufgenommen wurde:

Fig. 11: Erweiterung der Liste der Regionen/Städte (Beispiel Rheda-Wiedenbrück)

• Sebastian Raff: Programming, maintaining, releasing
• StephanStS: Documentation, node help

MIT (c) Sebastian Raff