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 Announcements/Release Notes

Announcements

  • January 15, 2014 - Implementation of new Air-Water Database (AWDB) network codes is scheduled for Tuesday, January 21, 2014. NRCS stations will be assigned to a network based on sensor criteria and data collection objectives. These changes apply only to NRCS-managed stations. Most stations will remain assigned to network=SNTL (SNOTEL).

    AWDB Web Service users who currently retrieve data for the affected stations using network=SNTL will no longer receive data following implementation of the network reassignments on January 21, 2014.  New network codes will need to be included in data calls to return data for these stations. In addition, Report Generator users who currently retrieve data for reassigned stations using network=SNTL will no longer receive data following implementation of the network code changes. Therefore, some bookmarked reports may not return all the expected data. Reports created in Report Generator must use new network codes to return data for these stations.

    To summarize the scope of the reassignment:

    • ~210 stations (207 active) will be reassigned from network=SNTL to network=SCAN.

    • ~30 (all active) stations will be reassigned from network=SNTL to network=SNTLT.

    • ~10 stations will be reassigned from network=SNTL to network=OTHER.

    Complete list of reassignments

    For more information or questions, please contact Gus Goodbody.
     

  • February 1, 2013 - There is now a 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.
     

  • October 1, 2012 - The following methods associated with Data and 30-Year Normals are no longer supported (deprecated). If you have programs which call these methods, use the alternate methods listed:

    Deprecated Method Alternate Method(s) Notes
    getInstantaneousData getData

    getHourlyData

    Use getData to get DAILY or ANNUAL data.

    Use getHourlyData to get hourly data.

    getAveragesData getCentralTendencyData For the centralTendencyType parameter, use AVERAGE to retrieve averages, MEDIAN for medians, or NORMAL for the default normal type.
    getAveragesPeak getCentralTendencyPeakData For the centralTendencyType parameter, use AVERAGE to retrieve averages, MEDIAN for medians, or NORMAL for the default normal type.
    getForecastPeriodAverages getForecastPeriodCentralTendency For the centralTendencyType parameter, use AVERAGE to retrieve averages, MEDIAN for medians, or NORMAL for the default normal type.

     

Release Notes

Date

Version

Description

Oct. 23, 2013 2.13.0 Fixed a defect in the getStations() method where using wildcards in the stationId parameter was not working correctly.  Also, the getStationMetadata() and getStationMetadataMultiple() methods now return the precise latitude and longitude for all stations.
Aug. 7, 2013 2.12.1 Fixed a defect in the getInstantaneousData method where it was not returning an empty slot when a station did not have data for the requested element.  This was causing data to be misinterpreted by applications when data for multiple stations was being requested.  If someone had requested data for two stations and the first station didn’t have any data for the requested element, nothing was being returned for the first station, so applications would assume that the data returned was for the first station requested and there was no data for the second station.

Fixed a problem in the getHourlyData method where it would always retrieve ordinal 1 data regardless of the ordinal passed in. Also modified getInstantaneousData so that it will work to retrieve ordinal 2 or greater data even if there is only an ordinal 1 station element that exists.
July 24, 2013 2.11.0 Modified the getData and getInstanteousData methods so that network codes are not hard-coded and instead are table-driven.  This will allow changing the network codes of stations (such as splitting SNTL into SNTL and SCAN) in the database.  Also added a timestamp on the status page.
May 9, 2013 2.10.0 The getData method now has an additional parameter called ‘alwaysReturnDailyFeb29’.  If ‘true’ is passed in for this parameter (or null), requests for daily data will always return a slot for February 29 (regardless of whether the year is a leap year or not.  For leap years, the actual February 29 value will be returned; for non-leap years, null will be returned).  If ‘false’ is passed in, requests for daily data will only return a slot for February 29 for leap years.

The methods that return central tendencies (and peak central tendencies) now return values rounded to the precision of the sensor that collected the data.

The value that is returned for snow depth data is no longer affected by the snow water equivalent data co-located at a station (previously if the snow water equivalent value was zero, the snow depth value would be forced to zero).
Apr. 5, 2013 2.9.1 Defect 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. 

Modified the getStationMetadata call 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).
Feb. 11, 2013 2.7.0 Defect 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 defect 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