Skip To Content
ArcGIS Developer

Hydrology analysis service

The hydrology analysis service performs hydrological analysis based on authoritative elevation and hydrologic data. The service is available at different geographic areas and spatial resolutions. See the Hydrology analysis data coverage section for more information.

Key features

  • Use Trace downstream to determine the downstream flow path from a given location.
  • Delineate the catchment area of a particular location using Watershed.

Access the service

To access the hydrology analysis service you need the following:


To learn more about API keys and OAuth 2.0, go to Security and authentication in the Mapping APIs and location services guide.


This example shows you how to delineate the watershed of a point located at southern Colorado, USA using the Watershed request.

1. Send a job request to delineate the watershed. Note that the InputPoints parameter contains the spatial information of the point of interest:

content-type: application/x-www-form-urlencoded


2. Check the job status using the provided jobID until the job has succeeded or failed. Learn more about submitting GP Jobs.

POST<unique job identifier> HTTP/1.1
content-type: application/x-www-form-urlencoded


3. Once the job has succeeded, get the results for watershed polygons from parameter WatershedArea.

POST https://<jobID>/results/WatershedArea HTTP/1.1
content-type: application/x-www-form-urlencoded