# DWD Pollenflug Binding

The "Deutsche Wetterdienst" (DWD) reports the current pollen count index for Germany on a daily base and a forecast for tomorrow and the day after tomorrow. This binding allows you to retrieve this data for your region or partregion. You can find a map of the data here (opens new window)

# Supported Things

This binding supports a bridge thing (bridge), which polls the dataset for Germany in an adjustable interval. And it supports a region thing (region), representing the data for all pollen types of a region or partregion.

# Discovery

This binding adds a default bridge thing to the Inbox. This can be used for region things you may add manually.

# Thing Configuration

# Bridge

Parameter	Default	Required	Description
`refresh`	30	no	Define the interval for polling the data from DWD in minutes. Minimum is 15 minutes.

# Region

Parameter	Default	Required	Description
`regionID`	-	yes	The id of the region. The available options are in the table below.

# Manual region or partregion selection

The region ID is the partregion_id or if there is no partregion the region_id from this json (opens new window) of DWD. You can refer to the following table.

regionID	Region	Partregion
11	Schleswig-Holstein und Hamburg	Inseln und Marschen
12	Schleswig-Holstein und Hamburg	Geest, Schleswig-Holstein und Hamburg
20	Mecklenburg-Vorpommern	-
31	Niedersachsen und Bremen	Westl. Niedersachsen/Bremen
32	Niedersachsen und Bremen	Östl. Niedersachsen
41	Nordrhein-Westfalen	Rhein.-Westfäl. Tiefland
42	Nordrhein-Westfalen	Ostwestfalen
43	Nordrhein-Westfalen	Mittelgebirge NRW
50	Brandenburg und Berlin	-
61	Sachsen-Anhalt	Tiefland Sachsen-Anhalt
62	Sachsen-Anhalt	Harz
71	Thüringen	Tiefland Thüringen
72	Thüringen	Mittelgebirge Thüringen
81	Sachsen	Tiefland Sachsen
82	Sachsen	Mittelgebirge Sachsen
91	Hessen	Nordhessen und hess. Mittelgebirge
92	Hessen	Rhein-Main
101	Rheinland-Pfalz und Saarland	Rhein, Pfalz, Nahe und Mosel
102	Rheinland-Pfalz und Saarland	Mittelgebirgsbereich Rheinland-Pfalz
103	Rheinland-Pfalz und Saarland	Saarland
111	Baden-Württemberg	Oberrhein und unteres Neckartal
112	Baden-Württemberg	Hohenlohe/mittlerer Neckar/Oberschwaben
113	Baden-Württemberg	Mittelgebirge Baden-Württemberg
121	Bayern	Allgäu/Oberbayern/Bay. Wald
122	Bayern	Donauniederungen
123	Bayern	Bayern n. der Donau, o. Bayr. Wald, o. Mainfranken
124	Bayern	Mainfranken

# Channels

The bridge thing has following channels:

channel	description
`updates#refreshed`	Hold the time of the bridge's last refresh
`updates#last_update`	The time when data was last updated by DWD
`updates#next_update`	The time when data will be updated next by DWD

For each of the eight pollen types reported by DWD the region thing has three channels for today, tomorrow and the day after tomorrow.

channels	pollen type	german name
`alder#today`	alder	Erle
`alder#tomorrow`
`alder#dayafter_to`
`ambrosia#today`	ambrosia	Ambrosia
`ambrosia#tomorrow`
`ambrosia#dayafter_to`
`ash#today`	ash-tree	Esche
`ash#tomorrow`
`ash#dayafter_to`
`birch#today`	birch	Birke
`birch#tomorrow`
`birch#dayafter_to`
`grasses#today`	grasses	Gräser
`grasses#tomorrow`
`grasses#dayafter_to`
`hazel#today`	hazel	Hasel
`hazel#tomorrow`
`hazel#dayafter_to`
`mugwort#today`	mugwort	Beifuß
`mugwort#tomorrow`
`mugwort#dayafter_to`
`rye#today`	rye	Roggen
`rye#tomorrow`
`rye#dayafter_to`

There are the following possible string values:

value	description
-1	not specified
0	no pollen pollution
0-1	no to low pollen count
1	low pollen count
1-2	low to medium pollen count
2	medium pollen count
2-3	medium to high pollen count
3	high pollen count

# Full Example

# Things file for region "Brandenburg und Berlin" and partregion "Bayern - Mainfranken"

Bridge dwdpollenflug:bridge:dwd "DWD pollen count Bridge" [refresh="15"] {
    Thing region region50 "DWD pollen count region" @ "APIS" [regionID="50"]
    Thing region partregion124 "DWD pollen count partregion" @ "APIS" [regionID="124"]
}

# Items example for region "Brandenburg und Berlin" and pollen type ash-tree

String pollenTodayEsche
    "Esche [MAP(pollen.map):%s]"
    {channel="dwdpollenflug:region:dwd:region50:ash#today"}

String pollenTomorrowEsche
    "Esche morgen [MAP(pollen.map):%s]"
    {channel="dwdpollenflug:region:dwd:region50:ash#tomorrow"}

String pollenDayAfterTomorrowEsche
    "Esche übermorgen [MAP(pollen.map):%s]"
    {channel="dwdpollenflug:region:dwd:region50:ash#dayafter_to"}

# Transform map file pollen.map

0=keine (0)
0-1=keine bis gering (0-1)
1=gering (1)
1-2=gering bis mittel (1-2)
2=mittel (2)
2-3=mittel bis hoch (2-3)
3=hoch (3)
-1=keine Daten
-=keine Daten
NULL=keine Daten

# Sitemap example for region "Brandenburg und Berlin" and pollen type ash-tree

Text label="Pollenflugindex" {
    Frame {
        Text item=pollenTodayEsche
            valuecolor=[=="3"="#f00014",
                        =="2-3"="#f00014",
                        =="2"="#ff9900",
                        =="1-2"="#ff9900",
                        =="1"="#ffff00",
                        =="0-1"="#00c83c"] {
            Frame {
                Text item=pollenTodayEsche
                    valuecolor=[=="3"="#f00014",
                                =="2-3"="#f00014",
                                =="2"="#ff9900",
                                =="1-2"="#ff9900",
                                =="1"="#ffff00",
                                =="0-1"="#00c83c"]

                Text item=pollenTomorrowEsche
                    valuecolor=[=="3"="#f00014",
                                =="2-3"="#f00014",
                                =="2"="#ff9900",
                                =="1-2"="#ff9900",
                                =="1"="#ffff00",
                                =="0-1"="#00c83c"]

                Text item=pollenDayAfterTomorrowEsche
                    valuecolor=[=="3"="#f00014",
                                =="2-3"="#f00014",
                                =="2"="#ff9900",
                                =="1-2"="#ff9900",
                                =="1"="#ffff00",
                                =="0-1"="#00c83c"]
            }
        }
    }
}

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)

← DSMR DWD Unwetter →