Climatology API
The Climatology microservice API returns time series analysis-ready data responses for solar and meteorological data to be used directly by applications.
- Provides parameters as climatologies for a pre-defined period with monthly average, maximum, and/or minimum values available.
- All parameters are available in their original source spatial resolution.
- Solar parameters are derived from NASA's GEWEX SRB R4-IP archive (Jan. 1, 1984 – Dec. 31, 2000), CERES SYN1deg archive (Jan. 1, 2001 – to within a few months of real time), and NASA’s CERES FLASHFlux project (End of CERES – to within about 7-days of real time).
- Meteorological parameters are derived from the NASA's GMAO MERRA-2 assimilation model (Jan. 1, 1981 - Dec. 31, 2013).
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.
- This limit does not apply if more parameters are needed by the application to construct any on the fly parameters or if a combination of parameters are selected that return multiple parameters with one name.
Wind Elevation and Custom Surface
- This parameter is only available with Point spatial option.
- Wind Elevation values in Meters are required to be between 10m and 300m.
- If you provide a correct wind surface alias please include a surface elevation with the request.
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.
- This parameter is only available with the Point spatial option.
- Site Elevation
site-elevation
values in Meters.
Request Structure
- The request arguments can be in any order after the question mark.
- A single parameter can be requested 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 a start
and end
URI components like start=2016&end=2017
.
Point
Regional
Below are examples to return a climatology for a region on a 0.5 x 0.5 degree grid.
| /api/temporal/climatology/regional?latitude-min=50&latitude-max=55&longitude-min=50&longitude-max=55¶meters=T2M&community=SB&format=CSV
|