BACK TO DOCUMENTATION …

CreateAverageYearSummaryRequest

Basic Asynchronous Request

Method: POST
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: 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. 

{
  "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
    }
}