AQWPDownload: Function to download data from https://water.data.sa.gov.au

In SWTools: Helper Tools for Australian Hydrologists

Function to download data from https://water.data.sa.gov.au

Description

For most inputs, valid options will be returned if an unexpected input is provided. The exception are Location and Dataset, if the location, or dataset for that location, don't exist no data will be returned. Browse the Export tab on https://water.data.sa.gov.au to find Location and Dataset that exists.

Usage

AQWPDownload(
  Location,
  Dataset,
  Unit,
  file = "AQWP.json",
  Interval = "Daily",
  Calculation = "Aggregate",
  Calendar = "CALENDARYEAR",
  Step = 1,
  DateRange = "EntirePeriodOfRecord",
  StartTime = NULL,
  EndTime = NULL
)

Arguments

Location	A string or vector of strings, with site numbers, e.g. "A4261001"
Dataset	A string or vector of strings, with dataset names, as expected by AWQP, e.g. "Tide Height.Best Available–Continuous"
Unit	A string or vector of strings, with units, e.g. "Metres" or "mg/L". If only 1 is string is provided it will be used for each site in Location
file	Location and name of json file to download. Defaults to "AQWP.json".
Interval	Interval of output, e.g. "PointsAsRecorded", or "Daily"
Calculation	For larger intervals, what calculation to do, e.g. "Aggregate" (average) or "Maximum"
Calendar	When to start the periods, e.g. "WATERDAY9AM"
Step	How many intervals e.g. 15 with Interval="Minutely" returns 15 minute data.
DateRange	Period of data to return, e.g. "EntirePeriodOfRecord" or "Custom". "Years1" seems to not work on AWQP.
StartTime	Start Date and Time if DateRange="Custom", in a format that as.POSIXct will convert, e.g 2000-01-01 00:00
EndTime	End Date and Time if DateRange="Custom", in a format that as.POSIXct will convert, e.g 2001-01-02 00:00

Value

The lnk created to download the data, which is useful for debugging. The data is saved to "file", that can then be read in with AQWPLoad()

Examples

## Not run: 
Location=c("A4260633","A4261209","A4260572")
Dataset=rep("Tide Height.Best Available--Continuous",3)
Unit=rep("Metres",3)
S="2020-01-01 00:00"
E="2020-01-02 00:00"
AQWPDownload(Location,Dataset,Unit,DateRange="Custom",
StartTime=S,EndTime=E,file=tempfile("AQWP",fileext=".json"))

## End(Not run)

SWTools documentation built on May 31, 2023, 6:24 p.m.