Pollenflug

Das Modul nutzt den von Deutschen Wetterdienst (DWD) bereitgestellten Pollenflug-Gefahrenindex (opendata.dwd.de) zur graphischen Aufbereitung und erzeugt über alle Meldungen einen kurzen Tageshinweis für die entsprechenden Gefahren.

Inhaltverzeichnis

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

1. Funktionsumfang

Dieses Modul ruft den Pollenflug-Gefahrenindex von DWD ab und stellt ihn textuell bzw. graphisch dar.

• Auswahl des gewüschten Bundeslandes
• Auswahl der gewünschten Region
• Auswahl der darzustellenden Tage (max. 3 Tage)
• Auswahl der darzustellenden Gefahren/Pollenarten
• Meldungen an Visualisierung und/oder Meldungsdashboard ab einen bestimmten Gefahrenlevel
• Möglichleit der Medieneinbindung von Pollenflugkalender(n) (www.pollenstuftung.de)
• Tägliche Aktualisierung der Daten (siehe Einrichten der Instanz)

Der Pollen-Gefahrenindex kann auch über die Methode POLLEN_IndexInfo als JSON abgerufen werden.

2. Voraussetzungen

• IP-Symcon ab Version 8.1

3. Installation

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

4. Einrichten der Instanzen in IP-Symcon

• Unter "Instanz hinzufügen" ist das Pollenflug-Modul (Pollination) unter dem Hersteller '(Geräte)' aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

📆 Pollenflugkalender ...

Name	Beschreibung
Gesamtdeutscher Pollenflugkalender (2016–2021)	Aktiv, wird entsprechender Kalender als Bild (Medien) angelegt
Pollenflugkalender für Norddeutschland (2016–2021)	Aktiv, wird entsprechender Kalender als Bild (Medien) angelegt
Pollenflugkalender für Mittel- und Ostdeutschland (2016–2021)	Aktiv, wird entsprechender Kalender als Bild (Medien) angelegt
Pollenflugkalender für Süddeutschland (2016–2021)	Aktiv, wird entsprechender Kalender als Bild (Medien) angelegt
Pollenflugkalender für Westdeutschland (2016–2021)	Aktiv, wird entsprechender Kalender als Bild (Medien) angelegt

✨ Visualisierung ...

Name	Beschreibung
Ambrosia	Wenn Aktiv, wird dazugehöriger Gefahrindex in der Visualisierung angezeigt
Beifuß	Wenn Aktiv, wird dazugehöriger Gefahrindex in der Visualisierung angezeigt
Birke	Wenn Aktiv, wird dazugehöriger Gefahrindex in der Visualisierung angezeigt
Erle	Wenn Aktiv, wird dazugehöriger Gefahrindex in der Visualisierung angezeigt
Esche	Wenn Aktiv, wird dazugehöriger Gefahrindex in der Visualisierung angezeigt
Gräser	Wenn Aktiv, wird dazugehöriger Gefahrindex in der Visualisierung angezeigt
Hasel	Wenn Aktiv, wird dazugehöriger Gefahrindex in der Visualisierung angezeigt
Roggen	Wenn Aktiv, wird dazugehöriger Gefahrindex in der Visualisierung angezeigt

📢 Meldungsverwaltung ...

Name	Beschreibung
Meldung an Anzeige senden	Auswahl ob Eintrag in die Meldungsverwaltung erfolgen soll oder nicht (Ja/Nein)
Ab Stufe	Auswahl ab welcher Stufe (1-4) die Nachricht erfolgen soll
Nachricht an Visualiserung senden	Auswahl ob Push-Nachricht gesendet werden soll oder nicht (Ja/Nein)
Ab Stufe	Auswahl ab welcher Stufe (1-4) die Meldung erfolgen soll
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
Variable für Tageshinweis anlegen?	Schalter, ob der tägliche Tageshinweis (Text) angelegt und aktualisiert werden soll.

Aktionsbereich:

Aktion	Beschreibung
AKTUALISIEREN	Ermittelt für das aktuelle Datum den Gefahrenindex (Update)

5. Statusvariablen

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

Name	Typ	Beschreibung
Letzte Aktualisierung	Integer	von DWD gelieferter Zeitstempel der letzten Aktualisierung
Nächste Aktualisierung	Integer	von DWD gelieferter Zeitstempel für die nächste Aktualisierung
Bundesland	Integer	Bundesland für welchen man die den Gefahrenindex haben möchte
Region	Integer	Teilregion innerhalb des Bundeslandes
Tage	Integer	Anzahl der vorhergesagten Tage
Tageshinweis	String	Textuelle Zusammenfassung der Vorhersage
{Pollenflugkalender}	Medien	n-Bild(er) der aktivieren Pollenflugkalender (Gesamtdeutsch, Nord, West, Ost, Süd)

6. Visualisierung

Man kann die gesamte Instanz direkt in die Visualisierung verlinken.

7. PHP-Befehlsreferenz

void POLLEN_Update(int $InstanzID):

Holt entsprechend der Konfiguration die gewählten Daten. Die Funktion liefert keinerlei Rückgabewert.

Beispiel: POLLEN_Update(12345);

string POLLEN_IndexInfo(int $InstanzID);

Holt den aktuellen Gefahrenindex ab und gibt diese als JSON zurück.

Beispiel: POLLEN_IndexInfo(12345);

{
"index": { "Roggen": [1,1,0], "Graeser": [1,1,0], "Beifuss": [1,1,0], "Ambrosia": [1,1,0], "Hasel": [6,7,0], "Esche": [1,1,0], "Erle": [7,7,0],"Birke": [1,1,0]},
"legend": {
"#7": "hoch",
"#6": "mittel bis hoch",
"#5": "mittel",
"#4": "gering bis mittel",
"#3": "gering",
"#2": "keine bis gering",
"#1": "keine",
"#0": "nicht bekannt"
},
"next": 1614506400,
"last": 1614420000
}

8. Versionshistorie

v4.0.20260208

• NEU: Umstellung auf IPSModuleStrict
• NEU: Umstellung von Profilen auf Darstellungen
• NEU: Modulversion wird in Quellcodesektion angezeigt
• NEU: Projektumstrukturierung hin zu einer globalen CI/CD-Pipeline
• NEU: Kompatibilität auf IPS 8.1 hoch gesetzt
• NEU: Direkte Unterstützung der TileVisu, keine HTML-Boxen mehr
• NEU: Senden von Nachrichten ab definiertem Gefahrenindex
• NEU: Version der Pollenflugkalender nachgezogen und als echtes Bild(Medien) realisiert
• FIX: Gefahrenindex wird jetzt korrekt abgebildet, konnte unter gewissen Umständen um eins zu niedrig gewesen sein
• FIX: Übersetzungen vollständig nachgezogen
• FIX: Bibliotheksfunktionen angeglichen

v3.0.20221007

• NEU: Örtliche und zeitliche Einstellungen per Webfront ermöglicht
• FIX: Vereinheitlichungen des Konfigurationsformulars
• FIX: Libs nachgezogen

v2.0.20210227

• NEU: Gefahrenindex kann als JSON Objekt abgerufen werden.
• NEU: Tabellarische Ausgabe kann mittels CSS angepasst werden.
• FIX: Gefahrenindex wird jetzt immer alphabetisch sortiert dargestellt.
• FIX: Vereinheitlichungen des Konfigurationsformulars
• FIX: Vereinheitlichungen der Libs

v1.0.20190821

• NEU: Initialversion (Migration vom Script Online.Pollination.ips.php v1.2.20181012).

Danksagung

Die verwendeten Icons sind vom Autor "Freepik" von www.flaticon.com (Icon made by Freepik from https://www.flaticon.com).
Vielen Dank für die hervorragende und tolle Arbeit! Thanks!

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

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