# Toutes les bases de données sur l'eau en France à portée de R.

## hubeau: un package pour interroger les APIs du Système d'Information sur l'eau en France

David Dorchies<fnref n="1" />, ID

<figure><img src="image_1.png" /></figure>

david.dorchies@inrae.fr

Pascal Irz<fnref n="2" />, ID

<figure><img src="image_2.png" /></figure>

pascal.irz@ofb.gouv.fr

## Introduction

Hub'Eau<fnref n="1" /> est la plateforme nationale de diffusion des données ouvertes de 12 bases de données nationales sur l'eau en France mise en place en 2018 grâce à une collaboration entre l'Office français de la biodiversité (OFB) et le BRGM. Elle met à disposition des API (Application Programming Interface) web permettant à l'utilisateur de formuler une requête sur un ou plusieurs paramètres et d'utiliser n'importe quel langage de programmation pour collecter les résultats issus de données nationales régulièrement enrichies et mises à jour quotidiennement voire en temps réel.

L'utilisation de telles API pour se révéler ardue et le package R hubeau (Dorchies et al. 2024) publié sur le CRAN<fnref n="2" /> implémente des fonctions qui permettent d'interroger facilement 11 des 12 API mises à disposition sur la plateforme.

## Comment ça marche ?

La syntaxe d'interrogation employée dans le package suit la logique suivante :

```
get_[API]_[endpoint] ([param1] = [Valeurs1],
                     [param2] = [Valeurs2], ...)
```

Le package gère automatiquement la pagination des requêtes et retourne les données sous la forme d'une tibble directement utilisable pour l'analyse et la visualisation.

Par exemple, lister les stations hydrométriques sur la Seine en Île de France revient à :

```
library(hubeau)
```

```
get_hydrometrie_sites(
  code_region = "11", libelle_site = "Seine",
  fields = c("code_site", "libelle_site"),
  unique_site = TRUE
) %>% head
```

```
## # A tibble: 6 × 2
## code_site libelle_site
## <chr> <chr>
## 1 F2210002 La Seine à Bray-sur-Seine
## 2 F2400001 La Seine à Bazoches-lès-Bray
## 3 F4000001 La Seine à Montereau-Fault-Yonne
## 4 F4000002 La Seine à Varennes-sur-Seine
## 5 F4000003 La Seine à Saint-Mammès
## 6 F4470001 La Seine à Melun
```

## 11 API implémentées

<figure><img src="image_3.png" /></figure>

* **Écoulement des cours d'eau** (Observatoire National Des Étiages)

<figure><img src="image_4.png" /></figure>

* **Hydrométrie** (Service Central d'Hydrométéorologie et d'Appui à la Prévision des Inondations)

<figure><img src="image_5.png" /></figure>

* **Indicateur des services** (Observatoire des services d'eau et d'assainissement)

<figure><img src="image_6.png" /></figure>

* **Piézométrie et Qualité des nappes d'eau souterraine** (Plateforme ADES)

<figure><img src="image_7.png" /></figure>

* **Poisson** (Données des pêches scientifiques de l'OFB et ses partenaires)

<figure><img src="image_8.png" /></figure>

* **Prélèvements en eau** (Banque Nationale des Prélèvements quantitatifs en Eau)

<figure><img src="image_9.png" /></figure>

* **Qualité de l'eau potable** (Contrôles sanitaires du Ministère des Solidarités et de la Santé)

<figure><img src="image_10.png" /></figure>

* **Qualité, Température et Hydrobiologie des cours d'eau** (Base de données Naïades)

## Exemples d'utilisation

La documentation du package propose des exemples d'utilisation de chaque API et des exemples avancés sous forme de vignettes (Figure 1 pour l'API "Piézométrie" et Figure 2 pour l'API "Qualité des cours d'eau").

L'OFB a mis en oeuvre des productions régionalisées reproductibles (PRR) exploitant l'API "Ecoulement des cours d'eau".

d'eau" dans des scripts R markdown déployés quotidiennement sur des github pages<fnref n="3" /> (Figure 3).

<figure><img src="image_11.png" /><figcaption>Figure 1: Carte interactive de l'évolution du niveau piézométrique de la nappe phréatique aux environs de Poitiers</figcaption></figure>

<figure><img src="image_12.png" /><figcaption>Figure 2: Evolution annuelle de la concentration en nitrates de l'Armançon à Montigny-sur-Armançon</figcaption></figure>

<figure><img src="image_13.png" /><figcaption>Figure 3: Observations des écoulements du Lirou à Prades-le-Lez (34) issus des PRR Occitanie</figcaption></figure>

## References

Dorchies, D., P. Irz, S. Grall, and P. Amiotte Suchet. 2024. "Hubeau: An r Package for the Hub'eau APIs. R Package Version 0.5.0." https://doi.org/10.57745/XKN6NC.

<figure><img src="image_14.png" /></figure>

RÉPUBLIQUE
FRANÇAISE
Liberté
Égalité
Fraternité

INRAE

<figure><img src="image_15.png" /></figure>

OFB
OFFICE FRANÇAIS
DE LA BIODIVERSITÉ

<figure><img src="image_16.png" /></figure>

<figure><img src="image_17.png" /></figure>

<footnote n="1">¹ G-EAU, Univ Montpellier, AgroParisTech, BRGM, CIRAD, IRD, INRAE, Institut Agro, Montpellier, France</footnote>

<footnote n="2">² OFB, Direction Régionale Bretagne, Cesson-Sévigné, France</footnote>

<footnote n="1">1 https://hubeau.eaufrance.fr</footnote>

<footnote n="2">2 https://cran.r-project.org/package=hubeau</footnote>

<footnote n="3">3 https://github.com/ofb-bzh/PRR_ONDE</footnote>