Ergänzung Abruf archivierter MOWAS-Meldungen und Korrektur der Gebietsschlüsselbezeichnungen

bundesAPI / nina-api

Erhalten Sie wichtige Warnmeldungen des Bevölkerungsschutzes für Gefahrenlagen wie zum Beispiel Gefahrstoffausbreitung oder Unwetter per Programmierschnittstelle.

https://nina.api.bund.dev/

78 stars 5 forks source link

Ergänzung Abruf archivierter MOWAS-Meldungen und Korrektur der Gebietsschlüsselbezeichnungen #19

Closed buEtz closed 1 year ago

buEtz commented 1 year ago

Alle MOWAS-Meldungen werden archiviert, Abruf der Historie einer Meldung, sowie Abruf der jeweiligen Archiv-Meldungen wurden ergänzt
Bei dem bisher als "Amtlicher Gebietsschlüssel" bezeichneten 12 stelligen Identifier handelt es sich korrekterweise um den "Amtlichen Regionalschlüssel", die Bezeichnungen wurden diesbezüglich angepasst.

t-huyeng commented 1 year ago

Sieht interessant aus! Danke fürs dokumentieren.

Off-topic: Weißt du ob alle alte MoWaS-Meldungen abrufbar sind? Ich hab einen Identifier aus 2021 versucht und konnte leider keine Meldungen finden.

buEtz commented 1 year ago

Habe noch nicht ausprobiert, wie weit das Archiv zurückreicht, aber wichtig ist, dass die genauen Einzelmeldungen nur mit angefügtem Zeitstempel abgerufen werden können. Die Übersicht zu der entsprechenden Meldung müsste aber zuerst mit dem "-mapping.json" abgerufen werden können, hast du das mal ausprobiert?

t-huyeng commented 1 year ago

Ich hab es zum Beispiel hiermit versucht: DE-NW-MK-SE095-20210714-95-000 ->

https://warnung.bund.de/api31/archive.mowas/mow.DE-NW-MK-SE095-20210714-95-000-mapping.json
https://warnung.bund.de/api31/archive.mowas/mow.DE-NW-MK-SE095-20210714-000-mapping.json haben leider nicht funktioniert.

Einer Meldung im Rahmen des Hochwasser im Juli 2021.

t-huyeng commented 1 year ago

Bezüglich des Amtlicher Gebietsschlüssel bzw. des Amtlichen Regionalschlüssel kann sich vielleicht noch jemand äußern der etwas mehr im Thema drin ist? Info zum Regionalschlüssel: https://www.destatis.de/DE/Themen/Laender-Regionen/Regionales/Gemeindeverzeichnis/Glossar/regionalschluessel.html

This change would also be a breaking change in the Python package since it changes the method names as far as I know.

@wirthual what do you think? Should we change the name and risk those changes in the Python code? Can we add a separate version for this new package?

buEtz commented 1 year ago

Der hier neu dokumentierte Abruf von Meldungen aus dem MOWAS-Archiv gilt ausschließlich für Meldungen ab dem 06. bzw. zuverlässig ab dem 07.10.2021.

Kann dann vielleicht auch noch in der entsprechenden Description ergänzt werden.

t-huyeng commented 1 year ago

Nach meinem Verständnis ersetzt der Amtliche Regionalschlüssel (ARS) den Amtlichen Gemeindeschlüssel (AGS) (siehe https://docs.fitko.de/fit-connect/docs/details/ars).

Auch die in der OpenAPI verlinkte Liste des Statistischen Bundesamtes (https://www.xrepository.de/api/xrepository/urn:de:bund:destatis:bevoelkerungsstatistik:schluessel:rs_2021-07-31/download/Regionalschl_ssel_2021-07-31.json) verwendet in der Beschreibung den Amtlichen Regionalschlüssel (ARS).

Die in diesem PR vorgenommenen Änderungen sind daher m.E. sinnvoll, auch wenn dies eine Änderung des Python-Codes bedeutet.