Quels sont les formats de données proposés par les APIs ?
Actuellement, les APIs de Hub'Eau proposent du CSV (opérations se terminant par CSV), ou du JSON et du GeoJSON (opérations sans indication du format).
Pour choisir entre JSON et GeoJSON, il faut sélectionner en tête d’API (rubrique Content Type de la réponse, avant les paramètres) le format souhaité.
Quelle différence entre les données issues de Hub'Eau et celles issues des banques du SIE ?
Dans Hubeau, vous trouverez l’intégralité des mesures disponibles dans la banque dont sont issues les données (par exemple pour la piézométrie, vous trouverez l’intégralité des mesures de piézométrie accessibles depuis ADES).
Par contre, la forme (le format, la structure) sous laquelle ces données sont proposées sont volontairement simplifiées dans Hub'Eau, afin de les rendre plus directement utilisables.
Puis-je être guidé dans l'utilisation des APIs ?
Oui, il existe un tutoriel qui décrit pas à pas les différentes étapes à suivre.
Quels sont les droits d'usage des APIs ?
L’utilisateur peut utiliser une ou plusieurs des interfaces de programmation (API) proposées sur Hubeau pour faciliter l’accès aux données. Les API sont fournies « en l’état » à l’utilisateur, qui en fait usage à ses risques et périls. En particulier, sans toutefois que cela soit limitatif, l’OFB et le BRGM ne garantissent en aucune manière la compatibilité des APIs avec le matériel informatique ou les logiciels de l’utilisateur.
Les données et APIs seront indisponibles lors des maintenances périodiques, lesquelles interviendront à intervalles plus ou moins réguliers, à la seule discrétion de l’OFB et du BRGM.
L’OFB et le BRGM se réservent le droit de bloquer partiellement ou totalement, à tout moment et sans préavis, l’accès aux APIs de l’adresse IP de tout utilisateur et ce, pour quelque motif que ce soit, en particulier s'il est établi que l’utilisateur utilise, ou cherche à utiliser, les données et/ou APIs en violation des conditions d’utilisation, de manière à leur nuire ou à nuire à un tiers, ou qu’il sollicite outre mesure l’infrastructure censée permettre à un nombre raisonnable d’individus d’accéder aux données.
L’Utilisateur s’engage à n’user d’aucun moyen technique à l’effet de se soustraire au contrôle de l’utilisation des ressources susmentionnées. L’OFB et le BRGM se réservent le droit de recourir à tout moyen technique à sa disposition pour déjouer une éventuelle tentative de cette nature.
Hub'Eau est-il un outil pérenne ?
Oui, hubeau.eaufrance.fr est un outil pérenne du Système d'Information sur l'eau (SIE).
Après la phase de prototypage, réalisée dans le cadre du Programme d’Investissement d’Avenir, il a été décidé au sein du SIE de faire de Hub'Eau le point central du SIE qui propose des APIs.
La consommation des APIs de Hub'Eau par le SIE lui même (pour eaufance.fr par exemple) apporte une garantie supplémentaire sur sa pérennité.
Les versions des APIs sont-elles stables ?
Les APIs peuvent être amenées à évoluer, principalement à votre demande. Des choix ont été réalisés pour chaque API, choix évidemment discutables.
Nous avons pu tester ces choix pour les 4 premiers groupes d’API lors d’un hackathon en juin 2016, ce qui nous a permis de les améliorer.
Depuis 2018, chaque nouvelle API fait l'objet d'une campagne de beta-test public avant de passer en production. Lors de cette période de beta-test, nous recueillons les différentes remarques des utilisateurs via la page GitHub de Hub'Eau.
Tout au long du cycle de vie des APIs, nous restons à l’écoute des utilisateurs pour les faire évoluer. Les évolutions sont généralement rétro-compatibles avec les versions précédentes. Elles sont annoncées dans les actualités du site et via la newsletter périodique.
Quels sont les droits d’usage des données proposées par les APIs ?
L’ensemble des données proposées dans le cadre des API sont des données publiques environnementales, déjà diffusées par ailleurs : elles sont donc librement utilisables et réutilisables, dans le cadre de la licence ouverte interministérielle.
Quelles sont les prochaines données qui vont intégrer Hub'Eau ?
Hub'Eau va progressivement proposer de nouvelles données du domaine de l’eau, principalement des données portant sur des mesures.
A terme, le but recherché est que toutes les données un peu volumineuses du Système d'Information sur l'Eau (SIE) soient accessibles dans Hub'Eau.
Vous n'avez pas trouvé votre réponse ?