Temperature at Surface Min, Mean, and Max Point Query
This endpoint allows access to various summaries of point extractions from gridded near-surface air temperature data. Note, the quantity being modeled and supplied here is also referred to throughout by its standard abbreviated modeling name, "tas".
Summary queries for January or July
The following queries will fetch temperature values summarized across all models and scenarios for specified time eras.
Query for historical temperature min, mean, and max for January or July:
Example: /mmm/temperature/jan/historical/65.0628/-146.1627
Example: /mmm/temperature/july/historical/65.0628/-146.1627
Query for projected temperature min, mean, and max for January or July:
Example: /mmm/temperature/jan/projected/65.0628/-146.1627
Example: /mmm/temperature/july/projected/65.0628/-146.1627
Query for both historical and projected temperature min, mean, and max for January or July:
Example: /mmm/temperature/jan/hp/65.0628/-146.1627
Example: /mmm/temperature/july/hp/65.0628/-146.1627
Results from the queries above will look like this:
{
"historical": {
"tasmax": 21.7,
"tasmean": 13.5,
"tasmin": 6.2
}
...
}
The above output is structured as such:
{
<summary time period type, "historical" or "projected">: {
"tasmax": <max tas value across all models, scenarios, and years>,
"tasmean": <mean tas value across all models, scenarios, and years>,
"tasmin": <min tas value across all models, scenarios, and years>
}
...
}
Comprehensive queries for January or July
The following queries will fetch yearly temperature values across all available years for January or July.
Query for all Januray or July min, mean, and max temperature data for all historical and projected models from 1901-2099:
Example: /mmm/temperature/jan/all/65.0628/-146.1627
Example: /mmm/temperature/july/all/65.0628/-146.1627
Results from the query above will look like this:
{
"CRU-TS": {
"historical": {
"1901": {
"tasmax": 19.7,
"tasmean": 13.4,
"tasmin": 7.1
}
...
}
}
...
}
The above output is structured as such:
{
<model>: {
<scenario>:{
<year>: {
"tasmax": <annual max tas value>,
"tasmean": <annual mean tas value>,
"tasmin": <annual min tas value>
}
}
...
}
...
}
...
}
Summary queries for annual mean temperature
The following queries will fetch mean annual temperature values summarized across all models and scenarios for specified time eras.
Query for historical min, mean, and max annual mean temperature:
Example: /mmm/temperature/historical/65.0628/-146.1627
Query for projected min, mean, and max annual mean temperature:
Example: /mmm/temperature/projected/65.0628/-146.1627
Query for both historical and projected min, mean, and max annual mean temperature:
Example: /mmm/temperature/hp/65.0628/-146.1627
Results from the queries above will look like this:
{
"historical": {
"tasmax": -1.8,
"tasmean": -4.4,
"tasmin": -7.2
}
...
}
The above output is structured as such:
{
<summary time period type, "historical" or "projected">: {
"tasmax": <max tas value across all models, scenarios, and years>,
"tasmean": <mean tas value across all models, scenarios, and years>,
"tasmin": <min tas value across all models, scenarios, and years>
}
...
}
Comprehensive queries for annual mean temperature
The following query will fetch annual mean temperature values across all available years.
Query for all mean annual temperature data for all historical and projected models from 1901-2099:
Example: /mmm/temperature/all/65.0628/-146.1627
Results from the query above will look like this:
{
"CRU-TS": {
"historical": {
"1901": {
"tas": -5,
}
...
}
}
...
}
The above output is structured as such:
{
<model>: {
<scenario>:{
<year>: {
"tas": <annual mean tas 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 mean annual temperature data for historical and projected models from 1950-2020:
Example: /mmm/temperature/hp/65.0628/-146.1627/1950/2020
Note - this query option will only work for summary options, not the comprehensive options above (e.g. "all")
CSV Export
To export the point data in a CSV file, append ?format=csv. Currently only available for the "all" option for the time era variable
Example: /mmm/temperature/jan/all/65.0628/-146.1627?format=csv
Example: /mmm/temperature/july/all/65.0628/-146.1627?format=csv