Heating Degree Days

Overview

Provides heating degrees for locations up to 10 days in the future.

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.

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 10 days in the future 2017-06-01
end string end date (inclusive) 1 year ago to 10 days in the future 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"
      ]
    }
  ]
}