Skip to contents

Make a request to the telemetrystations/telemetrystation/ endpoint to locate telemetry stations by AOI, station abbreviations, county, division, station abbreviation, GNIS ID, USGS Station ID, or WDID

Usage

get_telemetry_stations(
  aoi = NULL,
  radius = NULL,
  abbrev = NULL,
  county = NULL,
  division = NULL,
  gnis_id = NULL,
  usgs_id = NULL,
  water_district = NULL,
  wdid = NULL,
  api_key = NULL
)

Arguments

aoi

list of length 2 containing an XY coordinate pair, 2 column matrix/dataframe of XY coordinates, sf or Terra SpatVector point/polygon/linestring geometry

radius

numeric, search radius in miles around given point (or the centroid of a polygon). If an AOI is given, radius defaults to 20 miles. If no AOI is given, then default is NULL.

abbrev

character vector or list of characters of station abbreviation

county

character, indicating the county to query

division

numeric, indicating the water division to query

gnis_id

character, water source - Geographic Name Information System ID

usgs_id

character, indicating USGS Station ID

water_district

numeric, indicating the water district to query

wdid

character indicating WDID code of structure

api_key

character, API authorization token, optional. If more than maximum number of requests per day is desired, an API key can be obtained from CDSS.

Value

dataframe of telemetry station info

Examples

if (FALSE) {
# Retrieve telemetry stations within a county
telemetry_station <- get_telemetry_stations(
                               county = "Adams"
                               )

# plot telemetry station locations
plot(telemetry_station$latitude~telemetry_station$longitude)
}