Skip to content

Hourly API

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

  • Provides parameters by hour with average values.
  • 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 to within a few months of real time) plus GEOS-5.12.4 FP-IT (End of MERRA-2 to within several days of real time).
  • Precipitation values will be shown in mm/hour.

Formats

Formats Available Notes
NetCDF Yes
ASCII Yes
ICASA No
JSON Yes
CSV Yes
EPW Yes EnergyPlus Weather File
EPW (CSV) Yes EnergyPlus Weather File

Time Standards

POWER provides two different time standards:

  • Universal Time Coordinated (UTC): is the standard time measure that used by the world.
  • Local Solar Time (LST): A 15 Degrees swath that represents solar noon at the middle longitude of the swath.
  • Hourly UTC and LST time standards data are available from 2001/01/01 to Near Real Time (NRT)
  • Hourly defaults to providing LST; to change the time standard please include time-standard=UTC or time-standard=LST in the API request URL.
  • The valid time range for the EPW format is only available from 2000/01/01 to near real time if a start time is selected before 2000/01/01 the request will be modified to start at 2000/01/01.

Limits

Parameters

A maximum of 15 parameters can currently be requested in one submission.

Wind Elevation and Custom Surface

  1. This parameter is only available with 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 with Point spatial option.
  2. 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 Hourly API and POWER Manager API.

Point

1
/api/temporal/hourly/point?parameters=T2M&community=SB&longitude=0&latitude=0&start=20170101&end=20170102&format=CSV
1
/api/temporal/hourly/point?parameters=WS10M,WD10M,T2MDEW,T2MWET,T2M,V10M,RH2M,PS,PRECTOT,QV2M,U10M&community=SB&longitude=0&latitude=0&start=20170101&end=20170102&format=CSV
1
/api/temporal/hourly/point?parameters=T2M&community=SB&longitude=0&latitude=0&start=20170101&end=20170102&format=JSON&site-elevation=50
1
/api/temporal/hourly/point?parameters=T2M&community=AG&longitude=0&latitude=0&start=20170101&end=20170102&format=ASCII&wind-elevation=50
1
/api/temporal/hourly/point?parameters=T2M&community=AG&longitude=0&latitude=0&start=20170101&end=20170102&format=ASCII&wind-surface=SeaIce&wind-elevation=50