Skip to main content

Web Services Documentation

Usage License

Data provided by the web servies below is licensed under the Attribution 4.0 International (CC BY 4.0). Please credit the "Daily Erosion Project" of "Iowa State University".

The daily outputs generated by this project are provided on a per-HUC12 datum.  Presently, the various services only return the HUC12s for which DEP produces model results for.  The resulting coverage of these HUC12s is not necessarily spatially complete within the domain of interest.  For example, HUC12s that have no agriculture (ie urban areas) are not modeled.

The primary web-service endpoints emits GeoJSON and can be found here:

https://mesonet-dep.agron.iastate.edu/geojson/huc12.py

This service supports the following HTTP GET options.

GET Option Description
date=YYYY-mm-dd Specify the calendar date you want data for.  This date is presently valid for the US Central Time Zone.
date2=YYYY-mm-dd Optional. If provided, this is a date inclusive range to provided summarized data for.
domain=XX Optional. Provide the result for the given state only, if a HUC12 covers multiple states, they are included as well.
callback=myfunc Optional. If provided, wraps the result in a JSON-P style response.

Here are some examples for the service above:

The GeoJSON response provides the following attributes

Attribute Description
avg_loss Average sheet and rill soil detachment.  This is not necessarily soil delivered to the bottom of the modeled hillslope. [tons per acre]
avg_delivery Average sheet and rill soil delivery to the bottom of the hillslope. [tons per acre]
qc_precip HUC12 averaged precipitation for the CST/CDT local day. [inches]
avg_runoff HUC12 averaged runoff.  The depth of water delivered to the bottom of the modeled hillslope. [inches]
tillcode This is a 0-6 value used within DEP to assign an increasing number of tillage operations to a given management.  The dominant tillage code for the HUC12 is provided.
avg_slp1 This is the un-weighted average of bulk slope for all the DEP modeled flowpaths within a given HUC12.  The units are [1], so the ratio of change in elevation to flowpath length.