Introduction | Make your apps POWERful.

The POWER Technical Documentation provides users with information on available web services, examples on using the services in sample programming languages and provides a user interface to test out a constructed HTTPS URL. Any questions or comments can be directed to the POWER team.

POWER Acknowledgements


Data Access Service | version 1.1.0

NOTES

1. All requested data files will be unavailable after a 48 hour period. You will need to make a new request if you need the data file after that period.

2. Please consider joining our mailing list. Since POWER is an active site, we perform regular updates and revisions. By joining the mailing list, we will inform you of changes to the website, API and/or data that might impact the use of the data. The mailing list sign up is found at this web site: https://eosweb.larc.nasa.gov/news-lists-registration. (Hint: Under projects select "SSE".)

Make HTTPS GET calls to the POWER data archives directly. Integrate the service into your own applications.

Depracated Base URL: https://asdc-arcgis.larc.nasa.gov/cgi-bin/power/v1beta/DataAccess.py?
(The POWER team will no longer be improving the performance and enhancements of data for this API url. Please see the new base URL below for the latest parameters and improvements.)

NEW Base URL: https://power.larc.nasa.gov/cgi-bin/v1/DataAccess.py?
(See below for description of input parameters to the GET calls)

Sample SinglePoint URL: https://power.larc.nasa.gov/cgi-bin/v1/DataAccess.py?request=execute&identifier=SinglePoint&parameters=T2M,PS,ALLSKY_SFC_SW_DWN&startDate=20160301&endDate=20160331&userCommunity=SSE&tempAverage=DAILY&outputList=JSON,ASCII&lat=36&lon=45&user=anonymous

Sample Regional URL: https://power.larc.nasa.gov/cgi-bin/v1/DataAccess.py?request=execute&identifier=Regional&parameters=T2M,ALLSKY_SFC_SW_DWN&startDate=19830701&endDate=19830705&userCommunity=SSE&tempAverage=DAILY&outputList=ASCII&bbox=-40,-70,-38,-66&user=anonymous

Sample Global URL: https://power.larc.nasa.gov/cgi-bin/v1/DataAccess.py?request=execute&identifier=Global&parameters=T2M,ALLSKY_SFC_SW_DWN,PS&userCommunity=SSE&tempAverage=CLIMATOLOGY&outputList=NETCDF&user=anonymous


https://...?request=execute

Requests

Parameter Value Data Type Parameter Type Description
request execute String Query Single select option

Available Requests

Value Description
execute This request executes the user request and provides a JSON response.

https://...?identifier=SinglePoint

Identifiers

Parameter Value Data Type Parameter Type Description
identifier SinglePoint String Query Single select option
identifier Regional String Query Regional Bounding Box select option
identifier Global String Query Global select option

Available Identifiers

Value Description
SinglePoint The Single Point endpoint returns a time series based on a single latitude and longitude coordinate across the time span provided. The response is JSON by default and the data values are provided by default within the response. Additional outputs are available if requested.
Regional The Regional endpoint returns a time series based on a bounding box of lower left (lat,lon) and upper right (lat,lon) coordinates across the time span provided. The response is JSON by default but does not provide the data values in the default JSON response. However, if JSON data values are required the user must specify JSON in the output parameter and select the downloadble JSON file. Additional outputs are available if requested.
Global The Global endpoint returns long term climatological averages for the entire globe. The response is JSON by default but does not provide the data values in the default JSON response. However, if JSON data values are required the user must specify JSON in the output parameter and select the downloadble JSON file. Additional outputs are available if requested.

https://...?parameters=T2M,PS

Note

If "ICASA" output is requested, all parameters required for ICASA output will automatically be appended to your parameters query.

Data Parameters

Parameter Value Data Type Parameter Type Identifier Description
parameters Only a max of 20 parameters per submission permitted. String Query SinglePoint Multiple select list seperated by comma.
parameters Only a max of 20 parameters per submission permitted. String Query Regional Multiple select list seperated by comma
parameters Only a max of 3 parameters per submission permitted. String Query Global Multiple select list seperated by comma.

Available Values

*Units based on user community value selected.
Value Name SSE Units* SB Units* AG Units* Daily Interannual Climatology SinglePoint Regional Global

https://...?startDate=YYYYMMDD&endDate=YYYYMMDD

Start & End Dates

Parameter Value/Format Data Type Parameter Type Name Required For Identifier Description
startDate YYYYMMDD String Query Start Date DAILY SinglePoint, Regional Start date of time series.
endDate YYYYMMDD String Query End Date DAILY SinglePoint, Regional End date of time series.
startDate YYYY String Query Start Year INTERANNUAL SinglePoint, Regional Start Year of interannual time series.
endDate YYYY String Query End Year INTERANNUAL SinglePoint, Regional End year of interannual time series.
startDate Not Required String Query Start Year CLIMATOLOGY SinglePoint, Regional, Global Not Required
endDate Not Required String Query End Year CLIMATOLOGY SinglePoint, Regional, Global Not Required

https://...?lat=34.21&lon=56.78

Latitude and Longitude Coordinates

Parameter Value/Format Data Type Parameter Type Name Identifier Description
lat decimal degrees String Query Latitude SinglePoint Latitudinal coordinate in decimal degrees
lon decimal degrees String Query Longitude SinglePoint Longitudinal coordinate in decimal degrees
bbox lower-left latitude,lower-left longitude,upper-right latitude,upper-right longitude (decimal degrees and no spaces between commas) String Query Bounding Box Regional Bounding box of coordinates. Max bounding box is 10 x 10 degrees of 1/2 x 1/2 degree data. (e.g. 100 Points Max Total)

https://...?userCommunity=SSE

Selecting a user community will affect the units of the parameter and the temporal display of time series data (e.g. Agroclimatology will use Julian Day of Year)

User Community Parameter

Parameter Value Data Type Parameter Type Identifier Description
userCommunity SSE, SB, AG String Query SinglePoint, Regional, Global User community of interest.

Available Values

Value Name Description
SSE Surface meteorology and Solar Energy The Renewable Energy Archive is designed to provide access to parameters specifically tailored to assist in the design of solar and wind powered renewable energy systems.
SB Sustainable Buildings The Sustainable Buildings Archive is designed to provide industry-friendly parameters for the buildings community, to include parameters in multi-year monthly averages.
AG Agroclimatology The Agroclimatology Archive is designed to provide web-based access to industry-friendly parameters formatted for input to crop models contained within agricultural DSS.

https://...?tempAverage=DAILY

Temporal Averages

Parameter Value Data Type Parameter Type Identifier Description
tempAverage DAILY, INTERANNUAL, CLIMATOLOGY String Query SinglePoint Only one value permitted.
tempAverage DAILY, INTERANNUAL, CLIMATOLOGY String Query Regional Only one value permitted.
tempAverage CLIMATOLOGY String Query Global Only one value permitted.

Available Values

Value Description
DAILY Daily average by year.
INTERANNUAL Monthly and annual average By year.
CLIMATOLOGY Long term monthly averages.

https://...?outputList=JSON,ASCII

Output Parameter

Note: JSON is the default response for all data requests. Please see the "outputs" section at the bottom of the JSON response for a link to the requested file.
Parameter Value Data Type Parameter Type Identifier Description
outputList JSON, ASCII, CSV, ICASA, NETCDF String Query SinglePoint Multiple select list seperated by comma
outputList JSON, ASCII, CSV, ICASA, NETCDF String Query Regional If data values are required in JSON format, please choose JSON as output type as the data values are not provided in the default JSON response. ICASA is not available for Interannual or Climatology regional selection.
outputList JSON, ASCII, CSV, NETCDF, GEOTIFF String Query Global If data values are required in JSON format, please choose JSON as output type as the data values are not provided in the default JSON response. ICASA is not available for Global selection.

Available Values

Value Version Description
JSON 1.0 Default response. Structured using GeoJSON Feature Collection Standards
ASCII n/a Text based output with header and column information.
CSV n/a Text based comma seperated values format.
ICASA 4.6 Internet based formatted output for input to crop models contained within the agricultural Decision Support System for Agrotechnology Transfer (DSSAT) software.
NETCDF 4 Climate Forecast version 1.6 compliant.
GEOTIFF n/a Geospatially referenced Tiff format.

https://...?user=anonymous

User Parameter

Parameter Value Data Type Parameter Type Identifier Description
user USER String Query SinglePoint, Regional, Global If you wish to place a user (e.g. organizationname) with no spaces it will help tailor our data and capabilities to better meet the requirements for our misson partners.

https://...?siteElev=10.34

User Provided Site Elevation

Parameter Value Data Type Parameter Type Identifier Temporal Description
siteElev number String Query SinglePoint DAILY If you wish pass your own site elevation (in meters) you will receive a corrected atmospheric pressure value upon adjusted to the elevation you provided.

Code Examples | JavaScript

JavaScript - SinglePoint data request

$(document).ready( function () {

//create POWER url
url = singlepoint URL

//request data
$.getJSON( url, function( data ) {

      }).done( function ( data ) {

            //access the data values within the json data response
            features = data["features"];
            properties = features[0].properties;
            parameter = properties.parameter;

            for ( var p in parameter ) {
                  var values = features[0].properties.parameter[p];
                  for ( var v in values ){
                        var powervalue = values[v];
                  }
});
});



Solar Data

REST Endpoint: https://asdc-arcgis.larc.nasa.gov/server/rest/services/power/power_601_22years_lst/ImageServer

Spatial Resolution: 1 x 1 degree
Solar parameters for ArcGIS Image Services are provided in 1x1 degree spatial resolution. This data is available in ½ by ½ degree resolution via the custom POWER API Data Access Service (see above). Updates to the solar ArcGIS Image Services will be coming shortly.

Insolation on Horizontal Surface
Minimum Insolation on Horizontal Surface
Maximum Insolation on Horizontal Surface
Clear Sky Insolation
Direct Normal Radiation
Minimum Direct Normal Radiation
Maximum Direct Normal Radiation
Clear Sky Days
Latitude Tilt Radiation
Minimum Latitude Tilt Radiation
Maximum Latitude Tilt Radiation
Maximum NO-SUN or BLACK Days
Surface Albedo
Top of Atmosphere Insolation

Meteorological Data

REST Endpoint: https://asdc-arcgis.larc.nasa.gov/server/rest/services/power_climatology/power_801_climatology_1984_2013_lst/ImageServer

Spatial Resolution: 0.5 x 0.5 degree

Temperature at 2 Meters
Minimum Temperature at 2 Meters
Maximum Temperature at 2 Meters
Daily Temperature Range at 2 Meters
Dew/Frost Point at 2 Meters
Wet Bulb Temperature at 2 Meters
Earth Skin Temperature
Surface Pressure
Wind Speed at 2 Meters
Wind Speed at 10 Meters
Wind Speed at 50 Meters
Precipitation
Cooling Degree Days Above 0 C
Cooling Degree Days Above 10 C
Cooling Degree Days Above 18.3 C
Relative Humidity at 2 Meters
Heating Degree Days Below 0 C
Heating Degree Days Below 10 C
Heating Degree Days Below 18.3 C
Specific Humidity at 2 Meters

Desktop Access

Access POWER Image Services in various desktop applications for further analysis, visualization, and geoprocessing (ArcGIS Desktop, ArcGIS Earth, ArcGlobe)

1. In ArcMap, double click "Add ArcGIS Server"
2. Check "Use GIS Services" and click Next
3. Enter the REST Endpoint URL, and click Finish

Web Access

Access POWER Image Services and data in web and mobile applications using open source Web APIs and SDKs (JavaScript, Python, RStudio).
Identify task - The identify operation is performed on a map service resource. The result of this operation is an identify results resource. Each identified result includes its name, layer ID, layer name, geometry and geometry type, and other attributes of that result as name-value pairs. You can provide arguments to the identify operation as query parameters.

Export Image task - The export image operation is performed on an image service resource. The result of this operation is an image resource. This resource provides information about the exported image, such as its URL, its width and height, and extent. Apart from the usual response formats of html and json, users can also request a format called image while performing this operation. When users perform an export with the format of image, the server responds by directly streaming the image bytes to the client. With this approach you don't get any information associated with the exported image besides the actual image. Users can provide arguments to the export image operation as query parameters. These parameters include the request extent, size information, interpolation, pixel type, and so on.

Solar Data

Sample Identify Task: https://asdc-arcgis.larc.nasa.gov/server/rest/services/power/power_601_22years_lst/ImageServer/identify?f=json&geometry={"x":-8308523,"y":4036000,"spatialReference":{"wkid":102100}}&returnGeometry=false&returnCatalogItems=true&mosaicRule={"mosaicMethod":"esriMosaicNone","where":"","ascending":true,"mosaicOperation":"MT_FIRST","multidimensionalDefinition":[{"variableName":"allsky_sfc_sw_dwn","dimensionName":"time","values":["1"],"isSlice":true}]}&geometryType=esriGeometryPoint&pixelSize={"x":19567,"y":19567,"spatialReference":{"wkid":102100}}&renderingRules=[{"rasterFunction":"power_600_22years_1983_2005_allsky_sfc_sw_dwn","variableName":"Raster"}]

Sample Export Image Task: https://asdc-arcgis.larc.nasa.gov/server/rest/services/power/power_601_22years_lst/ImageServer/exportImage?f=image&renderingRule={"rasterFunction":"power_600_22years_1983_2005_allsky_sfc_sw_dwn","variableName":"Raster"}&mosaicRule={"mosaicMethod":"esriMosaicNone","where":"","ascending":true,"mosaicOperation":"MT_FIRST","multidimensionalDefinition":[{"variableName":"allsky_sfc_sw_dwn","dimensionName":"time","values":["1"],"isSlice":true}]}&bbox=-17720673,-2910596,12335588,4818715&imageSR=102100&bboxSR=102100&size=1536,395

Meteorological Data

Sample Identify Task: https://asdc-arcgis.larc.nasa.gov/server/rest/services/power_climatology/power_801_climatology_1984_2013_lst/ImageServer/identify?f=json&geometry={"x":-5647292,"y":4290383,"spatialReference":{"wkid":102100}}&returnGeometry=false&returnCatalogItems=true&mosaicRule={"mosaicMethod":"esriMosaicNone","where":"\"slice_alias\" = 'January'","ascending":true,"mosaicOperation":"MT_FIRST","multidimensionalDefinition":[{"variableName":"cdd0","dimensionName":"datatype","values":[0],"isSlice":true}]}&geometryType=esriGeometryPoint&pixelSize={"x":19567,"y":19567,"spatialReference":{"wkid":102100}}&renderingRules=[{"rasterFunction":"Aggregate Cooling Degree Days Symbology","variableName":"Raster"}]

Sample Export Image Task: https://asdc-arcgis.larc.nasa.gov/server/rest/services/power_climatology/power_801_climatology_1984_2013_lst/ImageServer/exportImage?f=image&renderingRule={"rasterFunction":"Aggregate Temperature Symbology","variableName":"Raster"}&mosaicRule={"mosaicMethod":"esriMosaicNone","where":"\"slice_alias\" = 'January'","ascending":true,"mosaicOperation":"MT_FIRST","multidimensionalDefinition":[{"variableName":"t2m","dimensionName":"datatype","values":[0],"isSlice":true}]}&bbox=-17720673,-1012512,12335588,4818715&imageSR=102100&bboxSR=102100&size=1536,298