### Prélèvements en eau [L'API Prélèvements en eau](https://hubeau.eaufrance.fr/page/api-prelevements-eau) fournit des informations sur les volumes annuels directement prélevés sur la ressource en eau, déclinés par localisation et catégorie d’usage de l’eau. Ces informations sont issues de la gestion des redevances par les agences et offices de l’eau. Source des données : [Banque Nationale des Prélèvements quantitatifs en Eau (BNPE)](https://bnpe.eaufrance.fr/). Les données sont exposées sous la forme d'une API REST, les formats supportés sont : JSON, GeoJSON et CSV. Pour en savoir plus, consultez [le site de la BNPE](https://bnpe.eaufrance.fr/). Vous y trouverez notamment des [cartes de peuplement de la base de données par années](https://bnpe.eaufrance.fr/cartes-peuplement-base). #### Opérations possibles - **chroniques** : permet de récupérer les volumes annuels d'eau prélevés par ouvrages. ; - **ouvrages** : permet de récupérer la description des ouvrages de prélèvement. Les données de volumes annuels prélevés sont rattachées aux ouvrages et non aux points de prélèvement. - **points_prelevement** : permet de récupérer la description des points de prélèvement. #### Dernières évolutions de l'API Prélèvements en eau de Hub'Eau - 16/06/2021 : mise en ligne de la v1 - 04/06/2019 : mise à disposition de la version beta publique #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité. Hub’Eau est le résultat de la collaboration de l’OFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [la page Hub'Eau sur api.gouv](https://api.gouv.fr/producteurs/hub-eau) ou directement sur [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API. D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation - [Evolution annuelle des prélèvements sur le territoire du SAGE Yèvre-Auron](https://www.eptb-loire.fr/Cartographie/html/yevre-auron/index_prelevements.html), par [l'Etablissement Public Loire](https://www.eptb-loire.fr/). - [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### BNPE La [banque nationale des prélèvements quantitatifs en eau (BNPE)](https://bnpe.eaufrance.fr/) est l’outil national dédié aux prélèvements sur la ressource en eau, pour la France métropolitaine et les départements d’outre-mer. Les informations portent sur les volumes annuels directement prélevés sur la ressource en eau et sont déclinées par localisation et catégorie d’usage de l’eau. Issues aujourd’hui de la gestion des redevances par les agences et offices de l’eau, elles sont appelées à être complétées à court terme par d’autres producteurs de données. Les données sont mises à jour une fois par an. #### BRGM Le [BRGM (Bureau de Recherches Géologiques et Minières)](http://www.brgm.fr/), service géologique national français, est l'établissement public de référence dans les applications des sciences de la Terre pour gérer les ressources et les risques du sol et du sous-sol. Le BRGM assure notamment la diffusion de données géologiques et environnementales via les technologies de l’information et de la communication, avec pour objectif la mise à disposition des pouvoirs publics, des acteurs économiques et du grand public d'informations géoréférencées pour appuyer leurs décisions. Parmi les domaines de compétence du BRGM figurent les infrastructures informatiques de diffusion, calcul, simulation-visualisation 3D et réalité virtuelle ainsi que l'interopérabilité. #### OFB L'[OFB (Office Français de la Biodiversité)](https://ofb.gouv.fr/) est un établissement public dédié à la sauvegarde de la biodiversité. Une de ses priorités est de répondre de manière urgente aux enjeux de préservation du vivant. Créé au 1er janvier 2020 par la loi n°2019-773 du 24 juillet 2019, l’Office français de la biodiversité regroupe les agents de l’Agence française pour la biodiversité (AFB) et de l’Office national de la chasse et de la faune sauvage (ONCFS). Unir ces deux établissements dans la lutte pour la protection de la nature, permet de rassembler des expertises, sur les milieux aquatiques, terrestres et marins et faire front commun contre les menaces qui pèsent sur la biodiversité en France. Regrouper ces deux entités, dont les agents sont implantés sur l’ensemble de l’hexagone et les Outre-mer, c’est aussi assurer un ancrage solide dans les territoires pour agir à l’échelle locale. #### Ouvrage de prélèvement en eau Un ouvrage de prélèvement en eau désigne un ensemble de dispositifs techniques de captage, de stockage et de canalisation d'eau, provenant d'une ressource et à destination d'un usage principal. L’ouvrage est connecté à une seule ressource en eau, par l'intermédiaire d'un ou plusieurs points de prélèvement géographiquement individualisés. #### Point de prélèvement en eau Un point de prélèvement d'eau matérialise un point de connexion physique entre la ressource en eau et un dispositif technique de captage d'eau se rapportant à l'ouvrage de prélèvement en question. Par définition, un point de prélèvement est donc rattaché à un seul et unique ouvrage de prélèvement. ### Partenaires de l'API - Eaufrance - Office Français de la Biodiversité - Bureau de Recherches Géologiques et Minières
[L'API Qualité des cours d'eau](http://hubeau.eaufrance.fr/page/api-qualite-cours-deau) de Hub'Eau permet d'accéder aux données sur la qualité physico-chimique des fleuves, rivières et plans d'eau. ### Description fonctionnelle de l'API Qualité des cours d'eau Les données de l'API "Qualité des cours d'eau" sont issues de la base [Naïades](http://naiades.eaufrance.fr/). Disponibles sur la France entière (y compris les DROM), elles portent sur les résultats des mesures de la qualité physico-chimique des cours d’eau et des plans d’eau transmises par les Agences de l'Eau.\ Plus de 200 millions d'analyses réparties sur plus de 20 000 stations sont disponibles. Une version 2 de l'API est désormais disponible. Cette nouvelle version ajoute de nombreuses informations dans les réponses des différents endpoints, ajoute également des paramètres requêtables (fraction, statut, qualification, réseau, masse d'eau, ...) et corrige des problèmes d'interrogation des conditions environnementales. De plus, dans la version v2 de l'API, les données sont dorénavant synchronisées en continu avec la base Naïades. Les données sont exposées sous la forme d'une API REST, les formats supportés sont : JSON, GeoJSON et CSV. #### Opérations disponibles Un ensemble de 4 méthodes permet de rechercher l'ensemble des informations liées à la qualité physico-chimiques des eaux superficielles continentales (cours d'eau et plans d'eau). * **station\_pc** : permet de rechercher les stations (lieux de mesure) sur les cours d'eau ou plans d'eau où des prélèvements d'eau ont eu lieu en vue de faire des analyses de la qualité de l'eau ; * **operation\_pc** : permet de connaître les opérations de prélèvement ayant eu lieu sur les stations ; * **condition\_environnementale\_pc** : permet de rechercher les conditions environnementales (température de l'air, présence de feuilles, mousses, irisations, etc) lors des opérations de prélèvements physico-chimiques ; * **analyse\_pc** : permet de rechercher les analyses physico-chimiques effectuées sur les échantillons confectionnés lors des opérations de prélèvement sur les différentes stations. Ces analyses concernent différents paramètres physico-chimiques comme la conductivité, les nitrates, les substances pesticides, les métaux lourds... #### Dernières évolutions de l'API Qualité des cours d'eau de Hub'Eau * 19/07/2022 : v2.0.0 - synchronisation continue des données avec la base Naiades, correction des problèmes d'interrogation des conditions environnementales, ajout de paramètres requêtables (fraction, statut, qualification, réseau, masse d'eau, ...), ajout de nombreuses informations supplémentaires dans les réponses des différents endpoints * 22/05/2018 : v1.1.0 - ajout d'une limitation sur la profondeur d'accès aux résultats pour ne pas faire tomber le serveur, ajout du header "link" pour le format CSV, correction code retour pour le format CSV gérant les codes 200 et 206 * 26/02/2018 : passage à la v1 - changement de la structure de l'API avec mise à disposition des données sur la France entière (la v0 ne proposait que les bassins Adour-Garonne et Loire-Bretagne) et ajout d'informations comme les conditions environnementales des prélèvements #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité. Hub’Eau est le résultat de la collaboration de l’AFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API. D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Les retours se font sur [le forum de contribution GitHub](http://github.com/BRGM/hubeau/issues). Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation * [Observatoire du bassin versant de la Sèvre Nantaise](https://www.sevre-nantaise.com/observatoire/qualite-eau-phosphore) * [Géorivière, gérez et suivez vos cours d'eau](https://georiviere.fr/) * [Les pesticides dans les cours d'eau des Pays de la Loire](https://ssm-ecologie.shinyapps.io/qualite-des-eaux/) * [Les nitrates dans les cours d'eau et les nappes souterraines des Pays de la Loire](https://ssm-ecologie.shinyapps.io/nitrates_eau/) * [Qualité des lacs et cours d'eau (visualiseur des APIs qualité physico-chimique des cours d'eau, hydrobiologie et température de Hub'Eau)](https://hubeau.eaufrance.fr/sites/default/files/api/demo/qualriv.htm) * [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### Agence de l'Eau Les Agences de l'Eau sont des établissements publics du ministère chargé du développement durable. Au nombre de six en France Métropolitaine, elles ont pour missions de contribuer à réduire les pollutions de toutes origines et à protéger les ressources en eau et les milieux aquatiques. Les agences de l’eau mettent en œuvre, dans les sept bassins hydrographiques métropolitains, les objectifs et les dispositions des schémas directeurs d’aménagement et de gestion des eaux (SDAGE, plans de gestion français de la directive cadre sur l’eau et leur déclinaison locale, les SAGE), en favorisant une gestion équilibrée et économe de la ressource en eau et des milieux aquatiques, l’alimentation en eau potable, la régulation des crues et le développement durable des activités économiques. Acteurs de la mise en œuvre de la politique publique de l’eau, organisée en France autour du principe de la gestion concertée par bassin versant, les agences de l’eau exercent leurs missions dans le cadre de programmes d’actions pluriannuels avec pour objectif final l’atteinte du bon état des eaux (selon la directive cadre sur l’eau d’octobre 2000). #### BRGM Le [BRGM (Bureau de Recherches Géologiques et Minières)](http://www.brgm.fr/), service géologique national français, est l'établissement public de référence dans les applications des sciences de la Terre pour gérer les ressources et les risques du sol et du sous-sol. Le BRGM assure notamment la diffusion de données géologiques et environnementales via les technologies de l’information et de la communication, avec pour objectif la mise à disposition des pouvoirs publics, des acteurs économiques et du grand public d'informations géoréférencées pour appuyer leurs décisions. Parmi les domaines de compétence du BRGM figurent les infrastructures informatiques de diffusion, calcul, simulation-visualisation 3D et réalité virtuelle ainsi que l'interopérabilité. #### Naïades [Naïades](http://www.naiades.eaufrance.fr/) est l'interface nationale pour l'accès aux données des rivières et des lacs. Elle permet aux utilisateurs d'accéder aux données collectées par les agences de l'eau, les offices de l'eau et l'OFB sur les paramètres physiques, les concentrations de substances chimiques, les inventaires d'espèces et l'hydromorphologie en un point unique dans des formats standardisés. #### OFB L'[OFB (Office Français de la Biodiversité)](https://ofb.gouv.fr/) est un établissement public dédié à la sauvegarde de la biodiversité. Une de ses priorités est de répondre de manière urgente aux enjeux de préservation du vivant. Créé au 1er janvier 2020 par la loi n°2019-773 du 24 juillet 2019, l’Office français de la biodiversité regroupe les agents de l’Agence française pour la biodiversité (AFB) et de l’Office national de la chasse et de la faune sauvage (ONCFS). Unir ces deux établissements dans la lutte pour la protection de la nature, permet de rassembler des expertises, sur les milieux aquatiques, terrestres et marins et faire front commun contre les menaces qui pèsent sur la biodiversité en France. Regrouper ces deux entités, dont les agents sont implantés sur l’ensemble de l’hexagone et les Outre-mer, c’est aussi assurer un ancrage solide dans les territoires pour agir à l’échelle locale. #### SANDRE Le [SANDRE (Service d'Administration Nationale des Données et Référentiels sur l'Eau)](http://www.sandre.eaufrance.fr/) a pour mission d'établir et de mettre à disposition le référentiel des données sur l'eau du SIE (Système d'Information sur l'Eau). Ce référentiel, composé de spécifications techniques et de listes de codes libres d'utilisation, décrit les modalités d'échange des données sur l'eau à l'échelle de la France. D'un point de vue informatique, le Sandre garantit l'interopérabilité des systèmes d'information relatifs à l'eau. ### Partenaires de l'API * Eaufrance * Office Français de la Biodiversité * Bureau de Recherches Géologiques et Minières
[L'API Hydrobiologie](https://hubeau.eaufrance.fr/page/api-hydrobiologie) de Hub'Eau diffuse les données de peuplement des cours d'eau bancarisées par le [portail NAIADES](http://www.naiades.eaufrance.fr/). ### Description fonctionnelle de l'API Hydrobiologie Les données hydrobiologiques concernent : - les Macroinvertébrés aquatiques ; - les Diatomées benthiques ; - les Macrophytes ; - les Poissons. L'API est passée en version 1 depuis le 19 juillet 2022. #### Opérations disponibles 3 opérations permettent de rechercher l'ensemble des informations liées à la qualité hydrobiologique des eaux superficielles continentales (cours d'eau et plans d'eau) : - **stations_hydrobio** : permet de récupérer toutes les stations où des prélèvements hydrobiologiques ont eu lieu ; - **indices** : permet de récupérer les indices (ou résultats) biologiques ; - **taxons** : permet de récupérer les listes floristiques ou faunistiques. #### Dernières évolutions de l'API Hydrobiologie de Hub'Eau - 19/07/2022 : mise à disposition de la v1 : ajout notamment des paramètres code_prelevement et code_banque_reference ; - 28/05/2020 : mise à disposition de la version beta. #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité. Hub’Eau est le résultat de la collaboration de l’OFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [la page Hub'Eau sur api.gouv](https://api.gouv.fr/producteurs/hub-eau) ou directement [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API. D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Les retours se font sur [le forum de contribution GitHub](http://github.com/BRGM/hubeau/issues). Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation - [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### Agence de l'Eau Les Agences de l'Eau sont des établissements publics du ministère chargé du développement durable. Au nombre de six en France Métropolitaine, elles ont pour missions de contribuer à réduire les pollutions de toutes origines et à protéger les ressources en eau et les milieux aquatiques. Les agences de l’eau mettent en œuvre, dans les sept bassins hydrographiques métropolitains, les objectifs et les dispositions des schémas directeurs d’aménagement et de gestion des eaux (SDAGE, plans de gestion français de la directive cadre sur l’eau et leur déclinaison locale, les SAGE), en favorisant une gestion équilibrée et économe de la ressource en eau et des milieux aquatiques, l’alimentation en eau potable, la régulation des crues et le développement durable des activités économiques. Acteurs de la mise en œuvre de la politique publique de l’eau, organisée en France autour du principe de la gestion concertée par bassin versant, les agences de l’eau exercent leurs missions dans le cadre de programmes d’actions pluriannuels avec pour objectif final l’atteinte du bon état des eaux (selon la directive cadre sur l’eau d’octobre 2000). #### BRGM Le [BRGM (Bureau de Recherches Géologiques et Minières)](http://www.brgm.fr/), service géologique national français, est l'établissement public de référence dans les applications des sciences de la Terre pour gérer les ressources et les risques du sol et du sous-sol. Le BRGM assure notamment la diffusion de données géologiques et environnementales via les technologies de l’information et de la communication, avec pour objectif la mise à disposition des pouvoirs publics, des acteurs économiques et du grand public d'informations géoréférencées pour appuyer leurs décisions. Parmi les domaines de compétence du BRGM figurent les infrastructures informatiques de diffusion, calcul, simulation-visualisation 3D et réalité virtuelle ainsi que l'interopérabilité. #### Naïades [Naïades](http://www.naiades.eaufrance.fr/) est l'interface nationale pour l'accès aux données des rivières et des lacs. Elle permet aux utilisateurs d'accéder aux données collectées par les agences de l'eau, les offices de l'eau et l'AFB sur les paramètres physiques, les concentrations de substances chimiques, les inventaires d'espèces et l'hydromorphologie en un point unique dans des formats standardisés. #### OFB L'[OFB (Office Français de la Biodiversité)](https://ofb.gouv.fr/) est un établissement public dédié à la sauvegarde de la biodiversité. Une de ses priorités est de répondre de manière urgente aux enjeux de préservation du vivant. Créé au 1er janvier 2020 par la loi n°2019-773 du 24 juillet 2019, l’Office français de la biodiversité regroupe les agents de l’Agence française pour la biodiversité (AFB) et de l’Office national de la chasse et de la faune sauvage (ONCFS). Unir ces deux établissements dans la lutte pour la protection de la nature, permet de rassembler des expertises, sur les milieux aquatiques, terrestres et marins et faire front commun contre les menaces qui pèsent sur la biodiversité en France. Regrouper ces deux entités, dont les agents sont implantés sur l’ensemble de l’hexagone et les Outre-mer, c’est aussi assurer un ancrage solide dans les territoires pour agir à l’échelle locale. #### SANDRE Le [SANDRE (Service d'Administration Nationale des Données et Référentiels sur l'Eau)](http://www.sandre.eaufrance.fr/) a pour mission d'établir et de mettre à disposition le référentiel des données sur l'eau du SIE (Système d'Information sur l'Eau). Ce référentiel, composé de spécifications techniques et de listes de codes libres d'utilisation, décrit les modalités d'échange des données sur l'eau à l'échelle de la France. D'un point de vue informatique, le Sandre garantit l'interopérabilité des systèmes d'information relatifs à l'eau. ### Partenaires de l'API - Eaufrance - Office Français de la Biodiversité - Bureau de Recherches Géologiques et Minières
[L'API Ecoulement des cours d'eau](https://hubeau.eaufrance.fr/page/api-ecoulement) diffuse les données de l’observatoire national des étiages, [Onde](https://onde.eaufrance.fr/). Ces données résultent d'observations visuelles de l’écoulement des petits et moyens cours d’eau réalisées par les agents départementaux de l'Office français de la biodiversité (OFB) pendant la période estivale. Elles couvrent la France hexagonale (Corse comprise) et plus de 10 ans de collecte. De par la localisation des stations Onde en tête de bassin versant souvent peu instrumentées, cette API complète les données diffusées par l'API Hydrométrie collectées par le Schapi. La répartition des stations Onde (réseau de plus de 3200 stations) a été pensée pour être représentative du contexte hydrographique des petits et moyens cours d’eau de chaque département. Le mode de recueil des données Onde est exclusivement l’observation visuelle selon des modalités de perturbations d'écoulement des cours d’eau, aucune mesure n’est mise en œuvre sur le terrain. #### Opérations possibles * **stations** : permet de connaître les stations sur lesquelles sont réalisées les campagnes d'observation des écoulements ; * **campagnes** : permet de lister les campagnes d'observations ; * **observations** : permet de consulter les résultats des observations visuelles. #### Dernières évolutions de l'API Hub'Eau Ecoulement des cours d'eau * 26/05/2023 : arrêt de la version bêta * 23/05/2023 : mise à disposition de la version 1 * 29/06/2022 : mise à disposition de la version bêta #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité.\ Hub’Eau est le résultat de la collaboration de l’OFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [la page Hub'Eau sur api.gouv](https://api.gouv.fr/producteurs/hub-eau) ou directement sur [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API.\ D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Les retours se font sur [le forum de contribution GitHub](http://github.com/BRGM/hubeau/issues).\ Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation * [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### BRGM Le [BRGM (Bureau de Recherches Géologiques et Minières)](http://www.brgm.fr/), service géologique national français, est l'établissement public de référence dans les applications des sciences de la Terre pour gérer les ressources et les risques du sol et du sous-sol. Le BRGM assure notamment la diffusion de données géologiques et environnementales via les technologies de l’information et de la communication, avec pour objectif la mise à disposition des pouvoirs publics, des acteurs économiques et du grand public d'informations géoréférencées pour appuyer leurs décisions. Parmi les domaines de compétence du BRGM figurent les infrastructures informatiques de diffusion, calcul, simulation-visualisation 3D et réalité virtuelle ainsi que l'interopérabilité. #### OFB L'[OFB (Office Français de la Biodiversité)](https://ofb.gouv.fr/) est un établissement public dédié à la sauvegarde de la biodiversité. Une de ses priorités est de répondre de manière urgente aux enjeux de préservation du vivant. Créé au 1er janvier 2020 par la loi n°2019-773 du 24 juillet 2019, l’Office français de la biodiversité regroupe les agents de l’Agence française pour la biodiversité (AFB) et de l’Office national de la chasse et de la faune sauvage (ONCFS). Unir ces deux établissements dans la lutte pour la protection de la nature, permet de rassembler des expertises, sur les milieux aquatiques, terrestres et marins et faire front commun contre les menaces qui pèsent sur la biodiversité en France. Regrouper ces deux entités, dont les agents sont implantés sur l’ensemble de l’hexagone et les Outre-mer, c’est aussi assurer un ancrage solide dans les territoires pour agir à l’échelle locale. #### Onde Le [site Onde](https://onde.eaufrance.fr/) présente les données de l’observatoire national des étiages. Ces données sont les observations visuelles réalisées par les agents départementaux de l'Office français de la biodiversité (OFB) pendant la période estivale sur l’écoulement des cours d’eau. ### Partenaires de l'API * Eaufrance * Office Français de la Biodiversité * Bureau de Recherches Géologiques et Minières
[L'API "Température en continu"](https://hubeau.eaufrance.fr/page/api-temperature-continu) de Hub'Eau permet d'interroger les données de températures relevées par des capteurs automatiques posés dans les cours d'eau de France métropolitaine. Ces capteurs enregistrent la température à des fréquences variant de une à quelques heures. ### Description fonctionnelle de l'API Température en continu des cours d'eau Les données sont issues de la [banque de données Naïades](http://www.naiades.eaufrance.fr/). Elles sont mises à jour trimestriellement.\ Le réseau de mesure comprend environ 760 stations, dont une cinquantaine seulement est toujours en service. Depuis le 19 juillet 2022, suite à la mise à jour du moteur d'indexation, les données sont synchronisées en temps réel avec celles de la banque Naïades. Les données sont exposées sous la forme d'une API REST, les formats supportés sont : JSON, GeoJSON et CSV. #### Deux opérations (endpoints) sont disponibles : * **station** : permet de rechercher les stations sur lesquelles sont mesurées les températures en continu dans les cours d'eau ; * **chronique** : permet de rechercher les chroniques de températures en continu dans les cours d'eau mesurées aux différentes stations. #### Dernières évolutions de l'API Température en continu des cours d'eau de Hub'Eau: * 19/07/2022 : mise à jour du moteur d'indexation, synchronisé en temps réel avec Naïades ; * 30/07/2018 : publication de la version 1 * 14/06/2018 : publication de la version bêta-1, correction bug chroniques.csv * 31/05/2018 : mise à disposition de la version bêta #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité. Hub’Eau est le résultat de la collaboration de l’AFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [la page Hub'Eau sur api.gouv](https://api.gouv.fr/producteurs/hub-eau) ou directement [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API.\ D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Les retours se font sur [le forum de contribution GitHub](http://github.com/BRGM/hubeau/issues).\ Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation * [Qualité des lacs et cours d'eau (visualiseur des APIs qualité physico-chimique des cours d'eau, hydrobiologie et température de Hub'Eau)](https://hubeau.eaufrance.fr/sites/default/files/api/demo/qualriv.htm?code_support=99) * [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### BRGM Le [BRGM (Bureau de Recherches Géologiques et Minières)](http://www.brgm.fr/), service géologique national français, est l'établissement public de référence dans les applications des sciences de la Terre pour gérer les ressources et les risques du sol et du sous-sol. Le BRGM assure notamment la diffusion de données géologiques et environnementales via les technologies de l’information et de la communication, avec pour objectif la mise à disposition des pouvoirs publics, des acteurs économiques et du grand public d'informations géoréférencées pour appuyer leurs décisions. Parmi les domaines de compétence du BRGM figurent les infrastructures informatiques de diffusion, calcul, simulation-visualisation 3D et réalité virtuelle ainsi que l'interopérabilité. #### Naïades [Naïades](http://www.naiades.eaufrance.fr/) est l'interface nationale pour l'accès aux données des rivières et des lacs. Elle permet aux utilisateurs d'accéder aux données collectées par les agences de l'eau, les offices de l'eau et l'AFB sur les paramètres physiques, les concentrations de substances chimiques, les inventaires d'espèces et l'hydromorphologie en un point unique dans des formats standardisés. #### OFB L'[OFB (Office Français de la Biodiversité)](https://ofb.gouv.fr/) a été créée le 1er janvier 2017. Elle regroupe l'Agence des aires marines protégées, l'Atelier technique des espaces naturels, l'Office national de l'eau et des milieux aquatiques et les Parcs nationaux de France. L'AFB , établissement public du ministère en charge de l'environnement, exerce des missions d’appui à la mise en œuvre des politiques publiques dans les domaines de la connaissance, la préservation, la gestion et la restauration de la biodiversité et des milieux terrestres, aquatiques et marins. Elle vient en appui aux acteurs publics mais travaille également en partenariat étroit avec les acteurs socio-économiques. Elle a aussi vocation à aller à la rencontre du public pour mobiliser les citoyens en faveur de la biodiversité. En matière d’espaces protégés, elle gère notamment les parcs naturels marins et le sanctuaire de mammifères marins Agoa aux Antilles. Elle est opératrice et animatrice de sites Natura 2000 en mer. Les parcs nationaux sont rattachés à l’Agence, des synergies fortes sont mises en place avec eux. ### Partenaires de l'API * Eaufrance * Office Français de la Biodiversité * Bureau de Recherches Géologiques et Minières
Piézométrie (niveau des nappes d'eau souterraine) [L'API Piézométrie](https://hubeau.eaufrance.fr/page/api-piezometrie) de Hub'Eau permet d'accéder aux données sur le niveau des nappes d'eau souterraines. Ces données sont issues du portail [ADES](http://www.ades.eaufrance.fr). Elles portent sur les mesures de piézométrie (niveau d'eau dans les nappes d'eau souterraine), France entière, en provenance de tous les partenaires du système d'information sur l'eau. Les mises à jour de la banque ADES sont intégrées quotidiennement à l'API. Testez le [démonstrateur de l'API Piézométrie](https://hubeau.eaufrance.fr/sites/default/files/api/demo/piezo/piezo.htm) et récupérez le [code Javascript](https://github.com/BRGM/hubeau/tree/master/demonstrateurs/piezo) qui l'a généré pour construire vous même vos applications basées sur Hub'Eau. Les données sont exposées sous la forme d'une API REST, les formats supportés sont : JSON, GeoJSON et CSV. #### Opérations possibles - **stations** : permet de rechercher les stations de mesure des niveaux des nappes d'eau (stations piézométriques ou piézomètres). - **chroniques** : permet d'accéder aux chroniques piézométriques (évolution dans le temps du niveau des nappes) par station de mesure ; - **chroniques_tr** : permet d'accéder en temps quasi-réel aux données piézométriques brutes de fréquence horaire télé-transmises par environ 1700 piézomètres. #### Dernières évolutions de l'API Piézométrie de Hub'Eau - 17/03/2020 : v1.4.0 L'opération chroniques est à son tour enrichie avec de nouvelles informations : continuité des mesures, producteur, nature des mesures et profondeur de l'eau par rapport au repère - 14/02/2020 : v1.3.0 : l'opération stations s'enrichit avec des informations supplémentaires dont l'altitude, la profondeur d'investigation, le département, les masses d'eau captées, le nombre de mesures disponibles... et offre la possibilité de requêter sur de nouveaux paramètre dont la date d'activité et le nombre minimal de mesures disponibles - 22/01/2020 : v1.2.0 : Mise à disposition de l'opération chroniques_tr permettant d'interroger en quasi-temps réel les piézomètres qui télé-transmettent leurs données #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité (9 téra-octets de données fournies en 76 millions d'appels pour le 2e semestre 2019). Hub’Eau est le résultat de la collaboration de l’OFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [la page Hub'Eau sur api.gouv](https://api.gouv.fr/producteurs/hub-eau) ou directement [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API. D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Les retours se font sur [le forum de contribution GitHub](http://github.com/BRGM/hubeau/issues). Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation - [Visualiseur des données piézométriques Temps Réel](https://hubeau.eaufrance.fr/sites/default/files/api/demo/piezo_tr.htm) - [Visualiseur des chroniques piézométriques historiques](https://hubeau.eaufrance.fr/sites/default/files/api/demo/piezo_chroniques.htm) - [Evolution des niveaux des nappes d'eau souterraine](https://hubeau.eaufrance.fr/sites/default/files/api/demo/piezo/piezo.htm) - [BioMétéo 24](https://biometeo.dordogne.fr/) Une « météo de la biodiversité » pour sensibiliser et accompagner le grand public vers une prise en compte de l’écologie au quotidien - [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### ADES [ADES](http://www.ades.eaufrance.fr) est la banque nationale d’Accès aux Données sur les Eaux Souterraines qui rassemble sur son site internet public des données quantitatives et qualitatives relatives aux eaux souterraines, dont les objectifs sont de constituer un outil de collecte et de conservation des données sur les eaux souterraines, d’être mobilisable par un large ensemble de partenaires, de permettre les traitements nécessaires à l’action de chacun des partenaires, d’être le guichet d’accès aux informations sur les eaux souterraines, d’avoir un suivi de l’état patrimonial des ressources pour répondre à la politique des eaux souterraines, et enfin d’adopter au niveau national un principe de transparence et d’accessibilité aux données sur les eaux souterraines. #### Aquifère Un aquifère est une formation géologique ou une roche, suffisamment poreuse et/ou fissurée (pour stocker de grandes quantités d'eau) tout en étant suffisamment perméable pour que l'eau puisse y circuler librement. Pour se représenter un aquifère, il faut imaginer un vaste réservoir naturel de stockage d'eau souterraine. #### Eaux souterraines Les eaux souterraines désignent toutes les eaux se trouvant sous la surface du sol en contact direct avec le sol ou le sous-sol et qui transitent plus ou moins rapidement dans les fissures et les pores du sol. #### Nappe d'eau souterraine Une nappe d'eau souterraine est une eau contenue dans les interstices ou les fissures d'une roche du sous-sol qu'on nomme aquifère. #### Niveau piézométrique Le niveau piézométrique caractérise la pression de la nappe en un point donné. Il est exprimé soit par rapport au sol en mètre, soit par rapport à l’altitude zéro du niveau de la mer en mètre NGF (Nivellement Général Français). Autrement dit, c'est le niveau libre de l'eau observé dans un piézomètre. #### Piézomètre Les piézomètres constituent les stations de mesure du niveau piézométrique (niveau d'eau dans la nappe). Un piézomètre est un forage non exploité qui permet la mesure du niveau de l'eau souterraine en un point donné de la nappe. Ce niveau qui varie avec l'exploitation renseigne sur la capacité de production de l'aquifère. #### SANDRE Le [SANDRE (Service d'Administration Nationale des Données et Référentiels sur l'Eau)](http://www.sandre.eaufrance.fr/) a pour mission d'établir et de mettre à disposition le référentiel des données sur l'eau du SIE (Système d'Information sur l'Eau). Ce référentiel, composé de spécifications techniques et de listes de codes libres d'utilisation, décrit les modalités d'échange des données sur l'eau à l'échelle de la France. D'un point de vue informatique, le Sandre garantit l'interopérabilité des systèmes d'information relatifs à l'eau. ### Partenaires de l'API - Eaufrance - Office Français de la Biodiversité - Bureau de Recherches Géologiques et Minières
[L'API "Surveillance du Littoral"](https://hubeau.eaufrance.fr/page/api-surveillance-littoral) diffuse les données de surveillance du littoral gérées et valorisées par [l'Institut français de recherche pour l'exploitation de la mer (IFREMER)](https://wwz.ifremer.fr) dans le [système d'information QUADRIGE](http://quadrige.eaufrance.fr). QUADRIGE regroupe de nombreuses thématiques : Phytoplancton et hydrologie, suivi environnemental de centrale nucléaire, Microbiologie, Benthos, ...). Chacune de ces thématiques fera l'objet d'un endpoint (opération) de l'API Surveillance du Littoral. A titre de test, c'est la thématique **Contaminants chimiques et écotoxicologie** qui a été choisie pour initier la diffusion des données de QUADRIGE via Hub'Eau. L'API ne diffuse pas de données permettant l'interprétation des analyses des contaminants chimiques (Aluminium, CaCO3, Carbone organique, ...). #### Deux opérations actuellement disponibles * **lieux\_surv** : permet de récupérer tous les lieux de surveillance (sites) du littoral. * **contaminants\_chimiques** : permet de récupérer les analyses de la thématique Contaminants chimiques et écotoxicologie. NB : Les analyses des différentes thématiques de QUADRIGE seront progressivement disponibles et feront l'objet de nouveaux endpoints. A noter que le endpoint lieux\_surv fournit l'ensemble des lieux de surveillance, y compris ceux n'ayant pas de mesures sur la thématique Contaminants chimiques et écotoxicologie, pour être complet quand les autres thématiques seront disponibles. Pour interroger seulement les lieux de surveillance avec des données de contaminants chimiques, ajoutez le paramètre donnees\_cc=true à votre requête. Les données sont exposées sous la forme d'une API REST, les formats supportés sont : JSON, GeoJSON et CSV. #### Dernières évolutions de l'API Surveillance du Littoral * 16/11/2022 : mise à disposition de la v1 * 15/04/2021 : mise à disposition de la version beta Nous vous invitons à faire remonter toute demande de correction ou tout besoin non satisfait sur le [forum de contribution Github](http://github.com/BRGM/hubeau/issues). #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les APIs Hub'Eau garantissent les meilleures performances de disponibilité (20 téra-octets de données fournies en 455 millions d'appels pour l'année 2020). Hub’Eau est le résultat de la collaboration de l’OFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). #### Un service en co-construction Pour des APIs toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une politique de bêta testing en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API. D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! Faites-nous part de vos observations sur la [page de contribution GitHub](https://github.com/BRGM/hubeau/issues). ### Exemples de réutilisation * [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Partenaires de l'API * Eaufrance * Office Français de la Biodiversité * Bureau de Recherches Géologiques et Minières
[L'API Qualité des nappes d'eau souterraine](https://hubeau.eaufrance.fr/page/api-qualite-nappes) de Hub'Eau permet d'accéder aux données sur la qualité physico-chimique des nappes d'eau souterraines françaises. ### Description fonctionnelle de l'API Qualité des nappes d'eau souterraine Ces données sont issues de la [banque nationale d'Accès aux Données sur les Eaux Souterraines ADES](http://ades.eaufrance.fr/). Elles concernent plus de 100 millions d'analyses. Les données sont exposées sous la forme d'une API REST, les formats supportés sont : JSON, GeoJSON et CSV. #### Opérations possibles * stations : permet de rechercher les stations de mesure de la qualité des eaux souterraines (ou points d'eau : puits, forages et sources) ; * analyses : permet de récupérer les résultats des analyses, concernant différents paramètres physico-chimiques comme la conductivité, les nitrates, les substances pesticides, les métaux... La recherche des analyses est possible via de nombreux critères dont le point d'eau, la commune, l'aquifère, la masse d'eau, le réseau de mesures, le producteur des données... #### Dernières évolutions de l'API Qualité des nappes d'eau souterraine * 23/12/2025 : v1.3.0 - floutage des coordonnées des captages AEP. Les coordonnées réelles sont remplacées par celles du chef-lieu de la commune. * 05/02/2019 : v1.2.0 - branchement sur un nouvel entrepôt de données permettant 1) une mise à jour au fil de l'eau (au même rythme que dans la base ADES) ; 2) la correction du bug pouvant faire varier le nombre de résultats pour une même requête * 22/05/2018 : v1.1.0 - ajout d'une limitation sur la profondeur d'accès aux résultats, ajout du header "link" pour le format CSV, correction du code retour pour le format CSV gérant le code 200 et 206 * 22/01/2018 : v1.0.1 - correction de bugs * 29/11/2017 : mise à disposition de la v1 #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité. Hub’Eau est le résultat de la collaboration de l’OFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [la page Hub'Eau sur api.gouv](https://api.gouv.fr/producteurs/hub-eau) ou directement [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API. D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Les retours se font sur [le forum de contribution GitHub](http://github.com/BRGM/hubeau/issues). Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation * [Les nitrates dans les cours d'eau et les nappes souterraines des Pays de la Loire](https://ssm-ecologie.shinyapps.io/nitrates_eau/) * [Visualiseur Hub'Eau de la qualité des nappes](https://hubeau.eaufrance.fr/sites/default/files/api/demo/qualnap.htm) * [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### ADES [ADES](http://www.ades.eaufrance.fr) est la banque nationale d’Accès aux Données sur les Eaux Souterraines qui rassemble sur son site internet public des données quantitatives et qualitatives relatives aux eaux souterraines, dont les objectifs sont de constituer un outil de collecte et de conservation des données sur les eaux souterraines, d’être mobilisable par un large ensemble de partenaires, de permettre les traitements nécessaires à l’action de chacun des partenaires, d’être le guichet d’accès aux informations sur les eaux souterraines, d’avoir un suivi de l’état patrimonial des ressources pour répondre à la politique des eaux souterraines, et enfin d’adopter au niveau national un principe de transparence et d’accessibilité aux données sur les eaux souterraines. #### Aquifère Un aquifère est une formation géologique ou une roche, suffisamment poreuse et/ou fissurée (pour stocker de grandes quantités d'eau) tout en étant suffisamment perméable pour que l'eau puisse y circuler librement. Pour se représenter un aquifère, il faut imaginer un vaste réservoir naturel de stockage d'eau souterraine. #### BRGM Le [BRGM (Bureau de Recherches Géologiques et Minières)](http://www.brgm.fr/), service géologique national français, est l'établissement public de référence dans les applications des sciences de la Terre pour gérer les ressources et les risques du sol et du sous-sol. Le BRGM assure notamment la diffusion de données géologiques et environnementales via les technologies de l’information et de la communication, avec pour objectif la mise à disposition des pouvoirs publics, des acteurs économiques et du grand public d'informations géoréférencées pour appuyer leurs décisions. Parmi les domaines de compétence du BRGM figurent les infrastructures informatiques de diffusion, calcul, simulation-visualisation 3D et réalité virtuelle ainsi que l'interopérabilité. #### Eaux souterraines Les eaux souterraines désignent toutes les eaux se trouvant sous la surface du sol en contact direct avec le sol ou le sous-sol et qui transitent plus ou moins rapidement dans les fissures et les pores du sol. #### Nappe d'eau souterraine Une nappe d'eau souterraine est une eau contenue dans les interstices ou les fissures d'une roche du sous-sol qu'on nomme aquifère. #### OFB L'[OFB (Office Français de la Biodiversité)](https://ofb.gouv.fr/) a été créée le 1er janvier 2017. Elle regroupe l'Agence des aires marines protégées, l'Atelier technique des espaces naturels, l'Office national de l'eau et des milieux aquatiques et les Parcs nationaux de France. L'AFB , établissement public du ministère en charge de l'environnement, exerce des missions d’appui à la mise en œuvre des politiques publiques dans les domaines de la connaissance, la préservation, la gestion et la restauration de la biodiversité et des milieux terrestres, aquatiques et marins. Elle vient en appui aux acteurs publics mais travaille également en partenariat étroit avec les acteurs socio-économiques. Elle a aussi vocation à aller à la rencontre du public pour mobiliser les citoyens en faveur de la biodiversité. En matière d’espaces protégés, elle gère notamment les parcs naturels marins et le sanctuaire de mammifères marins Agoa aux Antilles. Elle est opératrice et animatrice de sites Natura 2000 en mer. Les parcs nationaux sont rattachés à l’Agence, des synergies fortes sont mises en place avec eux. #### SANDRE Le [SANDRE (Service d'Administration Nationale des Données et Référentiels sur l'Eau)](http://www.sandre.eaufrance.fr/) a pour mission d'établir et de mettre à disposition le référentiel des données sur l'eau du SIE (Système d'Information sur l'Eau). Ce référentiel, composé de spécifications techniques et de listes de codes libres d'utilisation, décrit les modalités d'échange des données sur l'eau à l'échelle de la France. D'un point de vue informatique, le Sandre garantit l'interopérabilité des systèmes d'information relatifs à l'eau. ### Partenaires de l'API * Eaufrance * Office Français de la Biodiversité * Bureau de Recherches Géologiques et Minières
Hub'Eau - Qualité des nappes d'eau souterraine
[L'API Etat Piscicole](https://hubeau.eaufrance.fr/page/api-poisson) de Hub'Eau ou **API Poisson** diffuse les données collectées lors d'opérations de pêches scientifiques à l'électricité (observations dans un premier temps, puis à terme stations de prélèvement, opérations, et indicateurs). Ces données couvrent la France hexagonale (Corse comprise) et plus de 50 ans de collecte. La source de données est la base ASPE opérée par l'OFB. ### Description fonctionnelle de l'API Poissons L'API Poisson diffuse les données collectées lors d'opérations de pêches scientifiques à l'électricité réalisées par l'Office français de la biodiversité (OFB) et et ses partenaires. Ces données concernent les observations, les indicateurs, les opérations et les stations de prélèvement. Elles couvrent la France hexagonale (Corse comprise) sur plus de 50 années de collecte. Elles sont bancarisées dans l'outil Aspe opéré par l'OFB. Les données sont exposées sous la forme d'une API REST, les formats supportés sont : JSON, GeoJSON et CSV. #### Opérations possibles - **observations** : elle permet d'accéder aux données des observations piscicoles collectées sur des stations en cours d'eau référencées par le Sandre, et consolidées à l'échelle du prélèvement élémentaire ; - **indicateurs** : elle permet d'accéder aux données des indicateurs IPR et IPRPlus calculés à partir des observations piscicoles ; - **operations** : elle permet d'accéder aux données des opérations de prélèvement réalisées sur les stations de mesure de la qualité des cours d'eau ; - **stations** : elle permet d'accéder aux données des stations de mesure de la qualité des cours d'eau. #### Dernières évolutions de l'API Etat piscicole de Hub'Eau - 21/11/2023 : ajout de trois nouveaux endpoints - Indicateurs - Opérations - Stations - 16/06/2022 : v1.0.0, version branchée sur les données ASPE, mise à disposition de l'opération observations - 03/01/2019 : v0.3.1 basée sur l'ancienne base IMAGE. Cette version, obsolète, reste disponible jusqu'au 31 décembre 2022. La documentation de cette ancienne version est accessible à [cette adresse](https://hubeau.eaufrance.fr/api/v0/etat_piscicole/api-docs). #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité. Hub’Eau est le résultat de la collaboration de l’OFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [la page Hub'Eau sur api.gouv](https://api.gouv.fr/producteurs/hub-eau) ou directement [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API. D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Les retours se font sur [le forum de contribution GitHub](http://github.com/BRGM/hubeau/issues). Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation - [Cartographie de la présence des espèces de poissons](https://hubeau.eaufrance.fr/sites/default/files/api/demo/poissons.html) - [Mortalité des saumons et des anguilles par les turbines hydroélectriques](https://public.tableau.com/views/Devalpomi/Devalpomi?:showVizHome=no), par l'association [Logrami - Loire Grands Migrateurs](http://www.logrami.fr/) - [Présence du Silure en France](https://public.tableau.com/views/HubEau/PrsenceduSilure?%3AshowVizHome=no), par l'association [Logrami - Loire Grands Migrateurs](http://www.logrami.fr/) - [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### BRGM Le [BRGM (Bureau de Recherches Géologiques et Minières)](http://www.brgm.fr/), service géologique national français, est l'établissement public de référence dans les applications des sciences de la Terre pour gérer les ressources et les risques du sol et du sous-sol. Le BRGM assure notamment la diffusion de données géologiques et environnementales via les technologies de l’information et de la communication, avec pour objectif la mise à disposition des pouvoirs publics, des acteurs économiques et du grand public d'informations géoréférencées pour appuyer leurs décisions. Parmi les domaines de compétence du BRGM figurent les infrastructures informatiques de diffusion, calcul, simulation-visualisation 3D et réalité virtuelle ainsi que l'interopérabilité. #### OFB L'[OFB (Office Français de la Biodiversité)](https://ofb.gouv.fr/) est un établissement public dédié à la sauvegarde de la biodiversité. Une de ses priorités est de répondre de manière urgente aux enjeux de préservation du vivant. Créé au 1er janvier 2020 par la loi n°2019-773 du 24 juillet 2019, l’Office français de la biodiversité regroupe les agents de l’Agence française pour la biodiversité (AFB) et de l’Office national de la chasse et de la faune sauvage (ONCFS). Unir ces deux établissements dans la lutte pour la protection de la nature, permet de rassembler des expertises, sur les milieux aquatiques, terrestres et marins et faire front commun contre les menaces qui pèsent sur la biodiversité en France. Regrouper ces deux entités, dont les agents sont implantés sur l’ensemble de l’hexagone et les Outre-mer, c’est aussi assurer un ancrage solide dans les territoires pour agir à l’échelle locale. #### Pêche électrique Opération d'inventaire des organismes aquatiques (poissons en général mais aussi crustacés) au moyen d'un courant électrique. Les poissons sont attirés puis paralysés par le champ magnétique, ainsi ils remontent à la surface, sont capturés, identifiés, comptés, mesurés puis relâchés dans leur milieu. #### SANDRE Le [SANDRE (Service d'Administration Nationale des Données et Référentiels sur l'Eau)](http://www.sandre.eaufrance.fr/) a pour mission d'établir et de mettre à disposition le référentiel des données sur l'eau du SIE (Système d'Information sur l'Eau). Ce référentiel, composé de spécifications techniques et de listes de codes libres d'utilisation, décrit les modalités d'échange des données sur l'eau à l'échelle de la France. D'un point de vue informatique, le Sandre garantit l'interopérabilité des systèmes d'information relatifs à l'eau. #### Station Lieu de pêche électrique. Les stations ont un code numérique à 8 chiffres, des coordonnées X, Y et sont rattachées à un cours d'eau. Les stations sont le lieu de pêches électriques à diverses périodes où on prélève les poissons pour déterminer les différentes espèces, les effectifs par espèce puis les classes de tailles par espèce. Les classes de taille ont en général une largeur de 10mm. ### Partenaires de l'API - Eaufrance - Office Français de la Biodiversité - Bureau de Recherches Géologiques et Minières
Hydrométrie temps réel Les données de [l'API "Hydrométrie"](https://hubeau.eaufrance.fr/page/api-hydrometrie) de Hub'Eau sont issues de la Plate-forme HYDRO Centrale (PHyC), opérée par le Service Central Vigicrues (SCV, ex-SCHAPI), service du ministère en charge de l'Ecologie. Cette Plate-forme stocke les mesures quasi temps-réel provenant d’environ 3000 stations hydrométriques qui constituent le réseau de mesure français, opéré par les Directions Régionales de l’Environnement de l’Aménagement et du Logement (DREAL) ou autres producteurs (collectivités, etc.) ainsi que deux types d'observations élaborées (débits moyens journaliers et débits moyens mensuels. L'API permet d'interroger le **référentiel hydrométrique** ainsi que les **observations en quasi temps réel**, mises à jour par leur producteur toutes les 5 à 60 minutes dans la plateforme source (PHyC du SCV). Hub'Eau interroge la source des données toutes les 2 minutes et maintient une profondeur d'historique égale à 1 mois. Depuis le 24 novembre 2021, deux types d'observations "élaborées" (débits moyens journaliers et débits moyens mensuels) sont disponibles sur tout l'historique (depuis 1900 pour certaines stations) pour plus de 4200 ; complétées depuis 2025 par les données relatives aux sites et de nouvelles grandeurs hydrométriques (hauteur instantanée maximale journalière et hauteur instantanée maximale mensuelle). Les données sont mises à jour quotidiennement.. Les observations sont exprimées en **mm** pour les hauteurs d'eau et en **l/s** pour les débits. #### Quatre opérations (endpoints) sont disponibles * **sites** : interroge les sites du référentiel hydrométrique ; * **stations** : interroge les stations du référentiel hydrométrique constituant les sites ; * **obervations\_tr** : liste les observations dites "temps réel" portées par le référentiel (sites et stations hydrométriques), à savoir les séries de données de hauteur d'eau (H) et de débit (Q) ; * **obs\_elab** : liste 2 types d'observations dites "élaborées" : les débits moyens journaliers (QmJ) ainsi que les débits moyens mensuels (QmM) sur l'ensemble de l'historique disponible. * **obs\_elab** : liste divers types d'observations dites "élaborées" sur l'ensemble de l'historique disponible depuis 1900 : * QmnJ : débit moyen journalier, * QmM : débit moyen mensuel, * HIXnJ : hauteur instantanée maximale journalière, * HIXM : hauteur instantanée maximale mensuelle, * QIXnJ : débit instantané maximal journalier, * QIXM : débit instantané maximal mensuel, * QINnJ : débit instantané minimal journalier, * QINM : débit instantané minimal mensuel. Les données sont exposées sous la forme d'une API REST, les formats supportés sont : JSON, GeoJSON, CSV et XML SANDRE. #### Dernières évolutions de l'API Hydrométrie * 2025 * 19/06/2025 : exposition des données pour les hauteurs instantanées maximales journalières et mensuelles (HIXnJ et HIXM) ainsi pour les débits instantanés maxi et mini, journaliers et mensuels (QIXnJ, QIXM, QINnJ, QINM). * 05/05/2025 : arrêt de la version 1 * 2024 * 15/10 : v2 de l'API, qui appelle les services web SANDRE v2 de la PHyC (détails techniques sur la page de l'API) * 18/03 : rechargement des données d'observations élaborées suite à un recalcul de la PHyC * 2021 * 24/11 : Mise à disposition des opérations *observations élaborées* (débits moyens journaliers et mensuels) aux formats JSON et CSV. * 2020 * 05/03 : passage sur serveur dédié pour tenir la charge (10 appels/s en moyenne) * 2019 * 03/01 : v1.0.1 : correction [bug sur l'API observations](https://github.com/BRGM/hubeau/issues/15) * 2018 * 03/12 : suppression de la version beta, passage en production de la v1 * 29/11 : endpoints *observations*, ajout du paramètre timestep permettant la récupération de données à un pas de temps déterminé #### Disponibilité et temps de réponse Le tableau de bord de la santé des API Hub'eau est consultable en ligne : [hubeau.eaufrance.fr/status](https://hubeau.eaufrance.fr/status) ### Connaissez-vous Hub'Eau ? #### Simplifier l'accès aux données sur l'eau Service pérenne de la toile [Eau France](https://www.eaufrance.fr), [Hub'Eau](https://hubeau.eaufrance.fr/) met à disposition des API Rest favorisant l’accès aux données du [SIE](https://www.eaufrance.fr/donnees) dans des formats simples d’emploi et propices à la réutilisation (CSV, JSON, GeoJSON). Fondé sur une infrastructure et des méthodes adaptées au traitement et au stockage de données massives, les API Hub'Eau garantissent les meilleures performances de disponibilité (20 téra-octets de données fournies en 455 millions d'appels pour l'année 2020). Hub’Eau est le résultat de la collaboration de l’OFB et du BRGM dans le cadre du pôle de recherche et d'innovation en interopérabilité des systèmes d'information distribués sur l'eau : [INSIDE](http://www.pole-inside.fr/fr). Pour découvrir toutes les API disponibles dans Hub'Eau, visitez [la page Hub'Eau sur api.gouv](https://api.gouv.fr/producteurs/hub-eau) ou directement [le portail Hub'Eau](https://hubeau.eaufrance.fr/page/apis). #### Un service en co-construction Pour des API toujours plus en phase avec les besoins utilisateurs, Hub'Eau a inauguré en 2018 une [politique de bêta testing](https://hubeau.eaufrance.fr/page/apis) en organisant une campagne de tests ouverte avant la mise la mise en production de chaque nouvelle API. D'une durée de quelques mois, ces campagnes ont pour objectif de recueillir un maximum de retour d’expérience des utilisateurs sur les points forts et les points faibles des API en construction. Les retours se font sur [le forum de contribution GitHub](http://github.com/BRGM/hubeau/issues). Pour être informé de la sortie des nouvelles API et les tester en avant-première, inscrivez-vous à la [newsletter](https://hubeau.eaufrance.fr/newsletter) ! ### Exemples de réutilisation * [Géorivière, gérez et suivez vos cours d'eau](https://georiviere.fr/) * [La vie de la rivière](https://laviedelariviere.valleedulot.com/) * [Alerte Inondation](https://www.alerte-inondation.com/) * [Visualiseur Hub'Eau des débits et hauteurs en temps réel](https://hubeau.eaufrance.fr/sites/default/files/api/demo/hydro_tr.htm) * [Visualiseur Hub'Eau des observations hydrométriques élaborées](https://hubeau.eaufrance.fr/sites/default/files/api/demo/hydro_elab.htm) * [Soumettez le votre sur la page GitHub des utilisateurs de Hub'Eau](https://github.com/BRGM/hubeau) ### Glossaire #### grandeur hydrométrique Type de donnée restituée par une station hydrométrique (hauteur d'eau, débit ou vitesse). Deux grandeurs hydrométriques sont disponibles via l'opération "observations\_tr" de Hub'Eau : la hauteur d'eau et le débit. #### référentiel hydrométrique Le référentiel hydrométrique est constitué de sites, de stations et de capteurs. #### SVC **(ex-SCHAPI)** Basé sur la Météopole de Toulouse, le [Service Central Vigicrues (SCV, ex-SCHAPI)](http://www.side.developpement-durable.gouv.fr/EXPLOITATION/DEFAULT/doc/IFD/I_IFD_REFDOC_0076356/SCHAPI-Service-Central-d-Hydrom%C3%A9t%C3%A9orologie-et-d-Appui-la-Pr%C3%A9vision-des-Inondations) produit et diffuse une information continue de vigilance sur les crues publiée sur le site [Vigicrues](http://www.vigicrues.gouv.fr). Il anime et pilote le réseau de la prévision des crues et de l’hydrométrie de l’État (Services de Prévision des Crues et Unités d’Hydrométrie rattachés aux services régionaux DREAL ou à la direction inter-régionale Sud-Est de Météo-France). #### site hydrométrique Un site hydrométrique est un tronçon de cours d'eau sur lequel les mesures de débit sont réputées homogènes et comparables entre elles. Un site peut posséder une ou plusieurs stations et il ne peut porter que des données de débit. #### station hydrométrique Un appareillage installé sur un site hydrométrique afin d'observer et de mesurer une grandeur spécifique lié à l'hydrologie (hauteur ou débit) constitue une station hydrométrique. Une station peut porter une hauteur et/ou un débit (directement mesurés ou calculés à partir d'une courbe de tarage). Chaque station possède un ou plusieurs capteurs (appareil mesurant une grandeur : hauteur ou débit). Les méthodes de l'API hydrometrie de Hub'Eau permettent d'interroger les sites et les stations hydrométriques mais ne descendent pas au niveau des capteurs. ### Partenaire de l'API * Eaufrance * Office Français de la Biodiversité * Service Central Vigicrues * Bureau de Recherches Géologiques et Minières