hydrodownloadR: Hydrologic Station Catalogs and Time Series from Public APIs

Provides a unified, extensible interface for discovering hydrological stations and downloading hydrological daily time series (e.g., water discharge, water level, water temperature) and discrete water-quality observations from national and regional public APIs. Water-quality observations are retained at their original sampling timestamps. Includes a provider registry, S3 generics 'stations' and 'timeseries', licensing metadata, date-range and 'complete history' modes, rate limiting and retries, optional authentication via environment variables, tidy outputs, UTF-8 to ASCII transliteration, and WGS84 coordinates. Designed for reproducible workflows and straightforward addition of new providers. Background and use cases are described in Farber et al. (2025) <doi:10.5194/essd-17-4613-2025> and Farber et al. (2023) <doi:10.57757/IUGG23-2838>.

Version: 0.1.5
Depends: R (≥ 4.1.0)
Imports: cli, dataRetrieval, DBI, dplyr, httr, httr2 (≥ 1.1.0), jsonlite, lubridate, pdftools, progress, rappdirs, ratelimitr, rlang, RSQLite, sf, magrittr, tibble, cellranger, stringi, stringr
Suggests: odbc, purrr, readr, readxl, rvest, tidyr, tidyselect, xml2, cachem, curl, memoise, testthat (≥ 3.0.0), writexl
Published: 2026-09-14
DOI: 10.32614/CRAN.package.hydrodownloadR
Author: Henning Plessow [aut, cre], Global Runoff Data Centre [ctb]
Maintainer: Henning Plessow <h.plessow at googlemail.com>
BugReports: https://github.com/bafg-bund/hydrodownloadR/issues
License: MIT + file LICENSE
URL: https://hydrodownloadr.bafg.de/, https://github.com/bafg-bund/hydrodownloadR
NeedsCompilation: no
Language: en-US
Materials: README, NEWS
In views: Hydrology
CRAN checks: hydrodownloadR results

Documentation:

Reference manual: hydrodownloadR.html , hydrodownloadR.pdf

Downloads:

Package source: hydrodownloadR_0.1.5.tar.gz
Windows binaries: r-devel: hydrodownloadR_0.1.3.zip, r-release: hydrodownloadR_0.1.3.zip, r-oldrel: hydrodownloadR_0.1.3.zip
macOS binaries: r-release (arm64): hydrodownloadR_0.1.3.tgz, r-oldrel (arm64): hydrodownloadR_0.1.5.tgz, r-release (x86_64): hydrodownloadR_0.1.5.tgz, r-oldrel (x86_64): hydrodownloadR_0.1.5.tgz
Old sources: hydrodownloadR archive

Linking:

Please use the canonical form https://CRAN.R-project.org/package=hydrodownloadR to link to this page.