Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

  • 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
xmlxml
<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
xmlxml
<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"/>
             <ns3:degradation>0.0</ns3:degradation><ns2:inverter>
           </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 24" yearly="1169"/>169.3 166.4 153.5 103.2 66.7 34.0 24.0" yearly="1182.3"/>
            <ns3:Ghd monthly="1.03 1.79 3.15 4.23 5.12 5.64 5.37 4.95 3.44 2.15 1.13 0.77" yearly="3.24"/>
            <ns3:Dhd monthly="0.57 0.92 1.47 2.05 2.50 2.76 2.65 2.26 1.67 1.10 0.66 0.46" yearly="1.59"/>
            <ns3:Td monthly="-1.9 0.2 4.5 10.4 15.1 19.0 20.6 20.1 14.9 9.5 4.4 -0.6" yearly="9.7"/>
            <ns3:Tmin monthly="-3.6 -2.3 0.8 5.5 10.1 13.8 15.3 14.8 10.6 6.1 2.5 -1.9"/>
            <ns3:Tmax monthly="0.6 3.5 8.6 15.0 19.7 23.5 25.3 25.3 19.8 14.0 7.4 1.5"/>
            <ns3:invar monthly="-1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0 -1.0" yearly="-1.0"/>
            <ns3:Rh monthly="83.0 77.0 67.0 61.0 64.0 64.0 64.0 65.0 72.0 78.0 85.0 85.0" yearly="72.0"/>
            <ns3:Pwat monthly="81.0 84.0 90.0 123.0 175.0 229.0 258.0 253.0 197.0 155.0 123.0 92.0" yearly="155.0"/>
            <ns4<ns3:GhdDnim monthly="151.056 166.806 107.3.08 4110.160 5124.118 5129.590 5127.320 4135.852 399.357 279.125 145.123 038.781" yearly="31114.202"/>
          <ns4  <ns3:DhdDnid monthly="0.61 0.98 1.61 2.13 2.61 2.80 2.69 2.32 1.70 1.14 0.69 0.481.66 2.38 3.46 3.67 4.03 4.30 4.10 4.36 3.32 2.57 1.51 1.23" yearly="13.6505"/>
            <ns4<ns3:TdAlb monthly="-10.822 -0.421 40.114 100.116 150.518 0.18.6 200.517 190.917 140.517 90.416 30.914 -10.216" yearly="90.517"/>
            <ns4<ns3:TminWs monthly="-3.7 -32.1 02.93 2.6 2.56 112.14 132.93 152.91 152.60 112.2 2.1 62.30 12.7 -0" yearly="2.92"/>
          <ns4  <ns3:TmaxPrec 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"/>38.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:reference>
        <ns4<ns3:inplane>
            <ns4<ns3:Gim monthly="63 82 126 139 155 155 157 160 124 98 58 4864.0 84.0 132.9 142.5 156.3 158.2 159.9 165.4 129.3 102.0 61.0 48.9" yearly="13651404.4"/>
            <ns4<ns3:Gid monthly="2.0506 23.9200 4.0829 4.6376 45.9904 5.1727 5.0616 5.1734 4.1231 3.1728 12.9302 1.5458" yearly="3.7485"/>
          <ns4  <ns3:Did monthly="0.7369 1.1005 1.7058 2.1004 2.4434 2.5653 2.4946 2.2824 1.7574 1.2623 0.7877 0.5755" yearly="1.6560"/>
            <ns4<ns3:Rid monthly="0.0203 0.0306 0.0607 0.0810 0.0914 0.1015 0.1014 0.0913 0.0609 0.0405 0.02 0.0102" yearly="0.0608"/>
          <ns4  <ns3:ShLoss monthly="0.5 0.15 0.06 0.06 0.07 0.06 0.06 0.06 0.06 0.16 0.16 0.46" yearly="0.16"/>
        </ns4ns3:inplane>
        <ns4<ns3:comparison>
          <ns4  <ns3:horizontal percentOptyearlySum="841182.90" yearlySumpercentOpt="116983.08"/>
            <ns4<ns3:optimum percentOptyearlySum="1001410.0" yearlySumpercentOpt="1377100.0"/>
            <ns4<ns3:tracker2x percentOptyearlySum="1261659.0" yearlySumpercentOpt="1735117.07"/>
            <ns4<ns3:selected percentOptyearlySum="991404.10" yearlySumpercentOpt="136599.06"/>
        </ns4ns3:comparison>
        <ns4<ns3:optimum fixed="3732.0"/>
    </ns4ns3:irradiation>
    <ns4<ns3:calculation>
        <ns4<ns3:output>
          <ns4  <ns3:Esm monthly="54 69 104 110 120 119 119 122 97 79 48 4158.7 74.8 113.9 117.7 126.3 125.8 126.5 131.4 106.3 87.4 54.4 45.0" yearly="10861168.2"/>
            <ns4<ns3:Esd monthly="1.7689 2.4967 3.3767 3.6992 34.8807 34.9719 34.8508 34.9524 3.2454 2.5782 1.6181 1.3245" yearly="23.9820"/>
            <ns4<ns3:Etm monthly="55 70 104 111 120 119 119 122 97 80 48 4159.0 75.0 114.0 118.0 126.0 126.0 126.0 131.0 106.0 87.0 54.0 45.0" yearly="10871168.0"/>
            <ns4<ns3:Eshare monthly="5.0 6.4 9.68 10.21 1110.18 10.98 1110.08 11.32 89.91 7.35 4.47 3.89" yearly="100.0"/>
            <ns4<ns3:PR monthly="85.691.2 88.5 85.02 82.81 7980.83 7779.90 7678.86 7679.10 76.6 78.6 80.9 83.1 85.281.7 85.2 88.7 91.6" yearly="7982.67"/>
        </ns4ns3:output>
        <ns4<ns3:losses>
            <ns4<ns3:global PRcoutput="100.01413" PRp="100.0" outputPRc="1366100.0"/>
          <ns4  <ns3:terrain PRcoutput="99.91404" PRplossAbs="99.-9" lossAbslossRel="-10.64" lossRelPRp="-099.14" outputPRc="136599.4"/>
            <ns4<ns3:angular PRcoutput="97.01363" PRplossAbs="97.1-41" lossAbslossRel="-402.92" lossRelPRp="-297.91" outputPRc="132596.5"/>
          <ns4  <ns3:conversion PRcoutput="88.51300" PRplossAbs="91.2-63" lossAbslossRel="-1164.62" lossRelPRp="-895.84" outputPRc="120992.0"/>
            <ns4<ns3:dcLoss PRcoutput="83.71229" PRplossAbs="94.5-71" lossAbslossRel="-665.46" lossRelPRp="-594.5" outputPRc="114387.0"/>
            <ns4<ns3:inverter PRcoutput="81.6" PRp="97.51198" lossAbs="-2931" lossRel="-2.52" PRp="97.5" outputPRc="111484.8"/>
            <ns4<ns3:acLoss PRcoutput="80.41180" PRplossAbs="98.6-18" lossAbslossRel="-161.5" lossRelPRp="-198.45" outputPRc="109883.5"/>
          <ns4  <ns3:availability PRc="79.6" PRpoutput="99.01168" lossAbs="-1112" lossRel="-1.02" PRp="99.0" outputPRc="108782.7"/>
            <ns4<ns3:total PRcoutput="79.61168" lossAbs="-279245" lossRel="-2017.434" outputPRc="108782.7"/>
        </ns4ns3:losses>
    </ns4ns3:calculation>
    <ns4<ns3:summary>PV system: 1.0 kWp, crystalline silicon, fixed roof, azim. 175&amp;deg; (south), inclination 45&amp;deg;</ns4ns3:summary>
</ns4ns3:calculateResponse>

Curl request equivalent:

...

Curl request form (bash)
Code Block
collapselanguagetruebash
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

...