Deprecated: We encourage you to migrate the new Solar Resource web service.
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.
GET /api/georeserv/service/solar/dni.format?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. |
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": [
]
}
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>
Standard rate limits apply. No more than 1,000 requests may be made in any hour
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. |