WaterML (version 1.9.5)

GetSites: GetSites

Description

This function gets the table of sites from the WaterML web service

Usage

GetSites(server, west = NULL, south = NULL, east = NULL, north = NULL)

Arguments

server

The URL of the web service ending with .WSDL, for example: http://icewater.usu.edu/MudLake/cuahsi_1_0.asmx?WSDL alternatively this can be the REST URL to get the sites.

west

Optional parameter: The west longitude of the geographic bounding box in decimal degrees. Allowed values are between -180.0 and +180.0

south

Optional parameter: The south latitude of the geographic bounding box in decimal degrees. Allowed values are between -90.0 and +90.0

east

Optional parameter: The east longitude of the geographic bounding box in decimal degrees. Allowed values are between -180.0 and +180.0

north

Optional parameter: The north latitude of the geographic bounding box in decimal degrees. Allowed values are between -90.0 and +90.0

Value

a data.frame of sites. The data.frame has the following columns:

• SiteID: The site ID in the original database

• SiteName: The name of the site

• SiteCode: A short unique code of the site

• FullSiteCode: The complete unique code of the site in the format NETWORK:CODE. Use this value in the GetSiteInfo and GetValues functions

• Latitude: The WGS84 latitude in decimal degrees

• Longitude: The WGS84 longitude in decimal degrees

• Elevation: The elevation of the site above sea level in meters

• State: Only for sites in the USA: the state of the site

• County: Only for sites in the USA: The county of the site

• Comments: Additional comments about the sites (note: this field is often empty)

The output data.frame also has attributes with information about the status: download.time, parse.time, download.status, parse.status These attributes can be used for troubleshooting WaterOneFlow/WaterML server errors.

Examples

# NOT RUN {
#Getting all sites from a service
sites <- GetSites("http://hydroportal.cuahsi.org/ipswich/cuahsi_1_1.asmx?WSDL")

#Getting a subset of sites restricted by geographical area
server <- "http://hydroportal.cuahsi.org/NEON/cuahsi_1_1.asmx?WSDL"
sites_subset <- GetSites(server, west=-115.0, south=40.0, east=-110.0, north=42.0)
# }