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.

FieldValueDescription
errorsType: string arrayA list of error messages
warningsType: string arrayA list of warning messages
inputsType: Object hashKey: Value pairs representing all input parameters
outputsType: Object arrayAn 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

KeyDatatypeRequiredDescription
wktstringType: 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.
addressnullType: string
Default: None
The address to use. Required if neither wkt nor lat/lon are specified.
latnullType: decimal
Default: None
Min: -90
Max: 90
The latitude for the location to use. Required if neither address nor wkt are specified.
lonnullType: decimal
Default: None
Min: -180
Max: 180
The longitude for the location to use. Required if neither address nor wkt are specified.
typenullType: string
Default: None
Options: satellite, station
The type of datasets to include in the response.
show_emptynullType: 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":[]}