EnergySiteCreateRequest

Basic Asynchronous Request

Method: POST
URL: https://service.solaranywhere.com/api/v2/EnergySites?key=CLIENT_KEY

Specify energy site elements, such as site name and location, as well as PV system elements, such as inverter and module specifications and array configuration details. Post this request to return an energy site ID in the response.

Optional: Provide aCustomerSiteId when specifying EnergySite. This can be used to keep track of the mapping between client and Clean Power Research systems.

<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site" Description="Basic PV system">
  <Location Latitude="34.65" Longitude="-119.10" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="85.00">
    <Inverters>
     <Inverter Count="1" MaxPowerOutputAC_kW="4.470000" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="20" NameplateDCRating_kW="0.22000" PtcRating_kW="0.19760" PowerTemperatureCoefficient_PercentPerDegreeC="0.4" NominalOperatingCellTemperature_DegreesC="45"/>
      </PvModules>
      <ArrayConfiguration Azimuth_Degrees="177.000" Tilt_Degrees="25.000" Tracking="Fixed" TrackingRotationLimit_Degrees="90" RelativeRowSpacing="3"/>
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>
<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site" Description="Sample Site">
  <Location Latitude="34.65" Longitude="-119.10" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="85.00">
    <Inverters>
     <Inverter Count="1" MaxPowerOutputAC_kW="4.470000" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="20" NameplateDCRating_kW="0.22000" PtcRating_kW="0.19760" PowerTemperatureCoefficient_PercentPerDegreeC="0.4" NominalOperatingCellTemperature_DegreesC="45"/>
      </PvModules>
      <ArrayConfiguration Azimuth_Degrees="177.000" Tilt_Degrees="25.000" Tracking="Fixed" TrackingRotationLimit_Degrees="90" RelativeRowSpacing="3"/>
      <SolarObstructions>
       <SolarObstruction Azimuth_Degrees="90.000" Elevation_Degrees="33.000" />
       <SolarObstruction Azimuth_Degrees="120.000" Elevation_Degrees="50.000" />
       <SolarObstruction Azimuth_Degrees="150.000" Elevation_Degrees="22.000" />
       <SolarObstruction Azimuth_Degrees="180.000" Elevation_Degrees="3.000" />
       <SolarObstruction Azimuth_Degrees="210.000" Elevation_Degrees="1.000" />
       <SolarObstruction Azimuth_Degrees="240.000" Elevation_Degrees="2.000" />
       <SolarObstruction Azimuth_Degrees="270.000" Elevation_Degrees="4.000" />
      </SolarObstructions>
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>
<EnergySiteCreateRequest xmlns="http://service.solaranywhere.com/api/v2">
 <EnergySite Name="Sample Site" Description="Sample Site">
  <Location Latitude="34.65" Longitude="-119.10" />
  <PvSystems>
   <PvSystem Albedo_Percent="17" GeneralDerate_Percent="85.00">
    <Inverters>
     <Inverter Count="1" MaxPowerOutputAC_kW="4.470000" EfficiencyRating_Percent="97.000000" />
    </Inverters>
    <PvArrays>
     <PvArray>
      <PvModules>
       <PvModule Count="20" NameplateDCRating_kW="0.22000" PtcRating_kW="0.19760" PowerTemperatureCoefficient_PercentPerDegreeC="0.4" NominalOperatingCellTemperature_DegreesC="45" />
      </PvModules>
      <ArrayConfiguration Azimuth_Degrees="177.000" Tilt_Degrees="25.000" Tracking="Fixed" TrackingRotationLimit_Degrees="90" RelativeRowSpacing="3"/>
      <MonthlyShadings>
       <MonthlyShading MonthNumber="1" SolarAccess_Percent="77.0" />
       <MonthlyShading MonthNumber="2" SolarAccess_Percent="87.0" />
       <MonthlyShading MonthNumber="3" SolarAccess_Percent="98.0" />
       <MonthlyShading MonthNumber="4" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="5" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="6" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="7" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="8" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="9" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="10" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="11" SolarAccess_Percent="100.0" />
       <MonthlyShading MonthNumber="12" SolarAccess_Percent="91.0" />
      </MonthlyShadings>
     </PvArray>
    </PvArrays>
   </PvSystem>
  </PvSystems>
 </EnergySite>
</EnergySiteCreateRequest>

Element and Attribute Names

Energy Site Specifications

  • Name
  • Description
  • Latitude
  • Longitude

PV System Specifications

PV System

Inverters

  • Count
  • MaxPowerOutputAC_kW
  • EfficiencyRating_Percent

PV Modules

Array Configuration

Array configuration parameters specify how the system is installed. Learn more about array configuration and its individual components at the terms & concepts page.

Solar Obstructions or Monthly Solar Access Percentages

Input information about obstructions surrounding the PV system by inserting the following for each obstruction:

  • Opacity_Percent
  • Azimuth_Degrees
  • Elevation_Degrees

 If this information is unavailable, input monthly solar access percentages:

  • MonthNumber
  • SolarAccess_Percent

Learn more about these inputs and how they function in their respective shading models at the terms and concepts page.