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.
Field | Value | Description |
---|---|---|
inputs | Type: collection | The input parameters received in the request. |
errors | Type: array of strings | Any error messages resulting from the request. |
warnings | Type: array of strings | Any warning messages resulting from the request. This includes messages regarding data not being found for one or more datasets. |
version | Type: string | The current version of the web service. |
metadata | Type: collection | Any metadata associated with the request (sources, etc) |
outputs | Type: collection | Information 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) |
id | Type: string | An identifier for that climate data within the dataset. |
lat | Type: decimal | The latitude of the station. |
lon | Type: decimal | The longitude of the station. |
city | Type: string | The city where the station is located. |
state | Type: string | The state where the station is located. |
timezone | Type: integer | The timezone of the station, relative to GMT. |
elevation | Type: integer | The elevation of the station in meters. |
distance | Type: integer | The distance in meters from the input location to the station. |
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
lat | number | ||
lon | number | ||
radius | number | ||
all | number |
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"}]}}