{"id":15033144,"url":"https://github.com/bundesapi/deutschland","last_synced_at":"2025-05-14T03:03:30.609Z","repository":{"id":40759345,"uuid":"389776420","full_name":"bundesAPI/deutschland","owner":"bundesAPI","description":"Die wichtigsten APIs Deutschlands in einem Python Paket.","archived":false,"fork":false,"pushed_at":"2024-10-19T22:54:31.000Z","size":64601,"stargazers_count":1258,"open_issues_count":35,"forks_count":68,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-03-01T17:49:12.242Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bundesAPI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-26T21:48:37.000Z","updated_at":"2025-02-14T10:18:38.000Z","dependencies_parsed_at":"2024-01-14T07:11:36.612Z","dependency_job_id":"0a1bc893-1dae-4224-9fa4-9298b30f8206","html_url":"https://github.com/bundesAPI/deutschland","commit_stats":{"total_commits":175,"total_committers":21,"mean_commits":8.333333333333334,"dds":0.56,"last_synced_commit":"fee7dedd707d659e40dfeb5db35f91d7827224b4"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bundesAPI%2Fdeutschland","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bundesAPI%2Fdeutschland/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bundesAPI%2Fdeutschland/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bundesAPI%2Fdeutschland/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bundesAPI","download_url":"https://codeload.github.com/bundesAPI/deutschland/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245474870,"owners_count":20621488,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest"],"created_at":"2024-09-24T20:20:13.530Z","updated_at":"2025-03-25T13:44:23.562Z","avatar_url":"https://github.com/bundesAPI.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![PyPI version deutschland](https://badge.fury.io/py/deutschland.svg)](https://pypi.python.org/pypi/deutschland/)\n[![GitHub license](https://img.shields.io/github/license/bundesAPI/deutschland.svg)](https://github.com/bundesAPI/deutschland/blob/main/LICENSE)\n\n[![Lint](https://github.com/bundesAPI/deutschland/actions/workflows/black.yml/badge.svg?branch=main)](https://github.com/bundesAPI/deutschland/actions/workflows/black.yml)\n[![Publish Python 🐍 distributions 📦 to PyPI and TestPyPI](https://github.com/bundesAPI/deutschland/actions/workflows/publish.yml/badge.svg?branch=main)](https://github.com/bundesAPI/deutschland/actions/workflows/publish.yml)\n[![Run Python 🐍 tests](https://github.com/bundesAPI/deutschland/actions/workflows/runtests.yml/badge.svg?branch=main)](https://github.com/bundesAPI/deutschland/actions/workflows/runtests.yml)\n\n# Deutschland\nA python package that gives you easy access to the most valuable datasets of Germany.\n\n## Installation\n```bash\npip install deutschland\n```\n\n### Supported Python Versions\n```\n3.8 - 3.12\n```\nTested on Linux, MacOS and Windows \n\n[![Run Python 🐍 tests](https://github.com/bundesAPI/deutschland/actions/workflows/runtests.yml/badge.svg?branch=main)](https://github.com/bundesAPI/deutschland/actions/workflows/runtests.yml)\n\n\n### Development\nFor development poetry version `\u003e=1.2.0` is required.\n\n## Geographic data\nFetch information about streets, house numbers, building outlines, …\n\n```python\nfrom deutschland.geo import Geo\ngeo = Geo()\n# top_right and bottom_left coordinates\ndata = geo.fetch([52.530116236589244, 13.426532801586827],\n                 [52.50876180448243, 13.359631043007212])\nprint(data.keys())\n# dict_keys(['Adresse', 'Barrierenlinie', 'Bauwerksflaeche', 'Bauwerkslinie', 'Bauwerkspunkt', 'Besondere_Flaeche', 'Besondere_Linie', 'Besonderer_Punkt', 'Gebaeudeflaeche', 'Gebaeudepunkt', 'Gewaesserflaeche', 'Gewaesserlinie', 'Grenze_Linie', 'Historischer_Punkt', 'Siedlungsflaeche', 'Vegetationslinie', 'Verkehrsflaeche', 'Verkehrslinie', 'Verkehrspunkt', 'Hintergrund'])\n\nprint(data[\"Adresse\"][0])\n# {'geometry': {'type': 'Point', 'coordinates': (13.422642946243286, 52.51500157651358)}, 'properties': {'postleitzahl': '10179', 'ort': 'Berlin', 'ortsteil': 'Mitte', 'strasse': 'Holzmarktstraße', 'hausnummer': '55'}, 'id': 0, 'type': 'Feature'}\n```\nFor the detailed documentation of this API see [here](https://dev.adv-smart.de/docs/dokumentation/web_vektor_datenmodell.html)\n\nThe data is provided by the [AdV SmartMapping](https://dev.adv-smart.de/). The team consists of participants from the German state surveying offices, the Federal Agency for Cartography and Geodesy (BKG), the German Federal Armed Forces (Bundeswehr ZGeoBW) and third parties from research and education.\n\n\n## Company Data\n\n### Bundesanzeiger\nGet financial reports for all german companies that are reporting to Bundesanzeiger.\nMore\n```python\nfrom deutschland.bundesanzeiger import Bundesanzeiger\nba = Bundesanzeiger()\n# search term\ndata = ba.get_reports(\"Deutsche Bahn AG\")\n# returns a dictionary with all reports found as fulltext reports\nprint(data.keys())\n# dict_keys(['Jahresabschluss zum Geschäftsjahr vom 01.01.2020 bis zum 31.12.2020', 'Konzernabschluss zum Geschäftsjahr vom 01.01.2020 bis zum 31.12.2020\\nErgänzung der Veröffentlichung vom 04.06.2021',\n```\n*Big thanks to [Nico Duldhardt](https://github.com/2start) and [Friedrich Eichenroth](https://github.com/eichenroth), who [supported this implementation with their machine learning model](https://av.tib.eu/media/52366).*\n\n### Handelsregister\n\nThe code for the Handelsregister moved to this [repo](https://github.com/bundesAPI/handelsregister).\n\n## Consumer Protection Data\n\n### Lebensmittelwarnung\nGet current product warnings provided by the german federal portal lebensmittelwarnung.de.\n\n```python\nfrom deutschland.lebensmittelwarnung import Lebensmittelwarnung\nlw = Lebensmittelwarnung()\n# search by content type and region, see documetation for all available params\ndata = lw.get(\"lebensmittel\", \"berlin\")\nprint(data)\n# [{'id': 19601, 'guid': 'https://www.lebensmittelwarnung.de/bvl-lmw-de/detail/lebensmittel/19601', 'pubDate': 'Fri, 10 Feb 2017 12:28:45 +0000', 'imgSrc': 'https://www.lebensmittelwarnung.de/bvl-lmw-de/opensaga/attachment/979f8cd3-969e-4a6c-9a8e-4bdd61586cd4/data.jpg', 'title': 'Sidroga Bio Säuglings- und Kindertee', 'manufacturer': 'Lebensmittel', 'warning': 'Pyrrolizidinalkaloide', 'affectedStates': ['Baden-Württemberg', '...']}]\n```\n\n## Federal Job Openings\n\n### NRW\n\n#### VERENA\nGet open substitute teaching positions in NRW from https://www.schulministerium.nrw.de/BiPo/Verena/angebote\n```python\nfrom deutschland.verena import Verena\nv = Verena()\ndata = v.get()\nprint(data)\n# a full example data can be found at deutschland/verena/example.md\n# [{ \"school_id\": \"99999\", \"desc\": \"Eine Schule\\nSchule der Sekundarstufe II\\ndes Landkreis Schuling\\n9999 Schulingen\", \"replacement_job_title\": \"Lehrkraft\", \"subjects\": [ \"Fach 1\", \"Fach 2\" ], \"comments\": \"Bemerkung zur Stelle: Testbemerkung\", \"duration\": \"01.01.2021 - 01.01.2022\", ...} ...]\n```\n\n## Autobahn\n\nGet data from the Autobahn.\n\n```python\nfrom deutschland import autobahn\nfrom deutschland.autobahn.api import default_api\n\nfrom pprint import pprint\n\nautobahn_api_instance = default_api.DefaultApi()\n\ntry:\n    # Auflistung aller Autobahnen\n    api_response = autobahn_api_instance.list_autobahnen()\n    pprint(api_response)\n\n    # Details zu einer Ladestation\n    station_id = \"RUxFQ1RSSUNfQ0hBUkdJTkdfU1RBVElPTl9fMTczMzM=\"  # str |\n    api_response = autobahn_api_instance.get_charging_station(station_id)\n    pprint(api_response)\n\nexcept autobahn.ApiException as e:\n    print(\"Exception when calling DefaultApi-\u003eget_charging_station: %s\\n\" % e)\n```\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/autobahn/README.md)\n\n### Presseportal\n\nNot available for now due to changes in the API.\n\n## Auto-Generated API-Clients\n\n### bundesrat\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/bundesrat/README.md)\n### bundestag\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/bundestag/README.md)\n### destatis\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/destatis/README.md)\n### dwd\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/dwd/README.md)\n### interpol\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/interpol/README.md)\n### jobsuche\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/jobsuche/README.md)\n### ladestationen\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/ladestationen/README.md)\n### mudab\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/mudab/README.md)\n### nina\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/nina/README.md)\n### polizei_brandenburg\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/polizei_brandenburg/README.md)\n### risikogebiete\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/risikogebiete/README.md)\n### smard\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/smard/README.md)\n### strahlenschutz\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/strahlenschutz/README.md)\n### travelwarning\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/travelwarning/README.md)\n### zoll\nFor the detailed documentation of this API see [here](https://github.com/bundesAPI/deutschland/blob/main/docs/zoll/README.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbundesapi%2Fdeutschland","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbundesapi%2Fdeutschland","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbundesapi%2Fdeutschland/lists"}