United States Department of Agriculture
Natural Resources Conservation Service		 National Water and Climate Center Go to Accessibility Information
Skip to Page Content
 National Water and Climate Center

                        

AWDB Web Service

Terms of Use

THIS SOFTWARE IS PROVIDED BY THE HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Announcements

  • Effective September 1, 2013 the following legacy methods associated with Data and 30-Year Normals will no longer be available to users:

o    getInstantaneousData

o    getAveragesData

o    getAveragesPeak

o    getForecastPeriodAverages

If users have programs which call these methods, the programs will no longer function.

  • Effective March 7, 2013:
     

    • There is a new Web Service Test Tool built into the application.  This tool can be accessed at http://www.wcc.nrcs.usda.gov/awdbWebService.  The tool lets users run any of the methods of the web service, set the SOAP request, SOAP response, and the actual data that is returned.  This is a powerful tool that lets users look at data or test the web service to make sure it returns what is wanted before implementing the calls in code.
       

    • The getStationMetadata call has been modified so that the “huc” attribute now returns the 12-digit HUC (hydrologic unit code) of the station.  There is a new attribute that is now returned called “hud” which is the 8-digit HUC (based on the Hydrologic Unit Dataset).
       

    • The getStations call has been modified so that the “hucs” parameter has an implied wildcard at the end.  So, for example, if a user searches for stations with the huc “17010101”, it will find any stations whose HUC begins with “17010101”.

  For more information, refer to the AWDB Web Service Reference.

 

More Information

    AWDB Web Service Tutorial

    AWDB Web Service Reference

    AWDB Web Service WSDL File

 

Frequently Asked Questions

Q How do I determine the current version number of the AWDB Web Service?
A

To determine the currently-deployed version number and build date of the AWDB Web Service, go to http://www.wcc.nrcs.usda.gov/awdbWebService/version.html. The url will return a path containing the version number and the build date.
   

 

Release Notes

Date

Version

Description
Apr. 5, 2013 2.9.1 Bug fix on getHourlyData method which was producing return of erroneous results. 
Mar. 7, 2013 2.8.0 Modified the getStations call so that the “hucs” parameter has an implied wildcard at the end. 
Feb. 11, 2013 2.7.0 Bug fix on the status page which was causing the status page to fail in production.
Jan. 14, 2013 2.6.0 The data retrieval code was modified so that if a SWE value is between 0 and -1, it will be returned as 0. Deployed Web Service Test Tool to http://www.wcc.nrcs.usda.gov/awdbWebService.
Dec. 17, 2013 2.5.0 Modified the getStationMetadata call so that the “huc” attribute now returns the 12-digit HUC of the station.  There is a new attribute that is now returned also called “hud” which is the 8-digit HUC (that is based on the Hydrologic Unit Dataset).
Nov. 26, 2013 2.4.1 Modified the code so that derived PRCP normals are rounded to the precision of the sensor before subtraction
Oct. 15, 2013 2.4.0 Fixed a bug in getCentralTendencyData where it was not setting the centralTendencyType correctly in the return object

Oct. 1, 2012

2.3.0

Added the following 30-Year Central Tendency methods:

  • getCentralTendencyData

  • getCentralTendencyPeakData

  • getForecastPeriodCentralTendency