- Usage Scenarios
- HTTP Service
- Database Service
Drinking Water Designated Use Evaluation
Determine if the waters upstream from a drinking water intake have the proper designated use assigned to them.
List of all waters within 50 miles upstream of all drinking water intakes that have a designated use different from drinking water supply.
Information Returned from Service
Event tables of waters 50 miles upstream of each drinking water intake. NOTE: The results of this service will need to be overlaid with the assessed waters layer and joined to the ATTAINS database to complete the analysis.
|pNavigationType||String||'UM' for upstream mainstem navigation|
'UT' for upstream with tributaries navigation
'DM' for downstream mainstream navigation
'DD' for downstream with divergences navigation
'PP' for point-to-point navigation
|pStartComid||Number||NHD flowline comid to begin navigating from. Must be greater than 0 and less than 999999999.|
|pStartReachcode||String||NHD reach code to begin navigating from. User must provide either a comid or a reach code. If both are provided, then the comid takes precedence.|
|pStartMeasure||Number||Measure on the NHD reach code to begin navigating from. Must be between 0 and 100 inclusive, or NULL. A value of null means that a measure will be calculated to be either the bottom or the top of the NHD flowline. (depending on whether the navigation type is upstream or downstream and whether it is a start or stop measure).|
|pStopComid||Number||NHD flowline comid to stop navigating at. Must be greater than 0 and less than 999999999.|
|pStopReachcode||String||NHD reach code to stop navigating at. User must provide either a comid or a reach code. If both are provided, then the comid parameter takes precedence.|
|pStopMeasure||Number||Measure on the NHD reach code to stop navigating at. Must be between 0 and 100 inclusive, or NULL.|
|pMaxDistance||Number||Distance in KM to navigate. If neither pMaxDistance or pMaxTime are provided, then distance to travel defaults to 50 km.|
|pMaxTime||Number||Time of travel in hours to navigate.|
|pReturnFlowlineAttr||String||TRUE/FALSE - flag to return the geometry of each navigated flowline. Note the collection and clipping of flowline geometries adds a performance penalty to each service call. The default value is FALSE.|
Additional parameters specific to HTTP services are listed in the WATERS HTTP Services documentation.
|return_code||Number||Return Code indicate success or failure of the navigation process. |
0 = Up/Down Service completed as requested
1nn= Interpreter errors
2nn= Resolver errors
|status_message||String||Status message provides text details for return codes 1nn thru 5nn.|
|Object Type: updn_nttypenavresultsstandard|
|comid||Number||NHD flowline comid.|
|reachcode||String||NHD reach code.|
|frommeas||Number||NHD reach code beginning measure.|
|tomeas||Number||NHD reach code ending measure.|
|totaldist||Number||Total distance of the flowline in KM for the traversal.|
|totaltime||Number||Total navigation time of the flowline in hours for the traversal.|
|hydroseq||Number||The hydrologic sequence of the flowline in the total traversal.|
|shape||Geometry||Geometry of the feature.|
The output format for this service is JSON with GEOJSON formatted geometries.
Version: 3.0 - Released: February 03, 2014
- SOAP version of the service decommissioned.
Version: 2.0 - Released: August 31, 2009
- Initial Release of SOAP and HTTP Service for this component