Skip to content

Monthly and Annual API

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

Additional Data Specifications: - Provides parameters by year and month with the ability to pull average, maximum, and/or minimum values. - All parameters are available in their original source's 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 – within a few months of real time), and NASA’s CERES FLASHFlux project (End of CERES – within about 7-days of real time). - Meteorological parameters are derived from NASA's GMAO MERRA-2 assimilation model (Jan. 1, 1981 - as of the previous year).

Formats

Formats Available Notes
NetCDF Yes
ASCII Yes
ICASA No This will be available in a future release.
JSON Yes
CSV Yes

Limitations

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.

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 Monthly API and POWER Manager API.

Point

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

Regional

Below are examples to return monthly data for a region on a 0.5 x 0.5 degree grid.

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