Imports data from the Water Quality Portal based on a specified url.
Arguments
- obs_url
character URL to Water Quality Portal#' @keywords data import USGS web service
- tz
character to set timezone attribute of datetime. Default is UTC (properly accounting for daylight savings times based on the data's provided tz_cd column). Possible values include "America/New_York","America/Chicago", "America/Denver","America/Los_Angeles", "America/Anchorage","America/Honolulu","America/Jamaica","America/Managua", "America/Phoenix", and "America/Metlakatla"
- csv
logical. Is the data coming back with a csv or tsv format. Default is
FALSE
. Currently, the summary service does not support tsv, for other services tsv is the safer choice.- convertType
logical, defaults to
TRUE
. IfTRUE
, the function will convert the data to dates, datetimes, numerics based on a standard algorithm. If false, everything is returned as a character.
Value
retval dataframe raw data returned from the Water Quality Portal. Additionally, a POSIXct dateTime column is supplied for start and end times, and converted to UTC. See https://www.waterqualitydata.us/portal_userguide/ for more information.
Examples
# These examples require an internet connection to run
## Examples take longer than 5 seconds:
# \donttest{
rawSampleURL <- constructWQPURL("USGS-01594440", "01075", "", "")
rawSample <- importWQP(rawSampleURL)
#> GET: https://www.waterqualitydata.us/data/Result/search?siteid=USGS-01594440&pCode=01075&mimeType=csv
STORETex <- constructWQPURL("WIDNR_WQX-10032762", "Specific conductance", "", "")
STORETdata <- importWQP(STORETex)
#> GET: https://www.waterqualitydata.us/data/Result/search?siteid=WIDNR_WQX-10032762&characteristicName=Specific%20conductance&mimeType=csv
STORETdata_char <- importWQP(STORETex, convertType = FALSE)
#> GET: https://www.waterqualitydata.us/data/Result/search?siteid=WIDNR_WQX-10032762&characteristicName=Specific%20conductance&mimeType=csv
# }