Solar - National Solar Radiation Database
GET {{nrel_developer_url}}/nsrdb/v2/solar/msg-iodc-download.json?wkt=POINT(14.61 -24.26)&email={{email}}&names=2017
METEOSAT IODC Region: Physical Solar Model (PSM) (/api/nsrdb/v2/solar/msg-iodc-download
)
The National Solar Radiation Database (NSRDB) is a serially complete collection of satellite-derived measurements of solar radiation—global horizontal, direct normal, and diffuse horizontal irradiance—and meteorological data. These data have been collected at a sufficient number of locations and temporal and spatial scales to accurately represent regional solar radiation climates.
The Indian Ocean Data Coverage of the Meteosat satellite covers India and it’s surrounding regions. The Physical Solar Model Version 3 (PSM-v3) was used to develop these datasets. The 4km x 4km data is provided at a 15 minute resolution. This data was produced as part of the U.S.-India Energy Cooperation with support from the US Department of Energy Office of International Affairs.
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 |
inputs | Type: Object Hash | Key: Value pairs representing all input parameters |
outputs | Type: Object Hash | Upon successful completion a message will be returned informing the user that file generation is in progress and an email will be sent to the address provided in the email input field when the download is ready |
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. | |||
email | string | Type: email string | |
Default: None | |||
An active email for the user requesting data. This email will be used to deliver the extracted data. | |||
names | number | Type: comma delimited string array | |
Default: None | |||
Options: 2017, 2018, 2019. | |||
The year(s) for which data should be extracted. | |||
attributes | null | Type: comma delimited string array | |
Default: Returns ALL | |||
Options: air_temperature, alpha, aod, asymmetry, cld_opd_dcomp, cld_reff_dcomp, clearsky_dhi, clearsky_dni, clearsky_ghi, cloud_type, coordinates, dew_point, dhi, dni, fill_flag, ghi, ozone, relative_humidity, solar_zenith_angle, ssa, surface_albedo, surface_pressure, total_precipitable_water, wind_direction, wind_speed. | |||
Each specified attribute(*) will be returned as a column in the resultant CSV download. | |||
utc | null | Type: true or false | |
Default: true | |||
Pass true to retrieve data with timestamps in UTC. Pass false to retrieve data with timestamps converted to local time of data point (without daylight savings time). | |||
leap_day | null | Type: true or false | |
Default: false | |||
Pass true to retrieve data including leap day (where appropriate). Pass false to retrieve data excluding leap day. | |||
interval | null | Type: 15, 30 or 60 | |
Default: None | |||
This value determines data resolution. Either 15, 30 or 60 minute intervals are available. | |||
full_name | null | Type: string | |
Default: None | |||
The full name of the user requesting data. | |||
affiliation | null | Type: string | |
Default: None | |||
The organization with which the user requesting the data is affiliated. | |||
reason | null | Type: string | |
Default: None | |||
The reason that the user is requesting the data. | |||
mailing_list | null | Type: true or false | |
Default: false | |||
Pass true to add the email address to our list of recipients for the NSRDB mailing list. |