get_station_list: Retrieve water observation stations

In a-buz/bomWater: Download Australian Bureau of Meteorology Water Data

Description

get_station_list queries Water Data Online and returns station details. Queries can be input with the desired parameter_type to find all the stations on record. If you already have a vector of station numbers, you can pass the vector to station_number and return the details of those stations. return_fields can be customised to return various data about the stations.

Usage

get_station_list(parameter_type, station_number, bbox, return_fields)

Arguments

parameter_type	The parameter for the station request (e.g. Water Course Discharge, Storage Level)
station_number	Optional: a single or multiple vector of AWRC station numbers.
bbox	Optional: a bounding box to get stations in a region of interest. Takes a vector ordered xmin, ymin, xmax, ymax.
return_fields	Station details to be returned. By default the columns returned are station name, number, ID, latitude and longitude. Can be customised with a vector of parameters.

Details

Possible return fields for get_station_list() are:

• station_name

• station_longname

• station_no

• station_id

• station_latitude

• station_longitude

• station_carteasting

• station_cartnorthing

• stationparameter_name

• station_georefsystem

• catchment_no

• catchment_id

• catchment_name

• site_no

• site_id

• site_name

• parametertype_id

• parametertype_name

• object_type

• custom_attributes

Value

With the default return fields, a tibble with columns station_name, station_no, station_id, station_latitude, station_longitude.

Author(s)

Alexander Buzacott

Examples

# Get all Water Course Discharge Stations
## Not run: 
get_station_list()

## End(Not run)
# Just the details for Cotter River at Gingera
## Not run: 
get_station_list(station_number = "410730")

## End(Not run)
# Rainfall stations
## Not run: 
get_station_list(parameter_type = "Rainfall")

## End(Not run)
# Vector of return_fields
return_fields <- c(
  "station_name",
  "station_longname",
  "station_no",
  "station_id",
  "station_latitude",
  "station_longitude",
  "station_carteasting",
  "station_cartnorthing",
  "stationparameter_name",
  "station_georefsystem",
  "catchment_no",
  "catchment_id",
  "catchment_name",
  "site_no",
  "site_id",
  "site_name",
  "parametertype_id",
  "parametertype_name",
  "object_type",
  "custom_attributes"
)
# Get all attributes for one station
## Not run: 
get_station_list("Water Course Discharge", "410730", return_fields)

## End(Not run)

a-buz/bomWater documentation built on Sept. 3, 2021, 8:21 a.m.