Aller au contenu principal
Schweizerische EidgenossenschaftConfédération suisseConfederazione SvizzeraConfederaziun svizraOffice fédéral de l'environnement OFEVOpen Data (OGD)

Quickstart

Les données environnementales de l'Office fédéral de l'environnement (OFEV) sont des données ouvertes (Open Data / OGD), publiquement et librement disponibles via cette plateforme. Les données peuvent être interrogées via une API et intégrées dans ses propres applications. Pour certains jeux de données, les données sont également proposées sous forme de fichiers préparés en téléchargement.

API​

L'OFEV dispose de nombreux jeux de données qui sont publiés successivement sur cette plateforme. Pour ne pas devoir adapter l'interface à chaque nouvelle publication, la plateforme s'appuie sur GraphQL. L'API reçoit une requête GraphQL et renvoie la réponse au format JSON. Elle est mise à disposition à l'adresse https://data.bafu.admin.ch/api.

Exemple – Requête​

La requête suivante renvoie une station de mesure active du réseau hydrologique :

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

Exemple – Réponse​

Une réponse avec le statut HTTP 200 et un champ JSON data indique que l'interface est joignable et que la requête est valide.

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

Jeux de données​

Une vue d'ensemble de tous les jeux de données avec des requêtes exécutables se trouve dans la section Jeux de données. Le schéma complet, avec l'ensemble des espaces de noms, des types et des champs, peut être exploré de manière interactive dans l'explorateur GraphiQL.

Pour aller plus loin​

  • Requêtes – Accès interactif à l'interface via l'explorateur GraphiQL intégré.
  • Filtres et opérateurs – Syntaxe des arguments where et opérateurs de comparaison pris en charge.
  • Pagination – Limite par requête et stratégies d'itération sur de plus grandes périodes.
  • Python et curl – Exemples de code pour appeler l'interface.