Page Comparison

LTA API is a new name for the web service formerly known as pvPlanner WS

Table of Contents

WSDL location: https://solargis.info/ws/soap/pvPlannerWebService.wsdl

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

...

LTA API

Web service provides API access to PvPlanner "Calculate" functionality, available in online application: http://solargis.info/pvplannersolar, 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

xml

Code Block

xml

<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

xml

<ns4<ns3:calculateResponse xmlns:ns4="http://geomodel.eu/schema/wscommon/pvplannergeo" xmlns:ns2="http://geomodel.eu/schema/common/geopv" xmlns:ns3="http://geomodel.eu/schema/common/pv" xmlns:ns5="http://geomodel.eu/schema/ws/datapvplanner">
    <ns4<ns3:site lat="48.61259" lng="20.827079">
       <ns2:terrain azimuth="176" <terrain elevation="246" tilt="3.1" azimuth="176"/>
        <ns2:horizon>11<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<ns2:geometry azimuth="175" tilt="45.0xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3ns2:GeometryFixedOneAngle" xmlns:xsitilt="http://www.w3.org/2001/XMLSchema-instance45.0" azimuth="175"/>
        <ns3<ns2:system availabilityinstalledPower="991.0" installationType="ROOF_MOUNTED" installedPoweravailability="199.0">
            <ns3<ns2:module type="CSI"/>
            <ns2:inverter>
 <ns3:degradation>0.0</ns3:degradation>           </ns3:module>           <ns3:inverter>
             <ns3:efficiency percent="97.5" xsi:type="ns3:EfficiencyConstant"<ns2:efficiency xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
     xsi:type="ns2:EfficiencyConstant" percent="97.5"/>
            </ns3ns2:inverter>
            <ns3<ns2:losses acdc="15.5" dcac="51.5"/>
        </ns3ns2:system>
    </ns4ns3:site>
    <ns4<ns3:irradiation>
        <ns4<ns3:reference>
            <ns4<ns3:Ghm monthly="3331.9 50.2 96 12597.6 126.8 158.7 168 165 150 100 66 34 24169.3 166.4 153.5 103.2 66.7 34.0 24.0" yearly="11691182.3"/>
            <ns4<ns3:Ghd monthly="1.0503 1.8079 3.0815 4.1623 5.1112 5.5964 5.3237 4.8595 3.3544 2.1215 1.1213 0.7877" yearly="3.2024"/>
            <ns4<ns3:Dhd monthly="0.6157 0.9892 1.6147 2.1305 2.6150 2.8076 2.6965 2.3226 1.7067 1.1410 0.6966 0.4846" yearly="1.6559"/>
            <ns4<ns3:Td monthly="-1.89 -0.42 4.15 10.4 15.1 1519.50 1820.6 20.51 1914.9 149.5 94.4 3.9 -10.26" yearly="9.57"/>
            <ns4<ns3:Tmin monthly="-3.76 -2.3.1 0.98 65.5 1110.1 13.98 15.93 1514.68 1110.26 6.31 12.75 -21.9"/>
            <ns4<ns3:Tmax monthly="10.46 3.85 8.86 15.50 2019.97 23.95 25.83 25.83 2019.38 14.60 7.64 1.65"/>
       </ns4:reference>     <ns3:invar monthly="-1.0 -1.0  <ns4:inplane>
          <ns4:Gim monthly="63 82 126 139 155 155 157 160 124 98 58 48" yearly="1365"/>-1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0" yearly="-1.0"/>
            <ns4<ns3:GidRh monthly="283.050 277.920 467.080 461.630 464.990 564.170 564.060 565.170 472.120 378.170 185.930 185.540" yearly="372.740"/>
            <ns4<ns3:DidPwat monthly="81.0 84.730 190.100 1123.700 2175.100 2229.440 2258.560 2253.490 2197.280 1155.750 1123.260 092.78 0.57" yearly="1155.650"/>
            <ns4<ns3:RidDnim monthly="051.026 066.036 0107.063 110.0 124.088 129.0.09 0127.10 0.10 0135.092 099.067 079.045 045.023 038.011" yearly="01114.062"/>
          <ns4  <ns3:ShLossDnid monthly="01.566 02.138 03.046 03.067 04.003 04.030 04.010 04.036 03.032 02.57 1 0.51 1 0.423" yearly="03.105"/>
       </ns4:inplane>        <ns4:comparison>
          <ns4:horizontal percentOpt="84.9" yearlySum="1169.0"/><ns3:Alb monthly="0.22 0.21 0.14 0.16 0.18 0.18 0.17 0.17 0.17 0.16 0.14 0.16" yearly="0.17"/>
            <ns4<ns3:optimumWs percentOptmonthly="1002.0" yearlySum="1377.0"/>
          <ns4:tracker2x percentOpt="126.0" yearlySum="1735.0"1 2.3 2.6 2.6 2.4 2.3 2.1 2.0 2.2 2.1 2.0 2.0" yearly="2.2"/>
          <ns4  <ns3:selectedPrec percentOptmonthly="9938.1" yearlySum="1365.0"/>
       </ns4:comparison>
       <ns4:optimum fixed="37.0"/>9 42.9 45.7 72.9 104.3 103.2 123.0 97.0 72.8 58.8 53.5 44.3" yearly="857.2"/>
        </ns4ns3:irradiation>
reference>
   <ns4:calculation>     <ns3:inplane>
  <ns4:output>           <ns4<ns3:EsmGim monthly="54 69 104 110 120 119 119 122 97 79 48 4164.0 84.0 132.9 142.5 156.3 158.2 159.9 165.4 129.3 102.0 61.0 48.9" yearly="10861404.4"/>
            <ns4<ns3:EsdGid monthly="1.76 2.4906 3.3700 34.6929 34.8876 35.9704 3.85 3.955.27 5.16 5.34 4.31 3.2428 2.5702 1.61 1.3258" yearly="23.9885"/>
            <ns4<ns3:EtmDid monthly="55 70 104 111 120 119 119 122 97 80 48 410.69 1.05 1.58 2.04 2.34 2.53 2.46 2.24 1.74 1.23 0.77 0.55" yearly="10871.60"/>
            <ns4<ns3:EshareRid monthly="50.03 0.06 60.407 90.610 100.214 110.115 100.914 11.0 11.313 80.909 70.305 40.402 30.802" yearly="1000.008"/>
            <ns4<ns3:PRShLoss monthly="850.65 850.5 0 82.86 790.86 770.97 760.86 760.16 760.6 780.6 800.96 830.16 850.26" yearly="790.6"/>
        </ns4ns3:output>inplane>
        <ns4<ns3:losses>comparison>
            <ns4<ns3:globalhorizontal PRcyearlySum="1001182.0" PRppercentOpt="100.0" output="136683.8"/>
          <ns4  <ns3:terrainoptimum PRcyearlySum="991410.90" PRppercentOpt="99100.9" lossAbs="-1" lossRel="-0.1" output="1365"/>0"/>
            <ns3:tracker2x yearlySum="1659.0" percentOpt="117.7"/>
            <ns4<ns3:angularselected PRcyearlySum="971404.0" PRppercentOpt="97.1" lossAbs="-40" lossRel="-2.9" output="132599.6"/>
          <ns4:conversion PRc="88.5" PRp="91.2" lossAbs="-116" lossRel="-8.8" output="1209"/>
  </ns3:comparison>
        <ns3:optimum fixed="32.0"/>
    </ns3:irradiation>
    <ns3:calculation>
       <ns4:dcLoss PRc="83.7" PRp="94.5" lossAbs="-66" lossRel="-5.5" output="1143"/> <ns3:output>
              <ns4<ns3:inverterEsm PRcmonthly="81.6" PRp="97.5" lossAbs="-29" lossRel="-2.5" output="1114"/>58.7 74.8 113.9 117.7 126.3 125.8 126.5 131.4 106.3 87.4 54.4 45.0" yearly="1168.2"/>
            <ns4<ns3:acLossEsd PRcmonthly="801.4" PRp="98.6" lossAbs="-16" lossRel="-1.4" output="1098"/>89 2.67 3.67 3.92 4.07 4.19 4.08 4.24 3.54 2.82 1.81 1.45" yearly="3.20"/>
            <ns4<ns3:availabilityEtm PRcmonthly="79.6" PRp="99.0" lossAbs="-11" lossRel="-159.0 75.0 114.0 118.0 126.0 126.0 126.0 131.0 106.0 87.0 54.0 45.0" outputyearly="10871168.0"/>
          <ns4:total PRc  <ns3:Eshare monthly="795.0 6" lossAbs="-279" lossRel="-20.4" output="1087"/>
       </ns4:losses>.4 9.8 10.1 10.8 10.8 10.8 11.2 9.1 7.5 4.7 3.9" yearly="100.0"/>
       </ns4:calculation>     <ns4<ns3:summary>PV system: 1.0 kWp, crystalline silicon, fixed roof, azim. 175&amp;deg; (south), inclination 45&amp;deg;</ns4:summary>
</ns4:calculateResponse>
PR monthly="91.2 88.5 85.2 82.1 80.3 79.0 78.6 79.0 81.7 85.2 88.7 91.6" yearly="82.7"/>
        </ns3:output>
        <ns3:losses>
            <ns3:global output="1413" PRp="100.0" PRc="100.0"/>
            <ns3:terrain output="1404" lossAbs="-9" lossRel="-0.64" PRp="99.4" PRc="99.4"/>
            <ns3:angular output="1363" lossAbs="-41" lossRel="-2.92" PRp="97.1" PRc="96.5"/>
            <ns3:conversion output="1300" lossAbs="-63" lossRel="-4.62" PRp="95.4" PRc="92.0"/>
            <ns3:dcLoss output="1229" lossAbs="-71" lossRel="-5.46" PRp="94.5" PRc="87.0"/>
            <ns3:inverter output="1198" lossAbs="-31" lossRel="-2.52" PRp="97.5" PRc="84.8"/>
            <ns3:acLoss output="1180" lossAbs="-18" lossRel="-1.5" PRp="98.5" PRc="83.5"/>
            <ns3:availability output="1168" lossAbs="-12" lossRel="-1.02" PRp="99.0" PRc="82.7"/>
            <ns3:total output="1168" lossAbs="-245" lossRel="-17.34" PRc="82.7"/>
        </ns3:losses>
    </ns3:calculation>
    <ns3:summary>PV system: 1.0 kWp, crystalline silicon, fixed roof, azim. 175&amp;deg; (south), inclination 45&amp;deg;</ns3:summary>
</ns3: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 38

New Version Current

Key

LTA API

XML Schemas

Requext XML

Response XML

Curl request form (bash)