Home > Resources > Web Services

Water Quality Inventory & Monitoring Program Database Web Services

Description

RESTful web service interfaces have been developed to augment the Site Search web form, and to facilitate exchange of monitoring program and site information with other databases and web portals. Available services and syntax are described below. Note that web services are deployed on the database server, but requests are reverse-proxied through a web application on the portal web site to permit access logging and provide additional input validation. Please contact the database administrator if you have any additional questions about these services.

Available Services

» getPrograms

Description: retrieves information about water quality monitoring programs and sponsoring organizations in XML format

Base Address: http://www.gcrc.uga.edu/wqmeta/app/rest_proxy.asp?service=getPrograms

Parameters:

  • OrgID: integer ID of the sponsoring organization (optional, default = 0 for any)

Output Schema: http://www.gcrc.uga.edu/wqmeta/xml/nps_waterquality_programs.xsd

» findSitesXml

Description: retrieves information about monitoring sites that match various criteria in XML format (web service version of the Site Search page)

Base Address: http://www.gcrc.uga.edu/wqmeta/app/rest_proxy.asp?service=findSitesXml

Parameters:

  • Programs: comma-delimited list of integer program IDs (optional, default = blank for any)
  • SiteName: string to match to site names (optional, default = blank)
  • DateStart: date of earliest starting date for monitoring activity (optional, default = 1/1/1800)
  • DateEnd: date of latest ending date for monitoring activity (optional, default = 12/31/2100)
  • HUC: 8-digit or 12-digit string hydrologic unit code (optional, default = blank for any)
  • North: maximum latitude in decimal degrees (optional, default = 90)
  • South: minimum latitude in decimal degrees (optional, default = -90)
  • West: minimum longitude in decimal degrees (optional, default = -180)
  • East: maximum longitude in decimal degrees (optional, default = 180)
  • Parameter: string to match to parameter name (optional, default = blank for any)
  • TypeCode: comma-delimited list of site type codes to match (optional, default = blank)
    • buoy (instrumened buoy)
    • groundwater (ground water monitoring site)
    • meteorology (meteorological station)
    • nutrients (nutrient sampling station)
    • shellfish (shellfish contaminant site)
    • streamflow (streamflow gauging station)
    • tidegauge (tide gauging station)
    • waterquality (water quality sampling station)
  • Probabilistic: probabilistic sampling site flag (optional, default = either)
    • yes (probabilistic sampling scheme)
    • no (fixed-site sampling scheme)
    • either (either sampling scheme)
  • State: 2-letter state abbreviation or state name (optional, default = blank for any)

Output Schema: http://www.gcrc.uga.edu/wqmeta/xml/nps_waterquality_metadata.xsd

» findSitesKml

Description: retrieves information about monitoring sites that match various criteria in Google Earth™ KML format

Base Address: http://www.gcrc.uga.edu/wqmeta/app/rest_proxy.asp?service=findSitesKml

Parameters:

  • Programs: comma-delimited list of integer program IDs (optional, default = blank for any)
  • SiteName: string to match to site names (optional, default = blank)
  • DateStart: date of earliest starting date for monitoring activity (optional, default = 1/1/1800)
  • DateEnd: date of latest ending date for monitoring activity (optional, default = 12/31/2100)
  • HUC: 8-digit or 12-digit string hydrologic unit code (optional, default = blank for any)
  • North: maximum latitude in decimal degrees (optional, default = 90)
  • South: minimum latitude in decimal degrees (optional, default = -90)
  • West: minimum longitude in decimal degrees (optional, default = -180)
  • East: maximum longitude in decimal degrees (optional, default = 180)
  • Parameter: string to match to parameter name (optional, default = blank for any)
  • TypeCode: comma-delimited list of site type codes to match (optional, default = blank)
    • buoy (instrumened buoy)
    • groundwater (ground water monitoring site)
    • meteorology (meteorological station)
    • nutrients (nutrient sampling station)
    • shellfish (shellfish contaminant site)
    • streamflow (streamflow gauging station)
    • tidegauge (tide gauging station)
    • waterquality (water quality sampling station)
  • Probabilistic: probabilistic sampling site flag (optional, default = either)
    • yes (probabilistic sampling scheme)
    • no (fixed-site sampling scheme)
    • either (either sampling scheme)
  • State: 2-letter state abbreviation or state name (optional, default = blank for any)

Output Schema: http://code.google.com/apis/kml/schema/kml21.xsd

» getSitesXml

Description: retrieves information about water quality monitoring sites in XML format

Base Address: http://www.gcrc.uga.edu/wqmeta/app/rest_proxy.asp?service=getSitesXml

Parameters:

  • Sites: comma-delimited list of integer site ids (required)

Output Schema: http://www.gcrc.uga.edu/wqmeta/xml/nps_waterquality_metadata.xsd

» getSitesKml

Description: retrieves information about water quality monitoring sites in Google Earth™ KML format

Base Address: http://www.gcrc.uga.edu/wqmeta/app/rest_proxy.asp?service=getSitesKml

Parameters:

  • Sites: comma-delimited list of integer site ids (required)

Output Schema: http://code.google.com/apis/kml/schema/kml21.xsd