Developer Network NREL NREL Developer Network

Direct Normal Irradiance (Deprecated) (GET /api/georeserv/service/solar/dni)

Deprecated: We encourage you to migrate the new Solar Resource web service.

Direct Normal Irradiance API Will Shutdown on October 31, 2016

This deprecated API will be shutdown on October 31, 2016. Please migrate to the new API.

For further questions or assistance, contact us.

Provides monthly average and annual average daily total direct normal solar resource values (watt-hours/m2/day) at a given location.

The insolation values represent the resource available to concentrating systems that track the sun throughout the day and are created using the SUNY Satellite Solar Radiation model. The values are averaged over surface cells of 0.1 degrees in both latitude and longitude, or about 10 km in size.

Request URL

GET /api/georeserv/service/solar/dni.format?parameters

Request Parameters

Parameter Required Value Description
format Yes
Type: string
Default: None
Options: json, xml, csv

The output response format. Given in the URL as the file extension.

api_key Yes
Type: string
Default: None

Your developer API key. See API keys for more information.

lat Depends
Type: decimal
Default: None
Latitude, required if address not given.
lon Depends
Type: decimal
Default: None
Longitude, required if address not given.
address Depends
Type: string
Default: None
Address to use, lat/lon returned by Google's geocoding service.

Examples

JSON Output Format

GET /api/georeserv/service/solar/dni.json?api_key=DEMO_KEY&address=Golden,%20CO
{
  "errors": [
    {
    }
  ],
  "infos": [

  ],
  "inputs": {
    "address": "Golden, CO"
  },
  "outputs": {
    "jan": 4680,
    "feb": 5373,
    "mar": 5968,
    "apr": 6157,
    "may": 6476,
    "jun": 6653,
    "jul": 6654,
    "aug": 5600,
    "sep": 6155,
    "oct": 5346,
    "nov": 4838,
    "dec": 4910,
    "annual": 5735
  },
  "version": "2.1.7",
  "warnings": [

  ]
}

XML Output Format

GET /api/georeserv/service/solar/dni.xml?api_key=DEMO_KEY&address=Golden,%20CO
<?xml version="1.0"?>
<params>
  <param>
    <value>
      <array>
        <data/>
      </array>
    </value>
    <value>
      <string>errors</string>
    </value>
    <value>
      <array>
        <data/>
      </array>
    </value>
    <value>
      <struct/>
    </value>
  </param>
  <param>
    <value>
      <array>
        <data/>
      </array>
    </value>
    <value>
      <string>infos</string>
    </value>
    <value>
      <array>
        <data/>
      </array>
    </value>
  </param>
  <param>
    <value>
      <array>
        <data/>
      </array>
    </value>
    <value>
      <string>inputs</string>
    </value>
    <value>
      <struct>
        <member>
          <name>api_key</name>
        </member>
      </struct>
    </value>
    <value>
      <string>DEMO_KEY</string>
    </value>
    <member>
      <name>address</name>
      <value>
        <string>Golden, CO</string>
      </value>
    </member>
  </param>
  <param>
    <value>
      <array>
        <data/>
      </array>
    </value>
    <value>
      <string>outputs</string>
    </value>
    <value>
      <struct>
        <member>
          <name>mar</name>
        </member>
      </struct>
    </value>
    <value>
      <int>5968</int>
    </value>
    <member>
      <name>feb</name>
      <value>
        <int>5373</int>
      </value>
    </member>
    <member>
      <name>aug</name>
      <value>
        <int>5600</int>
      </value>
    </member>
    <member>
      <name>sep</name>
      <value>
        <int>6155</int>
      </value>
    </member>
    <member>
      <name>apr</name>
      <value>
        <int>6157</int>
      </value>
    </member>
    <member>
      <name>annual</name>
      <value>
        <int>5735</int>
      </value>
    </member>
    <member>
      <name>jun</name>
      <value>
        <int>6653</int>
      </value>
    </member>
    <member>
      <name>jul</name>
      <value>
        <int>6654</int>
      </value>
    </member>
    <member>
      <name>jan</name>
      <value>
        <int>4680</int>
      </value>
    </member>
    <member>
      <name>may</name>
      <value>
        <int>6476</int>
      </value>
    </member>
    <member>
      <name>nov</name>
      <value>
        <int>4838</int>
      </value>
    </member>
    <member>
      <name>dec</name>
      <value>
        <int>4910</int>
      </value>
    </member>
    <member>
      <name>oct</name>
      <value>
        <int>5346</int>
      </value>
    </member>
  </param>
  <param>
    <value>
      <array>
        <data/>
      </array>
    </value>
    <value>
      <string>version</string>
    </value>
    <value>
      <string>2.1.7</string>
    </value>
  </param>
  <param>
    <value>
      <array>
        <data/>
      </array>
    </value>
    <value>
      <string>warnings</string>
    </value>
    <value>
      <array>
        <data/>
      </array>
    </value>
  </param>
</params>

Rate Limits

Standard rate limits apply. No more than 1,000 requests may be made in any hour

Errors

Standard errors may be returned. In addition, the following service-specific errors may be returned:

HTTP Status Code Description
400 Invalid Request - One or more parameters did not pass validation, or a parameter may be missing. Check the error section of the response to see how the request url should be modified to address the error.
Help Improve this Content