API Dokumentation

Waldbrandgefahrenstufen API Dokumentation

Die Waldbrandgefahrenstufen API bietet Zugriff auf aktuelle Informationen zur Waldbrandgefahr in den Bundesländern Brandenburg und Mecklenburg-Vorpommern. Die Daten werden über zwei Quellen bezogen:

• Brandenburg: Das Ministerium für Landwirtschaft, Umwelt und Klimaschutz (MLUK) des Landes Brandenburg stellt täglich eine allgemeine Karte sowie eine XML-Datei mit den aktuellen Waldbrandgefahrenstufen bereit.
• Mecklenburg-Vorpommern: Der Landesforst Mecklenburg-Vorpommern veröffentlicht täglich Waldbrandgefahrenstufen für die Hauptforstämter, wobei eine Übersichtskarte sowie ein GeoWebDienst zur Verfügung stehen.

Hinweis: Die in der Datenbank gespeicherten Daten werden alle 2 Stunden abgerufen – in den jeweiligen Quellen werden die Daten meist einmal täglich, meist morgens, aktualisiert. In den Wintermonaten werden zwar keine tagesaktuellen Daten veröffentlicht, dennoch kann eine erhöhte Gefahr für Waldbrände bestehen.

Authentifizierung

Jeder API-Aufruf muss den Parameter api_key enthalten. Wird dieser Parameter nicht mitgegeben oder ist er ungültig, erfolgt die Rückgabe einer Fehlermeldung.

?api_key=DEIN_API_KEY

Parameter und Filter

Zusätzlich zur Authentifizierung können optionale GET-Parameter zur Filterung der abgefragten Daten verwendet werden:

• bundesland: Filtert die Daten nach Bundesland (z. B. "Brandenburg" oder "Mecklenburg-Vorpommern").
• ort: Filtert die Datensätze nach dem Ort.

Ausgabeformate

Standardmäßig liefert die Waldbrandgefahrenstufen API Daten im JSON-Format. Über den Parameter format kann das Ausgabeformat angepasst werden:

• json (Standard): ?format=json
• xml: ?format=xml
• csv: ?format=csv
• jsonp: ?format=jsonp&callback=DEIN_CALLBACK

Beispielaufruf

Beispielaufruf zur Abfrage der Waldbrandgefahrenstufen für das Bundesland Brandenburg:

https://api.ix23.de/waldbrandgefahrenstufen/?api_key=DEIN_API_KEY&bundesland=Brandenburg&format=json

Beispielaufruf zur Abfrage für einen bestimmten Ort:

https://api.ix23.de/waldbrandgefahrenstufen/?api_key=DEIN_API_KEY&ort=Potsdam&format=json

Fehlerbehandlung

Bei fehlerhaften oder unvollständigen Parametern gibt die API eine entsprechende Fehlermeldung zurück. Beispiele:

{
  "error": "API key missing (API-Schlüssel fehlt)"
}

{
  "error": "Invalid parameters (Ungültige Parameter)"
}