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.

  • Provides parameters by year; the annual and each month's average, maximum, and/or minimum values.
  • All parameters are available in their original sources 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 to 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

Limits

Parameters

  • A maximum of 20 parameters can currently be requested in one submission.
  • This limits does not apply if more parameters are needed by the application to construct any on the fly parameters.

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 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 a 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
```