Skip to content

Climatology API

The Climatology microservice API returns time series analysis-ready data responses for solar and meteorological data to be used directly by applications.

Formats

Formats Available Notes
NetCDF Yes
ASCII Yes
ICASA No
JSON Yes
CSV Yes

Limits

Parameters

  • A maximum of 20 parameters can currently be requested in one submission for a single point. Regional requests are limited to one parameter.
  • These limits do not apply if more parameters are needed by the application to construct on the fly parameters or if a combination of parameters are selected that return multiple parameters with the same name.

Wind Elevation and Custom Surface

  1. This parameter is only available under the "Point" spatial option.
  2. Wind Elevation values in Meters are required to be between 10m and 300m.
  3. If you provide a correct wind surface alias, please include a surface elevation with the request.

For a list of wind surface aliases. please use this System API Request. For more information please reference the Manager Documentation.

Site Elevation

If you wish to pass your own site elevation (in meters), you will receive a corrected atmospheric pressure value upon adjustment to the elevation you provided.

  1. This parameter is only available under the "Point" spatial option.
  2. Site Elevation site-elevation values are in Meters.

Request Structure

  • The request arguments can be in any order after the question mark.
  • A single parameter or a list of parameters can be selected with one of the following list separators: ',' or '%2C'.

Examples

To help construct and test your API requests, please use the API Pages for the POWER Climatology API and POWER Manager API.

Custom Climatology

To request a custom climatology, just include start and end URI components like start=2016&end=2017.

1
/api/temporal/monthly/climatology/point?parameters=T2M,T2M_MAX&community=SB&longitude=0&latitude=0&format=JSON&start=2016&end=2017

1
/api/temporal/monthly/climatology/point?parameters=T2M,T2M_MAX&community=SB&longitude=0&latitude=0&format=ASCII&start=2016&end=2017

1
/api/temporal/monthly/climatology/point?parameters=T2M,T2M_MAX&community=SB&longitude=0&latitude=0&format=CSV&start=2016&end=2017

Point

1
/api/temporal/climatology/point?parameters=T2M&community=SB&longitude=0&latitude=0&format=JSON

1
/api/temporal/climatology/point?parameters=T2M,PS,WS10M&community=AG&longitude=0&latitude=0&format=CSV

1
/api/temporal/climatology/point?parameters=T2M&community=SB&longitude=0&latitude=0&format=JSON&site-elevation=50

1
/api/temporal/climatology/point?parameters=T2M&community=AG&longitude=0&latitude=0&format=ASCII&wind-elevation=50

1
/api/temporal/climatology/point?parameters=T2M&community=AG&longitude=0&latitude=0&format=ASCII&wind-surface=SeaIce&wind-elevation=50

1
/api/temporal/climatology/point?parameters=SI_EF_TILTED_SURFACE&community=AG&longitude=0&latitude=0&format=ASCII

1
/api/temporal/climatology/point?parameters=T2M,PS,WS10M,SI_EF_TILTED_SURFACE&community=AG&longitude=0&latitude=0&format=ASCII&wind-surface=SeaIce&wind-elevation=50&site-elevation=50

Regional

Below are examples for returning a climatology for a region on a 0.5 x 0.5 degree grid.

1
2
3
```bash
/api/temporal/climatology/regional?latitude-min=50&latitude-max=55&longitude-min=50&longitude-max=55&parameters=T2M&community=SB&format=CSV
```