L'API permet d'interroger les données publiques produites dans le cadre du SNO KARST.
Description
Les observatoires correspondent à des suivis sur des zones géographiques karstiques spécifiques en France.
Chaque observatoire comporte plusieurs stations de mesure qui correspondent à des points géographiques sur lequels les suivis sont réalisés.
Une série temporelle correspond au suivi d’un paramètre sur une station de mesure. Elle possède une unité, un niveau de données et une méthode donnée. Elle est identifiée par un DOI qui fournit une citation des données de cette série.
Chaque paramètre est associé à une catégorie de paramètres.
Enfin, les observations sont les données numériques associées aux séries temporelles.
Accès
API : https://api.oreme.org/snokarst/
Documentation technique : https://api.oreme.org/snokarst/docs
Conditions d'utilisation
Ces données sont disponibles selon les conditions de la Licence Ouverte 2.0.
Toute ré-utilisation de ces données impose la mention des DOI associés aux séries temporelles et la mention des citations associées à ces DOI.
Utilisation de l'API
Format
Les données peuvent être récupérées au format JSON (par défaut) ou au format CSV, avec le paramètre ?format=csv/json.
Pagination
Le nombre de résultats renvoyés est limité à 50 000 items par page.
Pour récupérer l'intégralité des données d'une série fournissant plus de 50 000 observations, il est donc nécessaire de parcourir les différentes pages. Il faut pour cela utiliser les éléments fournis à la fin de la réponse :
- total : nombre total d'éléments à récupérer
- page : numéro de la page actuelle
- size : nombre total d'éléments de la page actuelle
- pages : nombre total de pages à récupérer
Exemples
Des scripts d'exemple d'utilisation de l'API en R et python sont disponibles sur https://gitlab.in2p3.fr/oreme-si/snokarst-api-examples.