Unwetterwarnung

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

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

• Symcon ab Version 6.4

3. Installation

• Über den Modul Store das Modul Unwetterwarnung (🇬🇧 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 Symcon

• Unter “Instanz hinzufügen” ist das ‘Unwetterwarnung’-Modul 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.

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!

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.

Formatvorlagen …

Meldungsverwaltung …

Erweiterte Einstellungen …

Aktionsbereich:

Wetterwarnungen …

5. Statusvariablen und Profile

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

Folgendes Profil wird angelegt:

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

v3.1.20250802

• NEU: Niederschlagsradar-Vorhersage hinzugefügt

v3.0.20250801

• NEU: Icons werden jetzt via github-Pages geladen (bessere Ausfallsicherheit)
• NEU: HTML für Legende in Konfiguration aufgenommen
• NEU: Continuous Integration mit Check Style, Static Code Analysis und Unit Tests eingeführt
• NEU: Debugging Funktionen komplett überarbeitet
• FIX: Update der Event-Tabelle für korrekte Zurodnung von Ereignis zu Icon
• FIX: Zeiten korrigiert (TimeZone wird jetzt korrekt gesetzt)
• FIX: Meta-Tag für viewport gelöscht, kommt automatisch vom System
• FIX: Farben der Profilassoziationen passenend zu Symbolfarbe
• FIX: (Warn)Symbole hür Hitze und UV werden jetzt korrekt gesetzt
• FIX: Warnungskategorie Health korrigiert
• FIX: Dokumentation für PHP Static Analysis komplett überarbeitet
• FIX: Bibliotheksfunktionen überarbeitet in Vorbereitung auf IPSModuleStrict

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 Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)

Spenden

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

Lizenz

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