Zum Hauptinhalt springen
Schweizerische EidgenossenschaftConfédération suisseConfederazione SvizzeraConfederaziun svizraBundesamt für Umwelt BAFUOpen Data (OGD)

Quickstart

Umweltdaten des Bundesamts für Umwelt (BAFU) sind als offene Daten (Open Data / OGD) über diese Plattform öffentlich und frei verfügbar. Die Daten lassen sich über eine API abfragen und in eigene Anwendungen integrieren. Alternativ werden die Daten für einzelne Datensätze auch als vorbereitete Dateien zum Download angeboten.

API​

Das BAFU verfügt über zahlreiche Datensätze, die sukzessive auf dieser Plattform veröffentlicht werden. Damit die Schnittstelle nicht bei jeder neuen Veröffentlichung angepasst werden muss, setzt die Plattform auf GraphQL. Die API nimmt eine GraphQL-Abfrage entgegen und liefert die Antwort in Form von JSON. Sie wird unter https://data.bafu.admin.ch/api bereitgestellt.

Beispiel – Abfrage​

Die folgende Abfrage liefert eine aktive Messstation aus dem hydrologischen Messnetz:

curl -X POST https://data.bafu.admin.ch/api \
  -H "Content-Type: application/json" \
  --data '{"query":"{ water { observations { stations(where:{status:{_eq:\"Aufgebaut\"}}, limit: 1) { no name riverName } } } }"}'

Beispiel – Antwort​

Eine Antwort mit HTTP-Status 200 und einem JSON-Feld data bedeutet, dass die Schnittstelle erreichbar ist und die Abfrage gültig war.

{
  "data": {
    "water": {
      "observations": {
        "stations": [
          {
            "no": "2009",
            "name": "Aare – Brienzwiler",
            "riverName": "Aare"
          }
        ]
      }
    }
  }
}

Datensätze​

Eine Übersicht aller Datensätze mit ausführbaren Beispielabfragen findet sich unter Datensätze. Das vollständige Schema mit allen Namespaces, Typen und Feldern lässt sich interaktiv im GraphiQL Explorer durchsuchen.

Weiterführende Seiten​

  • Abfragen – Interaktiver Aufruf der Schnittstelle über den eingebetteten GraphiQL Explorer.
  • Filter und Operatoren – Aufbau von where-Argumenten und unterstützte Vergleichsoperatoren.
  • Pagination – Mengenbegrenzung pro Abfrage und Iterationsmuster über grössere Zeiträume.
  • Python und curl – Beispielcode für den Aufruf der Schnittstelle.