Page Comparison

...

REST endpoint: https://solargis.info/ws/rest/pvplanner/calculate?key=demo

LTA API

Web service provides API access to solar, meteo, and PVout data available in Solargis Prospect application.

XML Schemas

ws-pvplanner.xsd - LTA API service request and response
common-types.xsd - generic common types, like percent, monthly values, etc.
common-geo.xsd - geographic common types, like location, terrain, horizon, etc.
common-pv.xsd - pv system common configuration, like geometry, mounting, losses, etc.

Tip
Technical schema documentation is available here

Requext XML

Code Block

<calculateRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:geo="http://geomodel.eu/schema/common/geo"
      xmlns:pv="http://geomodel.eu/schema/common/pv"
      xmlns="http://geomodel.eu/schema/ws/pvplanner">
	<site lat="48.612590" lng="20.827079">
		<!-- optional terrain data -->
		<geo:terrain elevation="246" azimuth="176" tilt="3.1" />
		<!-- optional horizon data -->
		<geo:horizon>11.11:18.0 7.5:15.53 15.0:10.94 22.5:10.59 30.0:13.06 37.5:14.47 45.0:14.47 52.5:13.76 60.0:12.35 67.5:11.29 75.0:8.12 82.5:4.59 90.0:1.41 97.5:0.35 105.0:0.35 112.5:0.35 120.0:0.35 127.5:0.35 135.0:0.0 142.5:0.0 150.0:0.35 157.5:1.41 165.0:2.47 172.5:2.47 180.0:2.82 187.5:3.18 195.0:2.82 202.5:2.47 210.0:2.47 217.5:2.47 225.0:3.18 232.5:3.18 240.0:2.47 247.5:2.12 255.0:2.12 262.5:2.82 270.0:3.88 277.5:6.71 285.0:8.47 292.5:10.24 300.0:11.29 307.5:12.71 315.0:14.12 322.5:15.53 330.0:16.24 337.5:16.94 345.0:17.29 352.5:17.29</geo:horizon>
		<pv:geometry xsi:type="pv:GeometryFixedOneAngle" azimuth="175" tilt="45"/>
		<pv:system installedPower="1" installationType="ROOF_MOUNTED" availability="99">
			<pv:module type="CSI">
			</pv:module>
			<pv:inverter>
				<pv:efficiency xsi:type="pv:EfficiencyConstant" percent="97.5"/>
			</pv:inverter>
			<pv:losses dc="5.5" ac="1.5"/>
		</pv:system>
	</site>
</calculateRequest>

Response XML

Code Block

<ns4:calculateResponse xmlns:ns4="http://geomodel.eu/schema/ws/pvplanner" xmlns:ns2="http://geomodel.eu/schema/common/geo" xmlns:ns3="http://geomodel.eu/schema/common/pv" xmlns:ns5="http://geomodel.eu/schema/ws/data">
    <ns4:site lat="48.61259" lng="20.827079">
       <ns2:terrain azimuth="176" elevation="246" tilt="3.1"/>
       <ns2:horizon>11.11:18.0 7.5:15.53 15.0:10.94 22.5:10.59 30.0:13.06 37.5:14.47 45.0:14.47 52.5:13.76 60.0:12.35 67.5:11.29 75.0:8.12 82.5:4.59 90.0:1.41 97.5:0.35 105.0:0.35 112.5:0.35 120.0:0.35 127.5:0.35 135.0:0.0 142.5:0.0 150.0:0.35 157.5:1.41 165.0:2.47 172.5:2.47 180.0:2.82 187.5:3.18 195.0:2.82 202.5:2.47 210.0:2.47 217.5:2.47 225.0:3.18 232.5:3.18 240.0:2.47 247.5:2.12 255.0:2.12 262.5:2.82 270.0:3.88 277.5:6.71 285.0:8.47 292.5:10.24 300.0:11.29 307.5:12.71 315.0:14.12 322.5:15.53 330.0:16.24 337.5:16.94 345.0:17.29 352.5:17.29</ns2:horizon>
       <ns3:geometry azimuth="175" tilt="45.0" xsi:type="ns3:GeometryFixedOneAngle" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
       <ns3:system availability="99.0" installationType="ROOF_MOUNTED" installedPower="1.0">
          <ns3:module type="CSI">
             <ns3:degradation>0.0</ns3:degradation>
          </ns3:module>
          <ns3:inverter>
             <ns3:efficiency percent="97.5" xsi:type="ns3:EfficiencyConstant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
          </ns3:inverter>
          <ns3:losses ac="1.5" dc="5.5"/>
       </ns3:system>
    </ns4:site>
    <ns4:irradiation>
       <ns4:reference>
          <ns4:Ghm monthly="33 50 96 125 158 168 165 150 100 66 34 24" yearly="1169"/>
          <ns4:Ghd monthly="1.05 1.80 3.08 4.16 5.11 5.59 5.32 4.85 3.35 2.12 1.12 0.78" yearly="3.20"/>
          <ns4:Dhd monthly="0.61 0.98 1.61 2.13 2.61 2.80 2.69 2.32 1.70 1.14 0.69 0.48" yearly="1.65"/>
          <ns4:Td monthly="-1.8 -0.4 4.1 10.1 15.5 18.6 20.5 19.9 14.5 9.4 3.9 -1.2" yearly="9.5"/>
          <ns4:Tmin monthly="-3.7 -3.1 0.9 6.5 11.1 13.9 15.9 15.6 11.2 6.3 1.7 -2.9"/>
          <ns4:Tmax monthly="1.4 3.8 8.8 15.5 20.9 23.9 25.8 25.8 20.3 14.6 7.6 1.6"/>
       </ns4:reference>
       <ns4:inplane>
          <ns4:Gim monthly="63 82 126 139 155 155 157 160 124 98 58 48" yearly="1365"/>
          <ns4:Gid monthly="2.05 2.92 4.08 4.63 4.99 5.17 5.06 5.17 4.12 3.17 1.93 1.54" yearly="3.74"/>
          <ns4:Did monthly="0.73 1.10 1.70 2.10 2.44 2.56 2.49 2.28 1.75 1.26 0.78 0.57" yearly="1.65"/>
          <ns4:Rid monthly="0.02 0.03 0.06 0.08 0.09 0.10 0.10 0.09 0.06 0.04 0.02 0.01" yearly="0.06"/>
          <ns4:ShLoss monthly="0.5 0.1 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.1 0.1 0.4" yearly="0.1"/>
       </ns4:inplane>
       <ns4:comparison>
          <ns4:horizontal percentOpt="84.9" yearlySum="1169.0"/>
          <ns4:optimum percentOpt="100.0" yearlySum="1377.0"/>
          <ns4:tracker2x percentOpt="126.0" yearlySum="1735.0"/>
          <ns4:selected percentOpt="99.1" yearlySum="1365.0"/>
       </ns4:comparison>
       <ns4:optimum fixed="37.0"/>
    </ns4:irradiation>
    <ns4:calculation>
       <ns4:output>
          <ns4:Esm monthly="54 69 104 110 120 119 119 122 97 79 48 41" yearly="1086"/>
          <ns4:Esd monthly="1.76 2.49 3.37 3.69 3.88 3.97 3.85 3.95 3.24 2.57 1.61 1.32" yearly="2.98"/>
          <ns4:Etm monthly="55 70 104 111 120 119 119 122 97 80 48 41" yearly="1087"/>
          <ns4:Eshare monthly="5.0 6.4 9.6 10.2 11.1 10.9 11.0 11.3 8.9 7.3 4.4 3.8" yearly="100.0"/>
          <ns4:PR monthly="85.6 85.0 82.8 79.8 77.9 76.8 76.1 76.6 78.6 80.9 83.1 85.2" yearly="79.6"/>
       </ns4:output>
       <ns4:losses>
          <ns4:global PRc="100.0" PRp="100.0" output="1366"/>
          <ns4:terrain PRc="99.9" PRp="99.9" lossAbs="-1" lossRel="-0.1" output="1365"/>
          <ns4:angular PRc="97.0" PRp="97.1" lossAbs="-40" lossRel="-2.9" output="1325"/>
          <ns4:conversion PRc="88.5" PRp="91.2" lossAbs="-116" lossRel="-8.8" output="1209"/>
          <ns4:dcLoss PRc="83.7" PRp="94.5" lossAbs="-66" lossRel="-5.5" output="1143"/>
          <ns4:inverter PRc="81.6" PRp="97.5" lossAbs="-29" lossRel="-2.5" output="1114"/>
          <ns4:acLoss PRc="80.4" PRp="98.6" lossAbs="-16" lossRel="-1.4" output="1098"/>
          <ns4:availability PRc="79.6" PRp="99.0" lossAbs="-11" lossRel="-1.0" output="1087"/>
          <ns4:total PRc="79.6" lossAbs="-279" lossRel="-20.4" output="1087"/>
       </ns4:losses>
    </ns4:calculation>
    <ns4:summary>PV system: 1.0 kWp, crystalline silicon, fixed roof, azim. 175&amp;deg; (south), inclination 45&amp;deg;</ns4:summary>
</ns4:calculateResponse>

Curl request equivalent:

Curl request form (bash)

Code Block

language	bash

curl -sv -H 'Content-Type: application/xml' -d '<calculateRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:geo="http://geomodel.eu/schema/common/geo" xmlns:pv="http://geomodel.eu/schema/common/pv" xmlns="http://geomodel.eu/schema/ws/pvplanner"> <site lat="48.61259" lng="20.827079"> <pv:geometry xsi:type="pv:GeometryFixedOneAngle" azimuth="242" tilt="15"></pv:geometry> <pv:system installedPower="494.00000" installationType="ROOF_MOUNTED" availability="100"> <pv:module type="CSI"></pv:module> <pv:inverter> <pv:efficiency xsi:type="pv:EfficiencyConstant" percent="97.5"></pv:efficiency> </pv:inverter> <pv:losses dc="5.5" ac="1.5"> </pv:losses> </pv:system> </site> </calculateRequest>' https://solargis.info/ws/rest/pvplanner/calculate?key=demo

...

Versions Compared

Old Version 42

New Version 43

Key

LTA API

XML Schemas

Requext XML

Response XML

Curl request form (bash)