v1

latestSwagger 2.02026-07-132137180.4 KB
Forecast Degree Day API

Returns Energy Forecast API response - Given a single lat/lon.

Retrieve an 8 day forecast relevant to te Energy Sector (degree days, solar radiation, precipitation, wind).

get/forecast/energy

Query parameters

latnumber double required

Latitude component of location.

lonnumber double required

Longitude component of location.

thresholdnumber double

Temperature threshold to use to calculate degree days (default 18 C)

units'S' | 'I' | 'M' string

Convert to units. Default Metric. Options (I = Imperial, M = Metric, S = Scientific)

tp'hourly' | 'daily' string

Time period (default: daily)

keystring string required

Your registered API key.

Response

An Energy Data Object.

city_namestring

Nearest city name

state_codestring

State abbreviation

country_codestring

Country abbreviation

timezonestring

Local IANA time zone

latnumber

Latitude

lonnumber

Longitude

threshold_unitsstring

Degree day threshold units

threshold_valuestring

Degree day threshold

Example response

{
  "city_name": "Raleigh",
  "state_code": "NC",
  "country_code": "US",
  "timezone": "America/New_York",
  "lat": 38,
  "lon": -78.25,
  "threshold_units": "C",
  "threshold_value": "18",
  "data": [
    {
      "date": "2018-06-01",
      "timestamp_local": "2019-03-04T12:00:00",
      "timestamp_utc": "2019-03-04T17:00:00",
      "cdd": 10,
      "hdd": 120,
      "rh": 75,
      "dewpt": 12,
      "max_wind_dir": 150,
      "max_wind_dir_100m": 150,
      "max_wind_spd": 15.2,
      "max_wind_spd_100m": 20.5,
      "wind_dir": 125,
      "wind_dir_100m": 130,
      "wind_spd": 7.1,
      "wind_spd_100m": 7.1,
      "temp": 13.85,
      "temp_wetbulb": 11.3,
      "clouds": 42,
      "t_ghi": 3000,
      "t_dhi": 450,
      "t_dni": 1200,
      "t_solar_rad": 1250,
      "sun_hours": 4.5,
      "precip": 2,
      "snow": 10
    }
  ]
}