{ "info": { "author": "Max Rosin", "author_email": "git@hackrid.de", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# DWD Pollen API Client\n\nThe DWD (Deutscher Wetterdienst) publishes information about the current and future pollen load in Germany.\nThe data is published as an [JSON endpoint](https://opendata.dwd.de/climate_environment/health/alerts/s31fg.json) and documented in this [German PDF](https://opendata.dwd.de/climate_environment/health/alerts/Beschreibung_pollen_s31fg.pdf).\n\n## Install\n```angular2html\npip install dwdpollen\n```\n\n## `region_id` and `partregion_id`\nThe API uses the `region_id` and `partregion_id` to identify the different regions in Germany. The following regions are available:\n\n```\nSchleswig-Holstein und Hamburg (region_id: 10): Inseln und Marschen (partregion_id: 11)\nSchleswig-Holstein und Hamburg (region_id: 10): Geest, Schleswig-Holstein und Hamburg (partregion_id: 12)\n\nMecklenburg-Vorpommern (region_id: 20, partregion_id: -1)\n\nNiedersachsen und Bremen (region_id: 30): Westl. Niedersachsen/Bremen (partregion_id: 31)\nNiedersachsen und Bremen (region_id: 30): \u00d6stl. Niedersachsen (partregion_id: 32)\n\nNordrhein-Westfalen (region_id: 40): Rhein.-Westf\u00e4l. Tiefland (partregion_id: 41)\nNordrhein-Westfalen (region_id: 40): Ostwestfalen (partregion_id: 42)\nNordrhein-Westfalen (region_id: 40): Mittelgebirge NRW (partregion_id: 43)\n\nBrandenburg und Berlin (region_id: 50, partregion_id: -1)\n\nSachsen-Anhalt (region_id: 60): Tiefland Sachsen-Anhalt (partregion_id: 61)\nSachsen-Anhalt (region_id: 60): Harz (partregion_id: 62)\n\nTh\u00fcringen (region_id: 70): Tiefland Th\u00fcringen (partregion_id: 71)\nTh\u00fcringen (region_id: 70): Mittelgebirge Th\u00fcringen (partregion_id: 72)\n\nSachsen (region_id: 80): Tiefland Sachsen (partregion_id: 81)\nSachsen (region_id: 80): Mittelgebirge Sachsen (partregion_id: 82)\n\nHessen (region_id: 90): Nordhessen und hess. Mittelgebirge (partregion_id: 91)\nHessen (region_id: 90): Rhein-Main (partregion_id: 92)\n\nRheinland-Pfalz und Saarland (region_id: 100): Saarland (partregion_id: 103)\nRheinland-Pfalz und Saarland (region_id: 100): Rhein, Pfalz, Nahe und Mosel (partregion_id: 101)\nRheinland-Pfalz und Saarland (region_id: 100): Mittelgebirgsbereich Rheinland-Pfalz (partregion_id: 102)\n\nBaden-W\u00fcrttemberg (region_id: 110): Oberrhein und unteres Neckartal (partregion_id: 111)\nBaden-W\u00fcrttemberg (region_id: 110): Hohenlohe/mittlerer Neckar/Oberschwaben (partregion_id: 112)\nBaden-W\u00fcrttemberg (region_id: 110): Mittelgebirge Baden-W\u00fcrttemberg (partregion_id: 113)\n\nBayern (region_id: 120): Allg\u00e4u/Oberbayern/Bay. Wald (partregion_id: 121)\nBayern (region_id: 120): Donauniederungen (partregion_id: 122)\nBayern (region_id: 120): Bayern n. der Donau, o. Bayr. Wald, o. Mainfranken (partregion_id: 123)\nBayern (region_id: 120): Mainfranken (partregion_id: 124)\n\n```\n\n## Usage\n\nThe 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.\n\n```\nimport dwdpollen\napi = dwdpollen.DwdPollenApi()\napi.get_pollen(50, -1)\n\n{'region_id': 50,\n 'region_name': 'Brandenburg und Berlin ',\n 'partregion_id': -1,\n 'partregion_name': '',\n 'last_update': datetime.datetime(2019, 4, 18, 11, 0),\n 'next_update': datetime.datetime(2019, 4, 19, 11, 0),\n 'pollen': {'Graeser': {'2019-04-19': {'value': 0.0,\n 'raw': '0',\n 'human': 'keine Belastung'},\n '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},\n 'Roggen': {'2019-04-19': {'value': 0.0,\n 'raw': '0',\n 'human': 'keine Belastung'},\n '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},\n 'Hasel': {'2019-04-19': {'value': 0.0,\n 'raw': '0',\n 'human': 'keine Belastung'},\n '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},\n 'Beifuss': {'2019-04-19': {'value': 0.0,\n 'raw': '0',\n 'human': 'keine Belastung'},\n '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},\n 'Esche': {'2019-04-19': {'value': 2.0,\n 'raw': '2',\n 'human': 'mittlere Belastung'},\n '2019-04-20': {'value': 2.0, 'raw': '2', 'human': 'mittlere Belastung'}},\n 'Birke': {'2019-04-19': {'value': 3.0,\n 'raw': '3',\n 'human': 'hohe Belastung'},\n '2019-04-20': {'value': 3.0, 'raw': '3', 'human': 'hohe Belastung'}},\n 'Erle': {'2019-04-19': {'value': 0.0,\n 'raw': '0',\n 'human': 'keine Belastung'},\n '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}},\n 'Ambrosia': {'2019-04-19': {'value': 0.0,\n 'raw': '0',\n 'human': 'keine Belastung'},\n '2019-04-20': {'value': 0.0, 'raw': '0', 'human': 'keine Belastung'}}}}\n\n```\n\n## License\ndwdpollen - API client for the \"Deutscher Wetterdienst\" to get the current pollen load in Germany\nCopyright (C) 2019 Max Rosin\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program. If not, see .\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ekeih/dwdpollen", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "dwdpollen", "package_url": "https://pypi.org/project/dwdpollen/", "platform": "", "project_url": "https://pypi.org/project/dwdpollen/", "project_urls": { "Homepage": "https://github.com/ekeih/dwdpollen" }, "release_url": "https://pypi.org/project/dwdpollen/0.1.0/", "requires_dist": [ "requests", "pytz" ], "requires_python": "", "summary": "API client for the \"Deutscher Wetterdienst\" to get the current pollen load in Germany", "version": "0.1.0" }, "last_serial": 5162431, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "9658150f128ee601bd2855153d2c0ab9", "sha256": "4c937e4fbb3dc835b597c8ddd881afab3e4ce0a1ac5d14e5b985749b56e4de4a" }, "downloads": -1, "filename": "dwdpollen-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "9658150f128ee601bd2855153d2c0ab9", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17406, "upload_time": "2019-04-18T22:40:01", "url": "https://files.pythonhosted.org/packages/98/90/ff23e251aca73291bf6ff36b5c756874abf807509d149bda028dca54ba5c/dwdpollen-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e5eb600512fc77d98e90c686c6183723", "sha256": "db080f67c6a518b91bfb54a60dda5afc735d32b4d01949a1baa109dddb0d47c6" }, "downloads": -1, "filename": "dwdpollen-0.1.0.tar.gz", "has_sig": false, "md5_digest": "e5eb600512fc77d98e90c686c6183723", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4622, "upload_time": "2019-04-18T22:40:03", "url": "https://files.pythonhosted.org/packages/5e/f4/5174a7ca9d919f4c74679d75545d468def716132cc4b0ee061124b71dda1/dwdpollen-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9658150f128ee601bd2855153d2c0ab9", "sha256": "4c937e4fbb3dc835b597c8ddd881afab3e4ce0a1ac5d14e5b985749b56e4de4a" }, "downloads": -1, "filename": "dwdpollen-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "9658150f128ee601bd2855153d2c0ab9", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17406, "upload_time": "2019-04-18T22:40:01", "url": "https://files.pythonhosted.org/packages/98/90/ff23e251aca73291bf6ff36b5c756874abf807509d149bda028dca54ba5c/dwdpollen-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e5eb600512fc77d98e90c686c6183723", "sha256": "db080f67c6a518b91bfb54a60dda5afc735d32b4d01949a1baa109dddb0d47c6" }, "downloads": -1, "filename": "dwdpollen-0.1.0.tar.gz", "has_sig": false, "md5_digest": "e5eb600512fc77d98e90c686c6183723", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4622, "upload_time": "2019-04-18T22:40:03", "url": "https://files.pythonhosted.org/packages/5e/f4/5174a7ca9d919f4c74679d75545d468def716132cc4b0ee061124b71dda1/dwdpollen-0.1.0.tar.gz" } ] }