CreateAverageYearSummaryRequest
Basic Asynchronous Request
URL: https://service.solaranywhere.com/api/v2/AverageYearSummary
Use the example requests below to request monthly total/average values at your locations of interest. Visit our support center to learn more about SolarAnywhere average year summaries. Required attributes are: Latitude, Longitude, WeatherDataSource, SpatialResolution_Degrees, MissingDataHandling, and OutputFields. Visit the average year summary options page to learn more about each CreateAverageYearSummaryRequest attribute.
With average year summary requests, you have the option to include the following simulated output fields:
- SoilingLossesDC_Percent
- SnowLossesDC_Percent
- PlaneOfArrayIrradiance_WattsPerMeterSquared
If you would like to include these output fields, start with the “Fixed Tilt System” or “Single-axis Tracking System” example below. Our simulation terms & concepts page provides additional detail on the snow and soiling loss models implemented to generate snow and soiling loss output fields.
- 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",
"PlaneOfArrayIrradiance_WattsPerMeterSquared"
],
"SpatialResolution_Degrees": 0.1,
"WeatherDataSource": "SolarAnywhereLatest",
"MissingDataHandling": "Blank"
},
"ArrayConfiguration": {
"Azimuth_Degrees": 180.000,
"Tracking": "SingleAxis",
"TrackingRotationLimit_Degrees": 60,
"RelativeRowSpacing": 3
}
}