Solar Dataset Query

GET {{nrel_developer_url}}/solar/data_query/v1.json?lat=40&lon=-105&radius=50&all=1

Solar Dataset Query (GET /api/solar/data_query/v1) Returns information on the closest climate data for a location.

Response Fields The response is composed of service-related informational fields and the results of the data query.

FieldValueDescription
inputsType: collectionThe input parameters received in the request.
errorsType: array of stringsAny error messages resulting from the request.
warningsType: array of stringsAny warning messages resulting from the request. This includes messages regarding data not being found for one or more datasets.
versionType: stringThe current version of the web service.
metadataType: collectionAny metadata associated with the request (sources, etc)
outputsType: collectionInformation about the climate data files for each supported dataset. (see output fields for more detail) \n Dataset Description \n nsrdb \n NREL Physical Solar Model (PSM) TMY from the NREL National Solar Radiation Database (NSRDB) (see nsrdb.nrel.gov/about) \n tmy2 TMY2 station data (see Typical Meteorological Year, version 2) \n tmy3 TMY3 station data (see Typical Meteorological Year version 3) \n intl International station data \n IN India 10km gridded solar resource data (see India Solar Resource Maps) \n all_stations Information for all stations within the radius (only if all=1 is specified)
idType: stringAn identifier for that climate data within the dataset.
latType: decimalThe latitude of the station.
lonType: decimalThe longitude of the station.
cityType: stringThe city where the station is located.
stateType: stringThe state where the station is located.
timezoneType: integerThe timezone of the station, relative to GMT.
elevationType: integerThe elevation of the station in meters.
distanceType: integerThe distance in meters from the input location to the station.

Request Params

KeyDatatypeRequiredDescription
latnumber
lonnumber
radiusnumber
allnumber

RESPONSES

status: OK

{"version":"1.3.2","warnings":["No intl data found for lat=40.0 lon=-105.0"],"errors":[],"metadata":{},"inputs":{"lat":"40","lon":"-105","radius":"50","all":"1"},"outputs":{"tmy2":{"id":"0-94018","city":"BOULDER","state":"COLORADO","timezone":-7,"lat":40.13,"lon":-105.24,"elevation":1689,"distance":24977},"tmy3":{"id":"1-724699","city":"BROOMFIELD/JEFFCO [BOULDER - SURFRAD]","state":"COLORADO","timezone":-7,"lat":40.13,"lon":-105.24,"elevation":1689,"distance":24977},"intl":null,"nsrdb":{"id":"3-W105N040-W10502N4001","city":"","state":"Colorado","country":null,"lat":40.01,"lon":-105.02,"distance":2029,"timezone":-7,"elevation":1582,"resolution":4},"all_stations":[{"id":"3-W105N040-W10502N4001","city":"","state":"Colorado","country":null,"lat":40.01,"lon":-105.02,"distance":2029,"timezone":-7,"elevation":1582,"resolution":4,"dataset":"nsrdb"},{"id":"0-94018","city":"BOULDER","state":"COLORADO","timezone":-7,"lat":40.13,"lon":-105.24,"elevation":1689,"distance":24977,"dataset":"tmy2"},{"id":"1-724699","city":"BROOMFIELD/JEFFCO [BOULDER - SURFRAD]","state":"COLORADO","timezone":-7,"lat":40.13,"lon":-105.24,"elevation":1689,"distance":24977,"dataset":"tmy3"},{"id":"1-724666","city":"DENVER/CENTENNIAL [GOLDEN - NREL]","state":"COLORADO","timezone":-7,"lat":39.742,"lon":-105.179,"elevation":1829,"distance":32650,"dataset":"tmy3"},{"id":"1-725650","city":"DENVER INTL AP","state":"COLORADO","timezone":-7,"lat":39.833,"lon":-104.65,"elevation":1650,"distance":35063,"dataset":"tmy3"},{"id":"1-724695","city":"AURORA BUCKLEY FIELD ANGB","state":"COLORADO","timezone":-7,"lat":39.717,"lon":-104.75,"elevation":1726,"distance":38143,"dataset":"tmy3"},{"id":"1-724769","city":"FORT COLLINS (AWOS)","state":"COLORADO","timezone":-7,"lat":40.45,"lon":-105.017,"elevation":1529,"distance":50435,"dataset":"tmy3"},{"id":"1-724768","city":"GREELEY/WELD (AWOS)","state":"COLORADO","timezone":-7,"lat":40.433,"lon":-104.633,"elevation":1420,"distance":57549,"dataset":"tmy3"}]}}