Solar - National Solar Radiation Database Data Query
GET {{nrel_developer_url}}/solar/nsrdb_data_query.json?wkt=POINT(14.61 -24.26)&address&lat&lon&type&show_empty
NSRDB Data Query (/api/solar/nsrdb_data_query
)
Returns information on the closest NSRDB datasets for a location including a set of links that can be used to download the data. For information about the NSRDB and the datasets represented by this service please visit https://nsrdb.nrel.gov.
Response Fields The response is composed of service-related informational fields and the results of the data query.
Field | Value | Description |
---|---|---|
errors | Type: string array | A list of error messages |
warnings | Type: string array | A list of warning messages |
inputs | Type: Object hash | Key: Value pairs representing all input parameters |
outputs | Type: Object array | An array of objects describing the datasets returned by the query. Dataset objects will include descriptive details, links to dataset information, links to documentation for more dataset-specific API endpoints, and where appropriate a list of direct download links for easily accessing the data for any year at any resolution available. Please note that the returned links will require the addition of a valid api_key and email parameter. |
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
wkt | string | Type: well-known text string | |
Default: None | |||
A well-known text (WKT) representation of the geometry for which to extract data. May be a point, multipoint, or polygon geometry. When a point is passed the site nearest to that point is used. When a multipoint is passed the site nearest each point is used. This can be useful for downloading multiple sites in a single request when those sites are geographically distant from each other. When a polygon is passed all sites that intersect with the given polygon are used. | |||
address | null | Type: string | |
Default: None | |||
The address to use. Required if neither wkt nor lat/lon are specified. | |||
lat | null | Type: decimal | |
Default: None | |||
Min: -90 | |||
Max: 90 | |||
The latitude for the location to use. Required if neither address nor wkt are specified. | |||
lon | null | Type: decimal | |
Default: None | |||
Min: -180 | |||
Max: 180 | |||
The longitude for the location to use. Required if neither address nor wkt are specified. | |||
type | null | Type: string | |
Default: None | |||
Options: satellite, station | |||
The type of datasets to include in the response. | |||
show_empty | null | Type: boolean | |
Default: false | |||
If true, returns metadata for all datasets including those with no data at the given location. |
RESPONSES
status: OK
{"inputs":{"wkt":"POINT(14.61 -24.26)"},"metadata":{"version":"2.0.0","resultset":{"count":1}},"status":200,"outputs":[{"apiDocs":"https://developer.nrel.gov/docs/solar/nsrdb/msg-iodc/","availableIntervals":[15,30,60],"enabled":true,"displayName":"MSG IODC: PSM v3","metadataLink":"https://nsrdb.nrel.gov/current-version","name":"msg-iodc","ranking":20,"availableYears":[2017,2018,2019],"apiUrl":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download","links":[{"year":2017,"interval":15,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=15\u0026api_key=yourapikey\u0026email=youremail"},{"year":2018,"interval":15,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=15\u0026api_key=yourapikey\u0026email=youremail"},{"year":2019,"interval":15,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=15\u0026api_key=yourapikey\u0026email=youremail"},{"year":2017,"interval":30,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=30\u0026api_key=yourapikey\u0026email=youremail"},{"year":2018,"interval":30,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=30\u0026api_key=yourapikey\u0026email=youremail"},{"year":2019,"interval":30,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=30\u0026api_key=yourapikey\u0026email=youremail"},{"year":2017,"interval":60,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=60\u0026api_key=yourapikey\u0026email=youremail"},{"year":2018,"interval":60,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=60\u0026api_key=yourapikey\u0026email=youremail"},{"year":2019,"interval":60,"link":"https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019\u0026wkt=POINT%2814.61+-24.26%29\u0026interval=60\u0026api_key=yourapikey\u0026email=youremail"}]}],"errors":[]}