WATERS Web, Mapping, and Database Services
Description
WATERS is based on a Service Oriented Architecture (SOA) implementation. Based on the guiding principles of SOA, WATERS provides a suite of interoperable services that expose components that perform complex analysis and supporting strategic datasets, such as NHD, NHDPlus, and WBD.
Web and Database Services
The WATERS Web and Database services provide open interfaces to complex analyses. These services make extensive use of the NHD and referenced program data in the RAD, and also integrate other WATERS program data. Designed as loosely coupled modular units, the services are developed in a common architecture.
The SOAP Services use the Web Services Description Language (WSDL) to describe the functions available in each service. The services use the Simple Object Access Protocol (SOAP) protocol to exchange XML messages between client applications and the services. For services with complex SOAP signatures, a simplified interface has been provided for use in testing and evaluation.
The HTTP Services provided REST-like access to the WATERS database services. Underneath, these services leverage the same codebase as the SOAP Services. Consumers should take advantage of the WATERS JavaScript Library when working with HTTP Services.
The WATERS Database Services require users to be on the EPA network and to have a TSMSS ID and schema password. Database Services provide users with the advantage of deploying applications within EPA that can take advantage of direct database call functionality.
| Service Name | JavaScript Library Function | HTTP Service | SOAP Service | Database Service |
|---|---|---|---|---|
|
Validate Lat/Long Service Utility function for validating a point's geographic latitude and longitude given in decimal degrees for use against the Reach Address Database (RAD). |
|
|
||
|
Convert Lat/Long Service Utility function for converting a point's geographic location latitude and longitude from degrees, minutes, and seconds to decimal degrees. |
|
|
||
|
Get Entities by Lat/Long Service Service for identifying details of all water entities within a given radius of a specified geographic location for specific WATERS programs. |
|
|
||
|
Get Entities By Huc Service Query for identifying details of all water entities within a given subbasin for specific WATERS programs. |
|
|
||
|
Get Entities Miles By Lat/Long Service Query for identifying details of all water entities within a given radius of a specified geographic location for specific WATERS programs. |
|
|
||
|
Get Program Waters Entities Service identifying details of a given list of entities for specific WATERS programs. |
|
|
||
|
Event Indexing Service Event Indexing Engine created to allow users to dynamically or batch index features to the National Hydrography Database and create RAD-ready events. |
|
|
|
|
|
Point Indexing Service Service providing straightforward point indexing via distance or nhdplus flow direction raindrop indexing to nhd features. |
|
|
|
|
|
Identify Service Utility function for reporting on the NHD components and/or RAD events currently occurring on a reach or at a specific measure of a reach. |
|
|
|
|
|
Total Waters Service Analytical function for returning precalculated extent totals of NHD features and RAD events by state, HUC8 or FCODE. |
|
|
|
|
|
Total Waters Geometry Service Analytical function for returning extent totals of NHD and RAD events within an specified geometry. |
|
|
|
|
|
Name Service Advanced query function for locating NHD features using the USGS GNIS database. |
|
|
|
|
|
Upstream/Downstream Service Service providing standard stream network traversal and discovery functions. |
|
|
|
|
|
Navigation Service Service providing standard stream network traversal. |
|
|
|
|
|
Navigation Delineation Service Service providing basin or other feature type delineation based upon navigation results. |
|
|
|
|
|
RAD Event
Info Service Service provided detailed information on RAD events |
|
|
|
|
|
Lookup Services Query services returning small nonspatial result sets of WATERS data. |
|
|
|
Mapping Services
WATERS mapping services provide access to feature layers via ESRI and
Open Geospatial Consortium
service formats. Users can consume WATERS datasets using client applications such as ArcGIS Desktop, Bing Maps, Google Maps, OpenLayers, Google Earth and/or ArcGIS Explorer.
Developers can utilize these services to incorporate WATERS feature layers into their own mapping applications.
Specific information about the mapping services are documented on the
WATERS Mapping Services
web page.
Additionally, the WATERS mapping services are listed on the
One-Stop Geospatial Gateway
.
Other Services
| Service | Description |
|---|---|
| RAD Download Application | The RAD Download Service provides users a subset of the RAD and program event system(s) in shapefile format for a specific geographic area. |
Mailing List
WATERS provides an opt in/out mailing list which allows partners to stay informed about announcements related to WATERS. Announcements include but are not limited to new service offerings, changes to existing services, etc. If you would like to join the mailing list, please send an e-mail to waters_support@epa.gov or use the Contact Us web page.
![[logo] US EPA](http://www.epa.gov/epafiles/images/logo_epaseal.gif)