Jump to main content or area navigation.

Contact Us

Water: Services

Total Waters Service

Description

Returns precalculated summary information about the surface water and the EPA water quality and other information by state, Hydrologic Unit Code (HUC) 8 subbasins and NHD Feature Codes.

Usage Scenarios

Hydrologic Unit Code (HUC) Based Strategic Measure Support

Problem Statement

Need to periodically generate acres, miles, and counts of impaired waters by 8 digit HUC to compare values to baseline numbers for strategic measures.

Desired Information

By HUC (and potentially by state as a subcategory for additional management planning), provide a table of acres, miles, and counts of impaired waters.

Information Returned from Service

Table by HUC of square kilometers, meters, and counts of impaired water events.

      

Input

Parameters

Parameter Datatype Description
pPrograms String Array of program abbreviations to be examined. See Appendix B for a list of current RAD programs.
pProgramsMod String Modifier explaining the array format used in pPrograms. See the complex object modifier descriptions for more information.
pStates String Array of state abbreviations to be examined. A single string value of '*' will query all states.
pStatesMod String Modifier explaining the array format used in pStates. See the complex object modifier descriptions for more information. 
pHucs String Array of HUC codes to be examined.
pHucsMod String Modifier explaining the array format used in pHucs. See the complex object modifier descriptions for more information. 
pBorderPolicy String TRUE/FALSE - TRUE indicates to group state results out by border water codes while FALSE indicates to use full state codes only. 
pGroupingName String FCODE/BASE_MAP/INT_PEREN/ALL - Parameter indicating whether to group results into predefined fcode categories. See Appendix C for list of FCODE groupings.
pNHDCustom String TRUE/FALSE - Indicates whether to include custom or nonstandard events in results.
pStGrouping String TRUE/FALSE - Indicates whether to group by the state type indicated by the p_border_policy flag.
pHucGrouping String TRUE/FALSE - Indicates whether to group by HUC values (results may be extensive).

HTTP Service Notes

Additional parameters specific to HTTP services are listed in the WATERS HTTP Services documentation.

SOAP Service Notes

The parameter listing for SOAP services is slightly different.  Array parameters are not followed by a "mod" parameter as the array format is specified by the WSDL documentation.  For SOAP services, the input geometry parameter is always OGC Well-Known Text (WKT) and thus the secondary "mod" parameter is simply a numeric value of the Oracle Spatial Reference ID.

Output

UML Diagram

Total Waters Service UML 
Return Object

total_waters_service_output

Property Datatype Description
total_waters_service_results Object Object Type: total_waters_service_results                               

Supporting Objects

total_waters_service_results object

Property Datatype Description
st String State code for nhd or event records including border waters codes if state grouping and border waters flags have been chosen. See Appendix D for a complete list of border waters codes.
nhdSt String State code for nhd or event records if state grouping flag has been chosen. All border waters are allocated to the state best covering the nhd or event record.
huc String Subbasin values for nhd or events records if huc grouping flag has been chosen.
pgmSys String 'NHD' or program abbreviation. See Appendix B for a complete list of program abbreviations.
fcodeGroup String Fcode group chosen in p_grouping_name parameter.
borderFlag String 1/0 equaling Y/N values in p_border_policy parameter.
nhdFlag String 1/0 equaling Y/N values in p_nhd_custom parameter.
featureClass String A/L/P value indicating area, line or point records.
featureTotal Number Sum of area record area, line record length or count of point records.  For point records, this is the count of total records, for line records this the sum of records in kilometers, for area records, this is the sum of records in square kilometers.
shape Geometry Geometry representing the summed feature.

HTTP Service Notes

Additional parameters specific to HTTP services are listed in the WATERS HTTP Services documentation.

SOAP Service Notes

The parameter listing for SOAP services is slightly different.  Array parameters are not followed by a "mod" parameter as the array format is specified by the WSDL documentation.  For SOAP services, the input geometry parameter is always OGC Well-Known Text (WKT) and thus the secondary "mod" parameter is simply a numeric value of the Oracle Spatial Reference ID.

Javascript Library

Function Name
WATERS.Services.TotalWatersService

HTTP Service

Resource Location
Runtime
Endpoint
http://ofmpub.epa.gov/waters10/waters_services.TotalWatersService

Web Service (SOAP)

Resource Location
Runtime
Endpoint
http://ofmpub.epa.gov/WATERSWebServices/OWServices
WSDL
Endpoint
http://ofmpub.epa.gov/WATERSWebServices/OWServices?WSDL

Database Service

Database service users will require the RAD_PUBLIC role for accessing unprotected RAD program results. Accessing protected RAD program data requires additional roles which must be may only be obtained through proper EPA channels.

Database
Instance
Schema Resource
WATERS10 ow_service total_waters_service.main_precalculated_srv

Changelog

Version: 2.0 - Released: August 31, 2009

  • Initial Release of HTTP Services and updated web page content

Jump to main content.