Irradiance & Weather Data
Average Year Summary Requests
The AverageYearSummary service endpoint allows the client to request 12 monthly averages or totals of irradiance, weather or PV system losses at one or multiple site locations. Learn more about average year summary data in the SolarAnywhere support center. The AverageYearSummary endpoint requires the client to specify site coordinates within their request, as well the desired output data fields and the SolarAnywhere historical irradiance data that should be used as an input. Available irradiance, weather and system loss data fields include:
- Global Horizontal Irradiance (GHI)
- Direct Normal Irradiance (DNI)
- Diffuse Horizontal Irradiance (DHI)
- Plane of Array Irradiance (POAI)
- 10-Meter Height Wind Speed
- 2-Meter Height Dry Bulb Temperature
- Relative Humidity
- Liquid Precipitation
- Solid Precipitation
- Snow Depth
- Albedo
- Particulate Matter
- Snow Losses
- Soiling Losses
Average Year Summary Data
Request average year summary data by specifying one or more sets of latitude and longitude pairs, a list of output fields and details on the SolarAnywhere irradiance data to use in generating the averages. This method operates asynchronously, requiring the client to POST their average year summary request, then retrieve data using a GET request. The python request payload is in JSON format and should be submitted as a string as opposed to a dictionary. Visit the complete schema for more detail on each step in this asynchronous structure.
import requests
import time
#POST Create AverageYearSummary Request
url = "https://service.solaranywhere.com/api/v2/AverageYearSummary"
apiKey = "your_api_key"
payload = """{
"Sites": [
{
"Name": "Lisbon",
"Latitude": 38.725,
"Longitude": -9.155
}
],
"Options": {
"OutputFields": [
"GlobalHorizontalIrradiance_WattsPerMeterSquared",
"DirectNormalIrradiance_WattsPerMeterSquared",
"DiffuseHorizontalIrradiance_WattsPerMeterSquared",
"AmbientTemperature_DegreesC",
"WindSpeed_MetersPerSecond",
"RelativeHumidity_Percent",
"SnowDepth_Meters",
"LiquidPrecipitation_KilogramsPerMeterSquared",
"SolidPrecipitation_KilogramsPerMeterSquared",
"ParticulateMatter2.5_MicrogramsPerMeterCubed",
"ParticulateMatter10_MicrogramsPerMeterCubed",
"Albedo_Unitless"
],
"SpatialResolution_Degrees": 0.1,
"WeatherDataSource": "SolarAnywhereLatest",
"MissingDataHandling": "Blank"
}
}"""
headers = {
'content-type': "application/json; charset=utf-8",
'X-Api-Key': apiKey,
'Accept': "application/json"
}
response = requests.post(url,data=payload,
headers=headers)
root = response.json()
print(response.text)
print("-----")
publicId = root["SummaryRequestId"]
print(publicId)
#GET AverageYearSummaryResult
url2 = "https://service.solaranywhere.com/api/v2/AverageYearSummaryResult/"
requestNumber = 0
MAX_requestNumber = 100
while(requestNumber < MAX_requestNumber):
time.sleep(5)
data = requests.get(url2 + publicId, headers=headers)
radicle = data.json()
status = radicle["Status"]
print(radicle)
if status == "Done":
print(radicle)
break
else:
requestNumber = requestNumber + 1Sample Requests
Using the AverageYearSummary method, the client can request monthly snow losses, soiling losses and plane of array irradiance fields (POAI) in addition to the irradiance and weather data output fields included in the payload of the above python example. In requesting these simulated fields, users have the option of providing several key PV array configuration inputs for more site-specific estimates. If these array configuration attributes are not provided by the user, the simulation will use SolarAnywhere defaults. For more detail on the options available for each AverageYearSummaryRequest attribute and default values implemented for simulated outputs, see the average year summary options page.
These sample AverageYearSummary request payloads demonstrate a basic average year summary request for irradiance and weather data fields, as well as two samples requesting the snow loss, soiling loss and POAI fields with varying array configurations:
- Average Year Summary - Basic
- Average Year Summary - Fixed Tilt System
- Average Year Summary - Single-axis Tracking System
{
"Sites": [
{
"Name": "Lisbon",
"Latitude": 38.725,
"Longitude": -9.155
}
],
"Options": {
"OutputFields": [
"GlobalHorizontalIrradiance_WattsPerMeterSquared",
"DirectNormalIrradiance_WattsPerMeterSquared",
"DiffuseHorizontalIrradiance_WattsPerMeterSquared",
"AmbientTemperature_DegreesC",
"WindSpeed_MetersPerSecond",
"RelativeHumidity_Percent",
"SnowDepth_Meters",
"LiquidPrecipitation_KilogramsPerMeterSquared",
"SolidPrecipitation_KilogramsPerMeterSquared",
"ParticulateMatter2.5_MicrogramsPerMeterCubed",
"ParticulateMatter10_MicrogramsPerMeterCubed",
"Albedo_Unitless"
],
"SpatialResolution_Degrees": 0.1,
"WeatherDataSource": "SolarAnywhereLatest",
"MissingDataHandling": "Blank"
}
}{
"Sites": [
{
"Name": "Calgary",
"Latitude": 51.045,
"Longitude": -114.055
}
],
"Options": {
"OutputFields": [
"GlobalHorizontalIrradiance_WattsPerMeterSquared",
"DirectNormalIrradiance_WattsPerMeterSquared",
"DiffuseHorizontalIrradiance_WattsPerMeterSquared",
"AmbientTemperature_DegreesC",
"WindSpeed_MetersPerSecond",
"RelativeHumidity_Percent",
"SnowDepth_Meters",
"LiquidPrecipitation_KilogramsPerMeterSquared",
"SolidPrecipitation_KilogramsPerMeterSquared",
"ParticulateMatter2.5_MicrogramsPerMeterCubed",
"ParticulateMatter10_MicrogramsPerMeterCubed",
"Albedo_Unitless",
"SoilingLossesDC_Percent",
"SnowLossesDC_Percent",
"PlaneOfArrayIrradiance_WattsPerMeterSquared"
],
"SpatialResolution_Degrees": 0.1,
"WeatherDataSource": "SolarAnywhereLatest",
"MissingDataHandling": "Blank"
},
"ArrayConfiguration": {
"Azimuth_Degrees": 180,
"Tilt_Degrees": 30.0,
"Tracking": "Fixed",
"RelativeRowSpacing": 3
}
}{
"Sites": [
{
"Name": "Calgary",
"Latitude": 51.045,
"Longitude": -114.055
}
],
"Options": {
"OutputFields": [
"GlobalHorizontalIrradiance_WattsPerMeterSquared",
"DirectNormalIrradiance_WattsPerMeterSquared",
"DiffuseHorizontalIrradiance_WattsPerMeterSquared",
"AmbientTemperature_DegreesC",
"WindSpeed_MetersPerSecond",
"RelativeHumidity_Percent",
"SnowDepth_Meters",
"LiquidPrecipitation_KilogramsPerMeterSquared",
"SolidPrecipitation_KilogramsPerMeterSquared",
"ParticulateMatter2.5_MicrogramsPerMeterCubed",
"ParticulateMatter10_MicrogramsPerMeterCubed",
"Albedo_Unitless",
"SoilingLossesDC_Percent",
"SnowLossesDC_Percent",<br /> "PlaneOfArrayIrradiance_WattsPerMeterSquared"
],
"SpatialResolution_Degrees": 0.1,
"WeatherDataSource": "SolarAnywhereLatest",
"MissingDataHandling": "Blank"
},
"ArrayConfiguration": {
"Azimuth_Degrees": 180.000,
"Tracking": "SingleAxis",
"TrackingRotationLimit_Degrees": 60,
"RelativeRowSpacing": 3
}
}Sample Responses
These sample responses correspond to each of the above average year summary requests:
- Average Year Summary - Basic Response
- Average Year Summary - Fixed Tilt System Response
- Average Year Summary - Single-axis Tracking System Response
{
"SummaryRequestId": "JDE0QYF",
"Status": "Done",
"RequestId": "58X771VU0",
"SummaryResults": [
{
"Status": "Success",
"WeatherSourceInformation": {
"WeatherSiteName": "Lisbon",
"Latitude": 38.725,
"Longitude": -9.155,
"ApplyTrueDynamics": false
},
"AverageYearSummaryData": [
{
"Field": "GlobalHorizontalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 1778067,
"MonthlyData": [
70283,
91422,
139476,
170991,
212529,
226790,
237923,
215753,
161334,
113232,
76102,
62232
]
},
{
"Field": "DirectNormalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 2037830,
"MonthlyData": [
107466,
121707,
153635,
166990,
207580,
231667,
258130,
244875,
188861,
142615,
113134,
101170
]
},
{
"Field": "DiffuseHorizontalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 569455,
"MonthlyData": [
29219,
35072,
52872,
63899,
69757,
64111,
57891,
52467,
47423,
40764,
29988,
25992
]
},
{
"Field": "AmbientTemperature_DegreesC",
"AverageOrTotal": "Average",
"Annual": 15.7,
"MonthlyData": [
11.3,
11.6,
13,
14.2,
16.3,
18.5,
19.8,
20.4,
19.6,
17.6,
14,
12
]
},
{
"Field": "WindSpeed_MetersPerSecond",
"AverageOrTotal": "Average",
"Annual": 4.3,
"MonthlyData": [
4.1,
4.3,
4.2,
4.3,
4.4,
4.6,
5,
4.7,
3.7,
3.7,
4.1,
4.2
]
},
{
"Field": "RelativeHumidity_Percent",
"AverageOrTotal": "Average",
"Annual": 77,
"MonthlyData": [
81,
78,
76,
77,
75,
75,
75,
75,
76,
79,
79,
81
]
},
{
"Field": "LiquidPrecipitation_KilogramsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 565.751,
"MonthlyData": [
62.433,
57.466,
58.442,
59.402,
38.731,
10.94,
3.038,
4.945,
33.549,
78.526,
81.846,
76.432
]
},
{
"Field": "SolidPrecipitation_KilogramsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 0,
"MonthlyData": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
},
{
"Field": "SnowDepth_Meters",
"AverageOrTotal": "Average",
"Annual": 0,
"MonthlyData": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
},
{
"Field": "Albedo_Unitless",
"AverageOrTotal": "Average",
"Annual": 0.18,
"MonthlyData": [
0.18,
0.17,
0.18,
0.18,
0.18,
0.18,
0.18,
0.18,
0.18,
0.18,
0.18,
0.18
]
},
{
"Field": "ParticulateMatter10_MicrogramsPerMeterCubed",
"AverageOrTotal": "Average",
"Annual": 33.6,
"MonthlyData": [
28.8,
34.9,
37.4,
33.3,
31.5,
33.2,
35.9,
38.8,
33.6,
34,
30.4,
31.1
]
},
{
"Field": "ParticulateMatter2.5_MicrogramsPerMeterCubed",
"AverageOrTotal": "Average",
"Annual": 12.8,
"MonthlyData": [
9.9,
11.9,
13.6,
11.9,
12.1,
13,
14,
19.4,
15.3,
12.7,
9.9,
10.1
]
}
],
"ErrorMessages": []
}
]
}{
"SummaryRequestId": "88DNJXN",
"Status": "Done",
"RequestId": "V9BHTW37P",
"SummaryResults": [
{
"Status": "Success",
"WeatherSourceInformation": {
"WeatherSiteName": "Calgary",
"Latitude": 51.045,
"Longitude": -114.055,
"ApplyTrueDynamics": false
},
"ArrayConfiguration": {
"Azimuth_Degrees": 180,
"Tilt_Degrees": 30.0,
"Tracking": "Fixed",
"RelativeRowSpacing": 3
},
"AverageYearSummaryData": [
{
"Field": "GlobalHorizontalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 1301662,
"MonthlyData": [
36436,
60750,
107076,
139994,
170304,
176499,
198005,
160759,
111611,
72400,
38893,
28935
]
},
{
"Field": "DirectNormalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 1510985,
"MonthlyData": [
76565,
100991,
129526,
138388,
151248,
155365,
200484,
169000,
137955,
108547,
73744,
69172
]
},
{
"Field": "DiffuseHorizontalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 538780,
"MonthlyData": [
17603,
26541,
48187,
62550,
75470,
75743,
68907,
59405,
42033,
30048,
18398,
13895
]
},
{
"Field": "AmbientTemperature_DegreesC",
"AverageOrTotal": "Average",
"Annual": 4.2,
"MonthlyData": [
-6.3,
-6,
-1.7,
3.8,
9.3,
13,
16.2,
15.1,
10.4,
3.9,
-1.7,
-6.6
]
},
{
"Field": "WindSpeed_MetersPerSecond",
"AverageOrTotal": "Average",
"Annual": 2.2,
"MonthlyData": [
2.4,
2.1,
2.3,
2.3,
2.3,
2.1,
2,
2,
2.1,
2.2,
2.4,
2.4
]
},
{
"Field": "RelativeHumidity_Percent",
"AverageOrTotal": "Average",
"Annual": 65,
"MonthlyData": [
67,
65,
63,
58,
57,
66,
67,
66,
65,
65,
68,
68
]
},
{
"Field": "LiquidPrecipitation_KilogramsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 358.16,
"MonthlyData": [
0.246,
0.528,
3.432,
20.091,
58.901,
100.816,
57.651,
59.626,
39.842,
14.702,
2.067,
0.258
]
},
{
"Field": "SolidPrecipitation_KilogramsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 139.215,
"MonthlyData": [
14.85,
17.022,
22.302,
23.437,
8.865,
0.093,
0,
0,
3.408,
11.694,
19.432,
18.111
]
},
{
"Field": "SnowDepth_Meters",
"AverageOrTotal": "Average",
"Annual": 0.019,
"MonthlyData": [
0.045,
0.044,
0.032,
0.014,
0.004,
0.001,
0.001,
0.001,
0.003,
0.009,
0.026,
0.045
]
},
{
"Field": "Albedo_Unitless",
"AverageOrTotal": "Average",
"Annual": 0.32,
"MonthlyData": [
0.56,
0.56,
0.44,
0.29,
0.19,
0.18,
0.16,
0.16,
0.16,
0.24,
0.4,
0.54
]
},
{
"Field": "ParticulateMatter10_MicrogramsPerMeterCubed",
"AverageOrTotal": "Average",
"Annual": 7.8,
"MonthlyData": [
4.5,
4.4,
6,
7.9,
10.8,
8.3,
9.4,
15.5,
8.7,
6.2,
7.1,
4.6
]
},
{
"Field": "ParticulateMatter2.5_MicrogramsPerMeterCubed",
"AverageOrTotal": "Average",
"Annual": 8.2,
"MonthlyData": [
4.4,
3.8,
3.9,
4.8,
7.7,
7.4,
12.1,
22.6,
10.6,
6.9,
8.5,
4.8
]
},
{
"Field": "SoilingLossesDC_Percent",
"AverageOrTotal": "Average",
"Annual": 0.4,
"MonthlyData": [
0.7,
0.8,
1.0,
1.0,
0.4,
0.1,
0.1,
0.1,
0.2,
0.2,
0.4,
0.6
]
},
{
"Field": "SnowLossesDC_Percent",
"AverageOrTotal": "Average",
"Annual": 7.7,
"MonthlyData": [
23.9,
22.5,
11.6,
8.1,
2.4,
0.7,
0.3,
0.3,
1.6,
4.2,
16.7,
32.9
]
},
{
"Field": "PlaneOfArrayIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 1619465,
"MonthlyData": [
73262,
102719,
146542,
162663,
178528,
179184,
206025,
180754,
143566,
110313,
73032,
62877
]
}
],
"ErrorMessages": []
}
]
}{
"SummaryRequestId": "FQWTEB9",
"Status": "Done",
"RequestId": "EDHMY9N2T",
"SummaryResults": [
{
"Status": "Success",
"WeatherSourceInformation": {
"WeatherSiteName": "Calgary",
"Latitude": 51.045,
"Longitude": -114.055,
"ApplyTrueDynamics": false
},
"ArrayConfiguration": {
"Azimuth_Degrees": 180,
"Tilt_Degrees": 0,
"Tracking": "SingleAxis",
"RelativeRowSpacing": 3
},
"AverageYearSummaryData": [
{
"Field": "GlobalHorizontalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 1301662,
"MonthlyData": [
36436,
60750,
107076,
139994,
170304,
176499,
198005,
160759,
111611,
72400,
38893,
28935
]
},
{
"Field": "DirectNormalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 1510985,
"MonthlyData": [
76565,
100991,
129526,
138388,
151248,
155365,
200484,
169000,
137955,
108547,
73744,
69172
]
},
{
"Field": "DiffuseHorizontalIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 538780,
"MonthlyData": [
17603,
26541,
48187,
62550,
75470,
75743,
68907,
59405,
42033,
30048,
18398,
13895
]
},
{
"Field": "AmbientTemperature_DegreesC",
"AverageOrTotal": "Average",
"Annual": 4.2,
"MonthlyData": [
-6.3,
-6,
-1.7,
3.8,
9.3,
13,
16.2,
15.1,
10.4,
3.9,
-1.7,
-6.6
]
},
{
"Field": "WindSpeed_MetersPerSecond",
"AverageOrTotal": "Average",
"Annual": 2.2,
"MonthlyData": [
2.4,
2.1,
2.3,
2.3,
2.3,
2.1,
2,
2,
2.1,
2.2,
2.4,
2.4
]
},
{
"Field": "RelativeHumidity_Percent",
"AverageOrTotal": "Average",
"Annual": 65,
"MonthlyData": [
67,
65,
63,
58,
57,
66,
67,
66,
65,
65,
68,
68
]
},
{
"Field": "LiquidPrecipitation_KilogramsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 358.16,
"MonthlyData": [
0.246,
0.528,
3.432,
20.091,
58.901,
100.816,
57.651,
59.626,
39.842,
14.702,
2.067,
0.258
]
},
{
"Field": "SolidPrecipitation_KilogramsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 139.215,
"MonthlyData": [
14.85,
17.022,
22.302,
23.437,
8.865,
0.093,
0,
0,
3.408,
11.694,
19.432,
18.111
]
},
{
"Field": "SnowDepth_Meters",
"AverageOrTotal": "Average",
"Annual": 0.019,
"MonthlyData": [
0.045,
0.044,
0.032,
0.014,
0.004,
0.001,
0.001,
0.001,
0.003,
0.009,
0.026,
0.045
]
},
{
"Field": "Albedo_Unitless",
"AverageOrTotal": "Average",
"Annual": 0.32,
"MonthlyData": [
0.56,
0.56,
0.44,
0.29,
0.19,
0.18,
0.16,
0.16,
0.16,
0.24,
0.4,
0.54
]
},
{
"Field": "ParticulateMatter10_MicrogramsPerMeterCubed",
"AverageOrTotal": "Average",
"Annual": 7.8,
"MonthlyData": [
4.5,
4.4,
6,
7.9,
10.8,
8.3,
9.4,
15.5,
8.7,
6.2,
7.1,
4.6
]
},
{
"Field": "ParticulateMatter2.5_MicrogramsPerMeterCubed",
"AverageOrTotal": "Average",
"Annual": 8.2,
"MonthlyData": [
4.4,
3.8,
3.9,
4.8,
7.7,
7.4,
12.1,
22.6,
10.6,
6.9,
8.5,
4.8
]
},
{
"Field": "SoilingLossesDC_Percent",
"AverageOrTotal": "Average",
"Annual": 0.4,
"MonthlyData": [
0.7,
0.8,
1.0,
1.0,
0.4,
0.1,
0.1,
0.1,
0.1,
0.2,
0.4,
0.6
]
},
{
"Field": "SnowLossesDC_Percent",
"AverageOrTotal": "Average",
"Annual": 6.6,
"MonthlyData": [
25.2,
24.3,
12.0,
7.8,
2.7,
0.8,
0.4,
0.4,
1.9,
4.2,
18.3,
36.3
]
},
{
"Field": "PlaneOfArrayIrradiance_WattsPerMeterSquared",
"AverageOrTotal": "Total",
"Annual": 1759046,
"MonthlyData": [
53913,
89363,
148575,
186261,
219673,
229988,
263833,
213480,
153654,
101427,
55961,
42919
]
}
],
"ErrorMessages": []
}
]
}
What’s Next?