Unwetterwarnung (Weather Warning)

Version Product Version License Actions

Dieses Modul dient zum Abrufen der von DWD bereitgestellten Unwetterwarnungen (Gewitter, Stark- und Dauerregen, Schneefall, Wind, Nebel, Frost, Glatteis, Tauwetter, UV-Strahlung, Hitze).

Inhaltverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Installation
  4. Einrichten der Instanzen in IP-Symcon
  5. Statusvariablen und Profile
  6. Visualisierung
  7. PHP-Befehlsreferenz
  8. Versionshistorie

1. Funktionsumfang

Das Modul nutzt die vom GeoWebservice des deutschen Wetterdienstes (DWD) bereitgestellten WMS-Dienste um (Un)Wetterwarnungen in IPS zu integrieren. Je nach ausgewählter Region bzw. Gebietstyp werden die Warnungen gefiltert und in verschiedene Kanäle (Text, HTML, Push-Nachricht) ausgegeben.

Für die Auswahl des Gebietstyps/Region nutzt das Modul eine eigens entwickelte JSON-API (CDN basierend) damit der Nutzer schnell die richtige Gebiets-ID (WARNCELLID) einstellen kann (derzeit 12144).

Darüber hinaus können noch Variablen zur Darstellung verschiedener Wetterbilder und Radarfilme angelegt werden.

2. Voraussetzungen

  • IP-Symcon ab Version 6.4

3. Installation

  • Über den Modul Store das Modul Weather Warning installieren.
  • Alternativ Über das Modul-Control folgende URL hinzufügen.
    https://github.com/Wilkware/WeatherWarning oder git://github.com/Wilkware/WeatherWarning.git

4. Einrichten der Instanzen in IP-Symcon

  • Unter "Instanz hinzufügen" ist das 'Weather Warning'-Modul (Alias: 'Unwetterwarnung') unter dem Hersteller '(Geräte)' aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

Warngebiet ...

Entsprechend der gewählten Auswahl verändert sich das Formular dynamisch. Eine komplette Neuauswahl erreicht man durch Auswahl einens anderen "Gebietstyp" oder durch "Bitte wählen ..." an der gewünschten Stelle.

Name Beschreibung
Land 'Deutschland'
Warngebiet Auswahl von 6 verschiedenen Warngebieten
Bundesland Auswahl des Bundeslandes welches für den Warntyp verfügbar ist
Landkreis/kreisfreie Stadt Auswahl des Landkreises oder einer kreisfreien Stadt im Bundesgebiet
Gemeinde Auswahl einer Gemeinde, wenn der Typ diese Auflösung unterstützt (Warntyp: Gemeinden)

Unwetterkarten ...

Hier kann eine Unwetterübersichtskarte aktiviert und konfiguriert werden. Neben der großen Deutschlandkarte kann auch eine detailiertere Variant auf Basis des Bundeslandes gewählt werden. Das Erscheinungsbild kann durch verschiedene Parameter angepasst werden.
Der darzustellende Bereich (so g. Bounding Box) wird dabei durch die Längen- und Breitengrade der 4 Himmelsrichtungen begrenzt!

Name Beschreibung
Auswahl Aktiviert Statusvariable für Unwetterkarte bei Auswahl eines konkreten Gebietes
Detailgrad Kreis- oder Gemeindeebene (Gemeinde dauert sehr lange zum Generieren)
Hintergrund Auswahl des Hintergrundlayers oder transparent
Bildbreite Breite in Pixel des zu generierenden Bildes (vordefiniert 500px und die Ration entsprechend in Richtung Höhe)
Bildhöhe Höhe in Pixel des zu generierenden Bildes
West Westlicher Breitengrad (Begrenzung der Bildbox im Westen)
Süd Südlicher Längengrad (Begrenzung der Bildbox im Süden)
Ost Östlicher Breitengrad (Begrenzung der Bildbox im Osten)
Süd Nördlicher Längengrad (Begrenzung der Bildbox im Norden)
Markierung anzeigern? Schalter, ob Markierung des eigenen Standortes (Location Control) angezeigt werden soll.
Farbe der Markierung Farbauswahl für Marker Pin, welcher als Platzhalter {{color}} in der CSS-Definition verwendet werden kann!

Bilder und Radarfilm ...

Hier können Bildder bzw. der Radarfilm für die aktuellen Temperaturen und Niederschläge je Bundesland und/oder Detuschland aktiviert werden.
Das Erscheinungsbild kann wieder über die Stylesheet-Angaben beeinflußt werden.

Name Beschreibung
Aktuelle Temperatur Darstellung der aktuellen Temperatur zum aktuellen Tageszeitpunkt
Niederschlag Radarbild Radarbild des aktuellen Niederschlages zum aktuellen Tageszeitpunkt
Niederschlag Radarfim Animation des aktuellen Niederschlages zum mitlaufenden Tageszeitpunkt

Formatvorlagen ...

Name Beschreibung
Unwetterkarte Sytle für die Unwetterkarte (Deutschlandkarte mit Pin)
Warnmeldung Style für die Warnmeldungen (Tabelle, Icon, Überschrift, Beschreibung und Zeitspanne)
Legende Style für die Legende (Farbskala und deren Zuordnung zu Gefahrenstufen)
ZURÜCKSETZEN Schalter, um wieder die jeweilig vordefinierten Stylesheet-Angaben einzusetzen

Meldungsverwaltung ...

Name Beschreibung
Meldung an Anzeige senden Auswahl ob Eintrag in die Meldungsverwaltung erfolgen soll oder nicht (Ja/Nein)
Ab Stufe der Warnmeldung Auswahl ab welcher Stufe (1-4) die Nachricht erfolgen soll
Lebensdauer der Nachricht Wie lange so die Meldung angezeigt werden?
Nachricht an Visualiserung senden Auswahl ob Push-Nachricht gesendet werden soll oder nicht (Ja/Nein)
Ab Stufe der Warnmeldung Auswahl ab welcher Stufe (1-4) die Meldung erfolgen soll
Text in Variable schreiben Auswahl ob Nachricht in Statusvariable geschrieben werden soll
Texttrennzeichen/Zeilenumbruch Trennzeichen bei mehreren Ereignissen
Format der Textmitteilung Frei wählbares Format der zu sendenden Nachricht/Meldung
Visualisierungs-Instanz ID der Visualisierung, an welches die Push-Nachrichten für Geburts-, Hochzeits- und Todestage gesendet werden soll (WebFront oder TileVisu Instanz)
Meldsungsskript Skript ID des Meldungsverwaltungsskripts, weiterführende Infos im Forum: Meldungsanzeige im Webfront

Erweiterte Einstellungen ...

Name Beschreibung
Indikatorvariable für aktive Warnungen anlegen (höchste Stufe)! Schalter, ob eine Statusvariable als Indikator für Warnungen (höste Stufe) angelegt und aktualisiert werden soll.
Variable für Bilderklärung (Legende) anlegen! Schalter, ob eine Statusvariable für die Erklärung der Zuordnung Farbe zu Warnstufe angelegt werden soll.
Aktualisierungsinterval Auswahl aller wieviel Minuten Informationen abgerufen werden sollen (Standard: 15 min)

Aktionsbereich:

Wetterwarnungen ...

Aktion Beschreibung
AKTUALISIEREN Ruft die aktuellen Unwetterwarnungen von DWD ab (Update)

5. Statusvariablen und Profile

Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

Name Typ Beschreibung
Warnstufe Integer Höchste Warnstufe aller verfügbaren Meldungen
Warnmeldung String Darstellung aller Meldungen als HTML Tabelle
Warnnachricht String Darstellung aller Meldungen in textuellen Format
Unwetterkarte Land String HTML-Link auf Unwetterkarte Deutschland
Unwetterkarte Bundesland String HTML-Link auf Unwetterkarte ausgewähltes Bundesland
Temperaturen aktuell String HTML-Link auf aktuelle Temperaturübersichtskarte für ausgewähltes Bundesland
Niederschlag Radarbild String HTML-Link auf aktuelles Radarbild (Niederschlag) für ausgewähltes Bundesland
Niederschlag Radarfilm String HTML-Link auf aktuellen Radarfilm (Niederschlag) für ausgewähltes Bundesland
Temperaturen aktuell (de) String HTML-Link auf aktuelle Temperaturübersichtskarte für Deutschland
Niederschlag Radarbild (de) String HTML-Link auf aktuelles Radarbild (Niederschlag) für Deutschland
Niederschlag Radarfilm (de) String HTML-Link auf aktuellen Radarfilm (Niederschlag) für Deutschland

Folgendes Profil wird angelegt:

Name Typ Beschreibung
UWW.Level Integer Warnstufen (0 - 4)

0: Keine Warnung
1: Wetterwarnung
2: Markante Wetterwarnung
3: Unwetterwarnung
4: Extreme Unwetterwarnung
10: UV-Warnung
11: Hitzewarnung
13: Extreme Hitzwarnung

6. Visualisierung

Man kann die Statusvariablen direkt in die Visualisierung verlinken.

7. PHP-Befehlsreferenz

void UWW_Update(int $InstanzID):

Holt entsprechend der Konfiguration die gewählten Daten vom Deutschen Wetterdienst (DWD).
Die Funktion liefert keinerlei Rückgabewert.

Beispiel: UWW_Update(12345);

void UWW_WaringInfo(int $InstanzID):

Gibt alle Unwetterwarnungen als multidimensionales assoziatives Array zurück. HINWEIS: Sollten keine Warnungen vorliegen, wird ein leeres Array geliefert.

Beispiel: UWW_WaringInfo(12345);

[{
"AREA": "Chiemsee",
"WARNCELLID":209913000,
"SENT":"2021-05-10 12:51:00",
"STATUS":"Aktuelle Meldung",
"TYPE":"Erstausgabe der Meldung",
"CATEGORY":"Meteorologische Meldung",
"EVENT":"STARKWIND",
"URGENCY":"Warnung",
"SEVERITY":"Wetterwarnung",
"LEVEL":1,
"CERTAINTY":"Vorhersage, Auftreten wahrscheinlich (p > ~50%)",
"CODE":"57:Starkwind",
"GROUP":"WIND",
"TIMESTAMP":"2021-05-10 12:51:00",
"START":"2021-05-10 12:51:00",
"END":"",
"HEADLINE": "Warnung vor Starkwind",
"DESCRIPTION":"Es treten Windb\u00f6en mit Geschwindigkeiten bis 60 km/h (17m/s, 33kn, Bft 7) auf.",
"INSTRUCTION":""
}]

8. Versionshistorie

v2.0.20240811

  • NEU: Darstellung der Farbskala der Warnstufen (Legende)
  • NEU: Medizin-Meteorologische Meldung (Hitzewarnungen) werden speziell behandelt (Level)
  • NEU: Stylesheets können für alle HTML-Elemente individuell definiert werden
  • NEU: Farbauswahl für Karten-Pin kann durch Platzhalter {{color}} im Stylesheet verwendet werden
  • NEU: Kompatibilität auf IPS 6.4 hoch gesetzt
  • FIX: Icon für extreme Hitze wird jetzt korrekt angezeigt
  • FIX: HTML-Struktur vereinheitlicht und verbessert
  • FIX: Unterscheidung der verschiedenen Visualisierungsinstanzen (PushNotification)
  • FIX: Bibliotheks- bzw. Modulinfos vereinheitlicht
  • FIX: Namensnennung und Repo vereinheitlicht
  • FIX: Update Style-Checks
  • FIX: Übersetzungen überarbeitet und verbessert
  • FIX: Dokumentation vereinheitlicht

v1.7.20230709

  • NEU: Anpassungen für IPS 7.0 (PHP 8.2)
  • FIX: Veraltetet Style-Checks ausgebaut
  • FIX: Weitere Modulvereinheitlichungen vorgenommen
  • FIX: Fehler in Auswertung von Warnungen korrigiert
  • FIX: Fehler bei Umlauten in Meldungsüberschrift (MultiByte)

v1.6.20220114

  • NEU: Kompatibilität auf IPS 6.0 hoch gesetzt
  • NEU: Bibliotheks- bzw. Modulinfos vereinheitlicht
  • NEU: Konfigurationsdialog überarbeitet (v6 Möglichkeiten genutzt)
  • NEU: Doppelte Warnungen bei Meldungsverwaltung entfernt
  • FIX: Fehlende Text-Formatierung für Warnungen hinzugefügt
  • FIX: Fehler in Modulbibliotheken korrigiert

v1.5.20210801

  • FIX: Fehlende Text-Formatierung für Warnungen hinzugefügt
  • FIX: Icon wird jetzt bei allen Warnungen korrekt angezeigt
  • FIX: Weitere Modulvereinheitlichungen vorgenommen
  • FIX: Dokumentation überarbeitet

v1.4.20210611

  • NEU: Positions-Marker auf Unwetterkarte hinzugefügt
  • FIX: Inline Style für Unwetterkarte vereinheitlicht/umgestellt

v1.3.20210609

  • NEU: Text-Formatierung erweitert
  • NEU: Inline-Style Angaben für Unwetterkarte
  • FIX: Warnstufen-Icon für Stufe 3 und 4
  • FIX: Lebensdauer einer Meldung von Sekunden auf Minuten korrigiert
  • FIX: URL-Parameter für Umweltkarte vereinheitlicht
  • FIX: Zuweisung der Formatvorlagen für Meldungstabelle korrigiert
  • FIX: Dokumentation korrigiert

v1.2.20210518

  • NEU: Text-Formatierung um Warnstufe(Zahl) und Beschreibung erweitert
  • NEU: Unwetterkarte auf GeoWebservice umgestellt
  • FIX: Temperatur- und Niederschlagsbilder jetzt mit umschließendem DIV; IMG fixer Style
  • FIX: MV korrekt geschrieben

v1.1.20210511

  • NEU: Temperatur, Niederschlag und Radarfilm auch für ganz Deutschland auswählbar
  • FIX: Keine Auswahl des Warngebietes möglich, Instanz blieb inaktiv
  • FIX: Dokumentation vervollständigt

v1.0.20210313

  • NEU: Initialversion

Danksagung

Ich möchte mich für die Unterstützung bei der Entwicklung dieses Moduls bedanken bei ...

  • Fonzo : für das beharrliche Nachfragen nach dem Modul 😉
  • Nall-chan : für die Hilfe im Channel und seine tollen Lösungen 😉
  • yansoph: für den regen Austausch und das Testen 🙂
  • richimaint: für das Testen beim Umlauteproblem 🙂

Vielen Dank an Euch!

Entwickler

Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der IP-Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti 😉

GitHub

Spenden

Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

PayPal

Lizenz

Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

Licence