Skip to content
This repository has been archived by the owner on Jun 22, 2022. It is now read-only.

ekeih/dwdpollen

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

DWD Pollen API Client

PyPI version

The DWD (Deutscher Wetterdienst) publishes information about the current and future pollen load in Germany. The data is published as an JSON endpoint and documented in this German PDF.

Install

pip install dwdpollen

region_id and partregion_id

The API uses the region_id and partregion_id to identify the different regions in Germany. The following regions are available:

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

Usage

The API will return the data on a best effort basis. There is no guarantee which dates exist in the result. Mostly the current and the next day are available and on Friday after 11 AM the data for Sunday should be available. But there is no guarantee, so the caller has to check the result itself. What? Yes... it sounds strange... but usually the DWD updates the API result everyday at 11 AM and on Friday the forecast for Sunday is included.

import dwdpollen
api = dwdpollen.DwdPollenApi()
api.get_pollen(50, -1)
{'region_id': 50,
 'region_name': 'Brandenburg und Berlin ',
 'partregion_id': -1,
 'partregion_name': '',
 'last_update': datetime.datetime(2019, 4, 18, 11, 0),
 'next_update': datetime.datetime(2019, 4, 19, 11, 0),
 'pollen': {'Graeser': {'2019-04-19': {'value': 0.0,
    'raw': '0',
    'human': 'keine Belastung'},
   '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},
  'Roggen': {'2019-04-19': {'value': 0.0,
    'raw': '0',
    'human': 'keine Belastung'},
   '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},
  'Hasel': {'2019-04-19': {'value': 0.0,
    'raw': '0',
    'human': 'keine Belastung'},
   '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},
  'Beifuss': {'2019-04-19': {'value': 0.0,
    'raw': '0',
    'human': 'keine Belastung'},
   '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},
  'Esche': {'2019-04-19': {'value': 2.0,
    'raw': '2',
    'human': 'mittlere Belastung'},
   '2019-04-20': {'value': 2.0, 'raw': '2', 'human': 'mittlere Belastung'}},
  'Birke': {'2019-04-19': {'value': 3.0,
    'raw': '3',
    'human': 'hohe Belastung'},
   '2019-04-20': {'value': 3.0, 'raw': '3', 'human': 'hohe Belastung'}},
  'Erle': {'2019-04-19': {'value': 0.0,
    'raw': '0',
    'human': 'keine Belastung'},
   '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},
  'Ambrosia': {'2019-04-19': {'value': 0.0,
    'raw': '0',
    'human': 'keine Belastung'},
   '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}}}}

License

dwdpollen - API client for the "Deutscher Wetterdienst" to get the current pollen load in Germany Copyright (C) 2019 Max Rosin

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

About

API client for the "Deutscher Wetterdienst" to get the current pollen load in Germany

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages