WaterOneFlow Web Services & WaterML

Web services are computer applications that interact with and exchange information with other applications over the internet. The CUAHSI-HIS uses a family of web services, called WaterOneFlow, that have been developed as a standard mechanism for the TRANSFER of hydrologic data between hydrologic data servers (databases) and users computers. Web services streamline the often time consuming tasks of extracting data from a data source, transforming it into a usable format and loading it in to an analysis environment. Web services format the data as XML and the specific variety of XML that is generated by the WaterOneFlow web services is known as CUAHSI WaterML. The specifics of WaterML are documented in the OGC™ Discussion Paper, CUAHSI WaterML [PDF; 296K; 86 pages].

Please let us know if you have any questions or comments related to using WaterOneFlow web services and Water ML with our feedback page.


Topic Quick Links:

WaterOneFlow

^Top

WaterOneFlow Web Service Functions:

  • GetSiteInfo — Given a site number, this method returns the site's metadata as a string
  • GetSiteInfoObject — Given a site number, this method returns the site's metadata an an object
  • GetSitesXml — Given an array of site numbers, this method returns the site metadata, as a string, for each one.
  • GetSites — Given an array of site numbers, this method returns the site metadata, as an object, for each one.
  • GetVariableInfo — Given a variable code, this method returns the variable's name as a string.
  • GetVariableInfoObject — Given a variable code, this method returns the variable's siteName as an object.
  • GetValues — Given a site number, a variable, a start date, and an end date, this method returns a time series as a string.
  • GetValuesObject — Given a site number, a variable, a start date, and an end date, this method returns a time series as an object.

WaterOneFlow Resources:

WaterML

^Top

WaterML Version 1.1:


WaterML Version 1.0:

CUAHSI WaterOneFlow Data Services

^Top

The CUAHSI-HIS project has identified a number of 3rd-party data sources that are of value to the hydrologic data community, and have negotiated a variety of access arrangements to allow CUAHSI to provide WaterOneFlow web service access to this data. The following web services are hosted at HIS Central. Generally the data underlying these web services are maintained by the originating organization, however metadata catalogs have been developed and are hosted at HIS Central to index and support some of these web services.

  • USGS NWIS Daily Value Data (Discharge; Daily Averaged Real Time Data) — The USGS National Water Information System (NWIS) provides access to millions of sites measuring streamflow, groundwater levels, and water quality. This web service provides methods for retrieving daily values data, such as discharge and water levels, from NWIS. For more information about NWIS, see the NWIS home page at http://waterdata.usgs.gov/nwis.
  • USGS NWIS Ground Water Data — The USGS National Water Information System (NWIS) provides access to millions of sites measuring streamflow, groundwater levels, and water quality. This web service provides methods for retrieving Ground Water data from NWIS. For more information about NWIS, see the NWIS home page at http://waterdata.usgs.gov/nwis.
  • USGS NWIS Unit Values Data (Real Time) — The USGS National Water Information System (NWIS) provides access to millions of sites measuring streamflow, groundwater levels, and water quality. This web service provides methods for retrieving Real Time data from NWIS. For more information about NWIS, see the NWIS home page at http://waterdata.usgs.gov/nwis.
  • USGS NWIS Instantaneous Irregular Data (Field Measuements; Water Quality) — The USGS National Water Information System (NWIS) provides access to millions of sites measuring streamflow, groundwater levels, and water quality. This web service provides methods for retrieving Water Quality data from NWIS. For more information about NWIS, see the NWIS home page at http://waterdata.usgs.gov/nwis.
  • EPA STORET (STOrage and RETrieval) — STORET is a repository for water quality, biological, and physical data and is used by state environmental agencies, EPA and other federal agencies, universities, private citizens, and many others. For for information see: http://www.epa.gov/storet/.
  • USDA-NRCS SNOTEL — NRCS operates a systems to collect snowpack and related climatic data in the Western United States and Alaska. For more information see: http://www.wcc.nrcs.usda.gov/snotel/.
  • ORNL DAYMET Meteorological Model — Daymet is a model that generates daily surfaces of temperature, precipitation, humidity, and radiation over large regions of complex terrain. Daymet was developed at the University of Montana, Numerical Terradynamic Simulation Group (NTSG) at http://www.ntsg.umt.edu, to fulfill the need for fine resolution, daily meteorological and climatological data necessary for plant growth model inputs. Operated by the National Center for Atmospheric Research.
  • NOAA-NCDC/NWS ASOS (Automated Surface Observing System) — The ASOS program is a joint effort of the National Weather Service (NWS), the Federal Aviation Administration (FAA), and the Department of Defense (DOD). The ASOS systems serves as the nation's primary surface weather observing network. ASOS is designed to support weather forecast activities and aviation operations and, at the same time, support the needs of the meteorological, hydrological, and climatological research communities. For more information see: http://www.nws.noaa.gov/asos/.
  • NASA MODIS (Moderate Resolution Imaging Spectroradiometer) — MODIS is a key instrument aboard the Terra (EOS AM) and Aqua (EOS PM) satellites. Terra's orbit is timed so that it passes from north to south across the equator in the morning, while Aqua passes south to north over the equator in the afternoon. Terra MODIS and Aqua MODIS are viewing the entire Earth's surface every 1 to 2 days, acquiring data in 36 spectral bands, or groups of wavelengths (see MODIS Technical Specifications). More information can be obtained at: http://modis.gsfc.nasa.gov/about/.
  • NCEP NAM (North American Mesoscale) 12K — Data from the NCEP North American Mesoscale (NAM) Weather Research and Forecasting (WRF) model. More information can be obtained at: http://www.meted.ucar.edu/.

Additional WaterML Web Services

^Top

The following data sources have developed versions of WaterOneFlow web services that share data using the WaterML format directly from their own servers:

Each data network has it's own set of web services. CUAHSI-HIS maintains a central registry of all public WaterOneFlow web services.

© 2008-2010 CUAHSI-HIS

This material is based upon work supported by the National Science Foundation (NSF) under Grant Nos. 04-12975, 041-3265, and 06-22374.
Any opinions, findings and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the NSF.