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
- Funktionsumfang
- Voraussetzungen
- Installation
- Einrichten der Instanzen in IP-Symcon
- Statusvariablen und Profile
- WebFront
- PHP-Befehlsreferenz
- 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)
- Bearbeitung der Tabellen-Formatvorlagen (Stylesheets)
- Einbindung des gesamtdeutschen Pollenflugkalenders (Bildlink)
- Tägliche Aktualisierung der Daten (siehe Einrichten der Instanz)
Der Pollen-Gefahrenindex kann auch über die Methode POLLEN_IndexInfo als JSON abgerufen werden.
Folgende Informationen stehen als key => value Paare zur Verfügung:
Folgende Informationen stehen als key => value Paare zur Verfügung:
| Schlüssel(key) | Typ | Beschreibung |
|---|---|---|
| last | int | Timestamp, letze Aktualisierung |
| next | int | Timestamp, nächaste Aktualisierung |
| legend | array | #0-#7, textuelle Beschreibung der Belastungsstufen |
| index | array | Belastung für die nächsten 3 Tage (siehe Legende) |
2. Voraussetzungen
- IP-Symcon ab Version 6.0
3. Installation
- Über den Modul Store das Modul Pollenflug installieren.
- Alternativ Über das Modul-Control folgende URL hinzufügen.
https://github.com/Wilkware/IPSymconPollinationodergit://github.com/Wilkware/IPSymconPollination.git
4. Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" ist das 'Pollen Count'-Modul (Alias: Pollenflug) unter dem Hersteller '(Geräte)' aufgeführt.
Konfigurationsseite:
Einstellungsbereich:
Örtliche und zeitliche Einstellungen ...
| Name | Beschreibung |
|---|---|
| Bundesland | Auswahl des Bundesland für welchen man die den Gefahrenindex haben möchte. |
| Region | Auswahl der Teilregion innerhalb des Bundeslandes. |
| Anzahl darzustellende Tage | Anzahl der vorhergesagten Tage (1-3 Tage). HINWEIS: Viele Regionen liefern nur Daten für 2 Tage! |
Formatvorlagen (CSS) ...
| Name | Beschreibung |
|---|---|
| 3D Farbverlauf für Tabellenkopf verwenden? | Verwendet einen transparenten Gradienten zur 3D Darstellung |
| Tabelle [table] | Allgemeine Tabellenstyle (Schrift, Farbe, Hintergrund) |
| Tabllenkopf [thead] | Style des Tabellenkopfs (Schrift, Farbe, Hintergrund) |
| Tabellenzellen [th,td] | Allgemeiner Style für alle Zellen |
| Letzte Zeile [tr:last-child] | Style für letzte Zeile (z.b: Rahmen links, rechts, unten) |
| Alternierende Zeile [tr:nth-child(even)] | Style für gerade Zeile (z.b: Hintergrundfarbe) |
| Erste Zelle [td:first-child] | Style für erste Zelle einer Zeile (z.b: Rahmen links) |
| Mittlere Zellen [td:not(:first-child):not(:last-child)] | Style für mittlere Zellen einer Zeile (z.b: keinen Rahmen) |
| Letzte Zelle [td:last-child] | Style für letzte Zelle einer Zeile (z.b: Rahmen rechts) |
| Wochentag [div.day] | Style für den Wochentagsnamen |
| Tag des Monats [div.num] | Style für den Monatstag (z.b. groß & farbig) |
| Monatsname [div.mon] | Style für den Monatsnamen (z.b. alles Grossbuschtaben) |
Erweiterte Einstellungen ...
| Name | Beschreibung |
|---|---|
| Variable für Tageshinweis anlegen? | Schalter, ob der tägliche Tageshinweis (Text) angelegt und aktualisiert werden soll. |
| Variable für Graphische Vorhersage anlegen? | Schalter, ob die graphische Vorhersage (HTMLBox) angelegt und aktualisiert werden soll. |
| Variable für Bildlink auf gesamtdeutschen Pollenflugkalender anlegen? | Schalter, ob ein statischer Link (HTMLBox) zum Übersichtsbild erzeugt werden soll. |
| Variablen für die Auswahl der lokalen und zeitlichen Einstellungen anlegen (überschreibt die Modulkonfiguration)? | Schalter, ob die zeitliche und rgionale Konfiguration über Statusvariablen im Webfront überschrieben werden dürfen. |
| Tägliche Aktualisierung aktivieren? | Schalter, ob das tägliche Update aktiv oder inaktiv ist. DWD aktualisiert die Daten immer 11:00 Uhr. Das Modul holt die Daten immer 15 Minuten später (11:15 Uhr) ab. |
Aktionsbereich:
Gefahrenindex ...
| Aktion | Beschreibung |
|---|---|
| AKTUALISIEREN | Ermittelt für das aktuelle Datum den Gefahrenindex (Update) |
5. Statusvariablen und Profile
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 |
| Tageshinweis | String | Textuelle Zusammenfassung der Vorhersage |
| Vorhersage | String | Graphische Repräsentation des Gefahrenindex in Abhängigkeit der gewählten darzustellenden Tage |
| Jahreskalender | String | statischer Link zum Übersichtsbild |
| 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 |
Folgende Profile werden angelegt:
| Name | Typ | Beschreibung |
|---|---|---|
| POLLEN.States | Integer | Bundesländer (10 - 120) |
| POLLEN.10 | Integer | Regionen (11,12) |
| POLLEN.20 | Integer | Regionen (-1) |
| POLLEN.30 | Integer | Regionen (31,32) |
| POLLEN.40 | Integer | Regionen (41,42,43) |
| POLLEN.50 | Integer | Regionen (-1) |
| POLLEN.60 | Integer | Regionen (61,62) |
| POLLEN.70 | Integer | Regionen (71,72) |
| POLLEN.80 | Integer | Regionen (81,82) |
| POLLEN.90 | Integer | Regionen (91,92) |
| POLLEN.100 | Integer | Regionen (101,102,103) |
| POLLEN.110 | Integer | Regionen (111,112,113) |
| POLLEN.120 | Integer | Regionen (121,122,123,124) |
| POLLEN.Days | Integer | 1, 2 oder 3 Tage |
6. WebFront
Man kann die Statusvariablen direkt im WF 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
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
