hubeau an R package for the Hub’Eau APIs

‘hubeau’ is an R-package proposing a collection of function to help retrieve data from the French national databases on water: https://hubeau.eaufrance.fr

Installation

# Install released version from CRAN
install.packages("hubeau")

# Install development version from GitHub:
# install.packages("remotes")
remotes::install_github("inrae/hubeau")

Loading library

library(hubeau)

Get started

The ‘hubeau’ package provides functions for ‘Hub’Eau’ APIs and their related endpoints. These functions are named as follow: hubeau::get_[API]_[endpoint].

Currently available APIs and related endpoints are listed below.

API “Ecoulement des cours d’eau”

API documentation: https://hubeau.eaufrance.fr/page/api-ecoulement

Available functions:

• get_ecoulement_stations: site data and locations
• get_ecoulement_observations: flow observations collected during campaigns
• get_ecoulement_campagnes: observation campaign information

API “Hydrométrie”

API documentation: https://hubeau.eaufrance.fr/page/api-hydrometrie

Available functions:

• get_hydrometrie_sites: hydrometry sites (can contain several stations)
• get_hydrometrie_stations: hydrometry stations
• get_hydrometrie_observations_tr: hydrometry water level and discharge time series
• get_hydrometrie_obs_elab: hydrometric elaborate observations (daily/monthly mean flow)

API “Indicateurs des services”

API documentation: https://hubeau.eaufrance.fr/page/api-indicateurs-services

Available functions:

• get_indicateurs_services_communes: performance indicators by commune
• get_indicateurs_services_indicateurs: performance indicators by indicator
• get_indicateurs_services_services: performance indicators by commune for each service

API “Piézométrie”

API documentation: https://hubeau.eaufrance.fr/page/api-piezometrie

Available functions:

• get_niveaux_nappes_chroniques: archived time series of piezometric stations
• get_niveaux_nappes_chroniques_tr: real-time time series of piezometric stations
• get_niveaux_nappes_stations: piezometric stations

API “Poisson”

API documentation: https://hubeau.eaufrance.fr/page/api-poisson

Available function:

• get_poisson_observations: scientific fishery observations

API “Prélèvements en eau”

API documentation: https://hubeau.eaufrance.fr/page/api-prelevements-eau

Available functions:

• get_prelevements_chroniques: time series of annual withdrawn volumes by device
• get_prelevements_ouvrages: withdrawal devices (can contain several withdrawal points)
• get_prelevements_points_prelevement: withdrawal points

A complete documentation is available on the package website: https://inrae.github.io/hubeau/

Acknowledgements

The authors would like to thank the European Commission and the French National Research Agency (ANR) for funding in the frame of the collaborative international consortium IN-WOP financed under the 2018 Joint call of the WaterWorks2017 ERA-NET Cofund. This ERA-NET is an integral part of the activities developed by the Water JPI.