Generalized USGS data retrieval function — read_USGS

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

Usage

read_USGS_data(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


# \donttest{
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_USGS_data(service = "daily",
                          CQL = cql,
                          time = c("2023-01-01", "2024-01-01"))
#> Function in development, use at your own risk.
#> Remaining requests this hour:626 

# }