Quickstart

I dati ambientali dell'Ufficio federale dell'ambiente (UFAM) sono dati aperti (Open Data / OGD) e sono disponibili al pubblico in modo libero tramite questa piattaforma. I dati possono essere interrogati tramite un'API e integrati nelle proprie applicazioni. Per singoli set di dati i dati sono inoltre offerti come file predisposti per il download.

API

L'UFAM dispone di numerosi set di dati, che vengono pubblicati progressivamente su questa piattaforma. Affinché l'interfaccia non debba essere adattata a ogni nuova pubblicazione, la piattaforma si basa su GraphQL. L'API riceve una query GraphQL e restituisce la risposta in formato JSON. È disponibile all'indirizzo https://data.bafu.admin.ch/api.

Esempio – Query

La query seguente restituisce una stazione di misurazione attiva della rete idrologica:

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 } } } }"}'

Esempio – Risposta

Una risposta con stato HTTP 200 e un campo JSON data indica che l'interfaccia è raggiungibile e la query è valida.

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

Set di dati

Una panoramica di tutti i set di dati con query di esempio eseguibili si trova in Set di dati. Lo schema completo, con tutti gli spazi dei nomi, i tipi e i campi, può essere esplorato in modo interattivo nell'esploratore GraphiQL.

Approfondimenti

• Query – Accesso interattivo all'interfaccia tramite l'esploratore GraphiQL integrato.
• Filtri e operatori – Struttura degli argomenti where e operatori di confronto supportati.
• Pagination – Limite per query e schemi di iterazione su periodi di tempo più ampi.
• Python e curl – Codice di esempio per la chiamata dell'interfaccia.