Suche

    Unwetterwarnung

    Dokumentation direkt aus GitHub Wilkware/WeatherWarning ↗

    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).

    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 installieren.
    • Alternativ über das Modul Control folgende URL hinzufügen.
      https://github.com/Wilkware/WeatherWarning oder git://github.com/Wilkware/WeatherWarning.git

    4. Einrichtung

    • 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 eines anderen “Gebietstyp” oder durch “Bitte wählen …” an der gewünschten Stelle.

    NameBeschreibung
    Land‘Deutschland’
    WarngebietAuswahl von 6 verschiedenen Warngebieten
    BundeslandAuswahl des Bundeslandes welches für den Warntyp verfügbar ist
    Landkreis/kreisfreie StadtAuswahl des Landkreises oder einer kreisfreien Stadt im Bundesgebiet
    GemeindeAuswahl 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 detailliertere Variante 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!

    NameBeschreibung
    AuswahlAktiviert Statusvariable für Unwetterkarte bei Auswahl eines konkreten Gebietes
    DetailgradKreis- oder Gemeindeebene (Gemeinde dauert sehr lange zum Generieren)
    HintergrundAuswahl des Hintergrundlayers oder transparent
    BildbreiteBreite in Pixel des zu generierenden Bildes (vordefiniert 500px und die Ration entsprechend in Richtung Höhe)
    BildhöheHöhe in Pixel des zu generierenden Bildes
    WestWestlicher Breitengrad (Begrenzung der Bildbox im Westen)
    SüdSüdlicher Längengrad (Begrenzung der Bildbox im Süden)
    OstÖstlicher Breitengrad (Begrenzung der Bildbox im Osten)
    NordNördlicher Längengrad (Begrenzung der Bildbox im Norden)
    Markierung anzeigen?Schalter, ob Markierung des eigenen Standortes (Location Control) angezeigt werden soll.
    Farbe der MarkierungFarbauswahl für Marker Pin, welcher als Platzhalter {{color}} in der CSS-Definition verwendet werden kann!
    Legende (Html)Html Vorlage für Legende-Tabelle

    Bilder und Radarfilm …

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

    NameBeschreibung
    Aktuelle TemperaturDarstellung der aktuellen Temperatur zum aktuellen Tageszeitpunkt
    Niederschlag RadarbildRadarbild des aktuellen Niederschlages zum aktuellen Tageszeitpunkt
    Niederschlag RadarfilmAnimation des aktuellen Niederschlages zum mitlaufenden Tageszeitpunkt

    Formatvorlagen …

    NameBeschreibung
    UnwetterkarteStyle für die Unwetterkarte (Deutschlandkarte mit Pin)
    WarnmeldungStyle für die Warnmeldungen (Tabelle, Icon, Überschrift, Beschreibung und Zeitspanne)
    LegendeStyle für die Legende (Farbskala und deren Zuordnung zu Gefahrenstufen)
    ZURÜCKSETZENSchalter, um wieder die jeweilig vordefinierten Stylesheet-Angaben einzusetzen

    Meldungsverwaltung …

    NameBeschreibung
    Meldung an Anzeige sendenAuswahl ob Eintrag in die Meldungsverwaltung erfolgen soll oder nicht (Ja/Nein)
    Ab Stufe der WarnmeldungAuswahl ab welcher Stufe (1-4) die Nachricht erfolgen soll
    Lebensdauer der NachrichtWie lange soll die Meldung angezeigt werden?
    Nachricht an Visualisierung sendenAuswahl ob Push-Nachricht gesendet werden soll oder nicht (Ja/Nein)
    Ab Stufe der WarnmeldungAuswahl ab welcher Stufe (1-4) die Meldung erfolgen soll
    Text in Variable schreibenAuswahl ob Nachricht in Statusvariable geschrieben werden soll
    Texttrennzeichen/ZeilenumbruchTrennzeichen bei mehreren Ereignissen
    Format der TextmitteilungFrei wählbares Format der zu sendenden Nachricht/Meldung
    Visualisierungs-InstanzID der Visualisierung, an welches die Push-Nachrichten für Geburts-, Hochzeits- und Todestage gesendet werden soll (WebFront oder TileVisu Instanz)
    MeldungsskriptSkript ID des Meldungsverwaltungsskripts, weiterführende Infos im Forum: Meldungsanzeige im Webfront

    Erweiterte Einstellungen …

    NameBeschreibung
    Indikatorvariable für aktive Warnungen anlegen (höchste Stufe)!Schalter, ob eine Statusvariable als Indikator für Warnungen (höchste 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.
    AktualisierungsintervalAuswahl aller wieviel Minuten Informationen abgerufen werden sollen (Standard: 15 min)

    Aktionsbereich:

    Wetterwarnungen …

    AktionBeschreibung
    AKTUALISIERENRuft die aktuellen Unwetterwarnungen von DWD ab (Update)

    5. Statusvariablen

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

    NameTypBeschreibung
    WarnstufeIntegerHöchste Warnstufe aller verfügbaren Meldungen
    WarnmeldungenStringDarstellung aller Meldungen als HTML Tabelle
    WarnnachrichtStringDarstellung aller Meldungen in textuellen Format
    UnwetterkarteStringUnwetterkarte für Deutschland bzw. das ausgewählte Bundesland
    LegendeStringErklärung der Zuordnung Farbe zu Warnstufe
    Temperaturen aktuellStringAktuelle Temperaturübersichtskarte für ausgewähltes Bundesland
    Niederschlag RadarbildStringAktuelles Radarbild (Niederschlag) für ausgewähltes Bundesland
    Niederschlag RadarfilmStringAktueller Radarfilm (Niederschlag) für ausgewähltes Bundesland
    Temperaturen aktuell (de)StringAktuelle Temperaturübersichtskarte für Deutschland
    Niederschlag Radarbild (de)StringAktuelles Radarbild (Niederschlag) für Deutschland
    Niederschlag Radarfilm (de)StringAktueller Radarfilm (Niederschlag) für Deutschland
    Niederschlags Vorhersage (de)StringNiederschlagsvorhersage für Deutschland

    Hinweis: Bis auf Warnmeldungen werden die Statusvariablen nur entsprechend der Auswahl in der Konfiguration angelegt.

    6. Darstellungen

    Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.

    VariableDarstellungWerte
    WarnstufeWertanzeigeKeine Warnung (0), Wetterwarnung (1), Markante Wetterwarnung (2), Unwetterwarnung (3), Extreme Unwetterwarnung (4), UV-Warnung (10, 12), Hitzewarnung (11), Extreme Hitzewarnung (13)
    WarnmeldungenWebinhaltHTML
    UnwetterkarteWebinhaltHTML
    LegendeWebinhaltHTML
    Temperaturen aktuell (…)WebinhaltHTML
    Niederschlag Radarbild (…)WebinhaltHTML
    Niederschlag Radarfilm (…)WebinhaltHTML
    Niederschlags Vorhersage (de)WebinhaltHTML

    7. Visualisierung

    Man kann die Statusvariablen direkt in die Visualisierung verlinken.

    8. 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”:""
    }]

    9. 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 ;-)

    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