Alaska + Arctic Geospatial Data API

Degree Days Min, Mean, and Max Point Query

The endpoints here provide access to the total annual cumulative degree days for several different degree day thresholds.

Endpoints

Endpoint	Threshold
heating	degree days (below 65°F)
below_zero	degree days below 0°F
thawing_index	degree days above freezing (above 32°F)
freezing_index	degree days below freezing (below 32°F)

Examples

Heating Degree Days

Query for historical heating degree days min, mean, and max:

Example: /mmm/degree_days/heating/historical/65.0628/-146.1627

Query for projected heating degree days min, mean, and max:

Example: /mmm/degree_days/heating/projected/65.0628/-146.1627

Query for both historical and projected heating degree days min, mean, and max:

Example: /mmm/degree_days/heating/hp/65.0628/-146.1627

Below Zero (0°F) Degree Days

Query for historical below zero degree days min, mean, and max:

Example: /mmm/degree_days/below_zero/historical/65.0628/-146.1627

Query for projected below zero degree days min, mean, and max:

Example: /mmm/degree_days/below_zero/projected/65.0628/-146.1627

Query for both historical and projected below zero degree days min, mean, and max:

Example: /mmm/degree_days/below_zero/hp/65.0628/-146.1627

Thawing Index

Query for historical thawing index min, mean, and max:

Example: /mmm/degree_days/thawing_index/historical/65.0628/-146.1627

Query for projected thawing index min, mean, and max:

Example: /mmm/degree_days/thawing_index/projected/65.0628/-146.1627

Query for both historical and projected thawing index min, mean, and max:

Example: /mmm/degree_days/thawing_index/hp/65.0628/-146.1627

Freezing Index

Query for historical freezing index min, mean, and max:

Example: /mmm/degree_days/freezing_index/historical/65.0628/-146.1627

Query for projected freezing index min, mean, and max:

Example: /mmm/degree_days/freezing_index/projected/65.0628/-146.1627

Query for both historical and projected freezing index min, mean, and max:

Example: /mmm/degree_days/freezing_index/hp/65.0628/-146.1627

Results from the queries above will look like this:

{
  "historical": {
    "ddmax": 14972,
    "ddmean": 13696,
    "ddmin": 9357
  },
  ...
}

The above output is structured as such:

  {
    <summary time period type, "historical" or "projected">: {
      "ddmax": <max dd value across all models and years>,
      "ddmean": <mean dd value across all models and years>,
      "ddmin": <min dd value across all models and years>
    }
    ...
  }

Comprehensive queries

The following queries will fetch degree day values across all available years.

Query for all heating degree days for all historical and projected models from 1979-2100:

Example: /mmm/degree_days/heating/all/65.0628/-146.1627

Query for all below zero degree days for all historical and projected models from 1979-2100:

Example: /mmm/degree_days/below_zero/all/65.0628/-146.1627

Query for all thawing index for all historical and projected models from 1979-2100:

Example: /mmm/degree_days/thawing_index/all/65.0628/-146.1627

Query for all freezing index for all historical and projected models from 1979-2100:

Example: /mmm/degree_days/freezing_index/all/65.0628/-146.1627

Results from the query above will look like this:

{
  "ERA-Interim": {
    "1979": {
      "dd:" 4802,
    }
    ...
  }
  ...
}

The above output is structured as such:

{
  <model>: {
    <year>: {
      "dd": <degree days value>,
    }
    ...
  }
  ...
}

Supply summary time period (start / end years)

The start and end year to use for any of the summary options from above (i.e. "historical", "projected", or "hp") may be supplied with the query as well, appended to the end of the URL in the form /<start year>/<end year>

Here is an example to query heating degree days data for historical and projected models from 1990-2020:

Example: /mmm/degree_days/heating/hp/65.0628/-146.1627/1990/2020

Note - this query option will only work for summary options, not the comprehensive options above (e.g. "all")