read_waterdata: Generalized USGS Water Data API retrieval function

In dataRetrieval: Retrieval Functions for USGS and EPA Hydrology and Water Quality Data

Generalized USGS Water Data API retrieval function

Description

Function that allows complex CQL queries. See https://api.waterdata.usgs.gov/docs/ogcapi/complex-queries/ for more information.

Usage

read_waterdata(service, CQL, ..., convertType = TRUE)

Arguments

service	character, can be any existing collection such as "daily", "monitoring-locations", "time-series-metadata"
CQL	A string in a Common Query Language format.
...	Additional arguments to send to the request.
convertType	logical, defaults to TRUE. If TRUE, the function will convert the data to dates and qualifier to string vector.

Examples

cql <- '{
"op": "and",
"args": [
  {
    "op": "in",
    "args": [
      { "property": "parameter_code" },
      [ "00060", "00065" ]
    ]
  },
 {
    "op": "in",
    "args": [
      { "property": "monitoring_location_id" },
      [ "USGS-07367300", "USGS-03277200" ]
    ]
  }
]
}'

dv_data <- read_waterdata(service = "daily",
                          CQL = cql,
                          time = c("2023-01-01", "2024-01-01"))

dataRetrieval documentation built on June 28, 2025, 1:08 a.m.