Heating Degree Days

Overview

Provides heating degrees for locations from 1 year ago to the previous day.

By Location

Provides the accumulated heating degree days at a specific location along with daily time series data for a user-defined base temperature and date range. The location is represented by a latitude/longitude pair.

GET /heating-degree-days/{latitude}/{longitude}

Query String Parameters (Optional)

The default response contains results for up to the next 1 day, on a Celsius temperature scale, for a base temperature of 16 degrees with a daily time series. However, the forecast data is deprecated and will be discontinued at some point in the future.

We would encourage using start and end paramaters with an end date no later than yesterday.

Name Type Description Accepted Values / Range Example
base number base temperature any number 16.0
unit string temperature unit celsius, fahrenheit celsius
start string start date 1 year ago to previous day 2017-06-01
end string end date (inclusive) 1 year ago to previous day 2017-06-03

Request Example

See CORS for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/heating-degree-days/35.482/-97.535" \
  -d start="2017-06-01" \
  -d end="2017-06-03" \
  --user <username>:<password>

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "latitude": 35.482,
  "longitude": -97.535,
  "startDate": "2017-06-01",
  "endDate": "2017-06-03",
  "baseTemperature": 16.0,
  "unit": {
    "description": "degrees celsius",
    "label": "°C"
  },
  "degreeDays": 15.6,
  "series": [
    {
      "validDate": "2017-06-01",
      "value": 5.2,
      "products": [
        "skywise-conus-24hr-high-temperature-analysis",
        "skywise-conus-24hr-low-temperature-analysis"
      ]
    },
    {
      "validDate": "2017-06-02",
      "value": 7.3,
      "products": [
        "skywise-conus-24hr-high-temperature-analysis",
        "skywise-conus-24hr-low-temperature-analysis"
      ]
    },
    {
      "validDate": "2017-06-03",
      "value": 3.1,
      "products": [
        "skywise-conus-24hr-high-temperature-analysis",
        "skywise-conus-24hr-low-temperature-analysis"
      ]
    }
  ]
}