Child pages
  • PvPlanner WS: request / response examples
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 24 Next »

WSDL location

Production environment: https://solargis.info/ws/pvPlannerWebService.wsdl

pvPlanner calculate

Web service access to PvPlanner "Calculate" functionality, available in online application: http://solargis.info/pvplanner

XML Schemas

  • ws-pvplanner.xsd - pvPlanner web 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.

Requext 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 userDefined="true">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="roofMounted" availability="99">
			<pv:module type="cSi">
				<pv:degradation>0</pv:degradation>
                        </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

<calculateResponse xmlns="http://geomodel.eu/schema/ws/pvplanner"
	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">
	
	<site lat="48.61259" lng="20.827079">
		<geo:terrain elevation="246" azimuth="176" tilt="3.1" />
		<geo:horizon userDefined="true">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.0"/>
		<pv:system availability="99.0" installationType="roofMounted" installedPower="1.0">
			<pv:module type="cSi">
				<pv:degradation>0.0</pv:degradation>
			</pv:module>
			<pv:inverter>
				<pv:efficiency xsi:type="pv:EfficiencyConstant" percent="97.5"/>
			</pv:inverter>
			<pv:losses ac="1.5" dc="5.5"/>
		</pv:system>
	</site>
	<irradiation>
		<reference>
			<Ghm monthly="31 45 94 134 158 166 172 145 111 66 34 23" yearly="1179"/>
			<Ghd monthly="1.02 1.60 3.03 4.46 5.09 5.52 5.54 4.68 3.69 2.14 1.13 0.74" yearly="3.23"/>
			<Dhd monthly="0.65 1.02 1.72 2.16 2.70 2.92 2.75 2.39 1.74 1.16 0.74 0.50" yearly="1.71"/>
			<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"/>
			<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"/>
			<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"/>
			<invar monthly="13.0 16.1 16.4 19.9 12.6 5.8 14.3 16.2 17.1 17.4 14.7 12.0" yearly="4.8"/>
		</reference>
		<inplane>
			<Gim monthly="57 67 121 150 153 153 164 153 139 99 57 42" yearly="1355"/>
			<Gid monthly="1.84 2.39 3.92 5.00 4.95 5.10 5.28 4.94 4.63 3.19 1.88 1.37" yearly="3.71"/>
			<Did monthly="0.76 1.10 1.80 2.15 2.51 2.65 2.55 2.32 1.83 1.28 0.84 0.59" yearly="1.70"/>
			<Rid monthly="0.02 0.03 0.06 0.08 0.09 0.10 0.10 0.09 0.07 0.04 0.02 0.01" yearly="0.06"/>
			<ShLoss monthly="0.4 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.1 0.4" yearly="0.1"/>
		</inplane>
		<comparison>
			<horizontal percentOpt="85.9" yearlySum="1178.0"/>
			<optimum percentOpt="100.0" yearlySum="1371.0"/>
			<tracker2x percentOpt="125.4" yearlySum="1719.0"/>
			<selected percentOpt="98.9" yearlySum="1356.0"/>
		</comparison>
		<optimum fixed="36.0"/>
	</irradiation>
	<calculation>
		<output>
			<Esm monthly="48 56 100 119 119 117 125 117 109 79 47 36" yearly="1077"/>
			<Esd monthly="1.57 2.02 3.24 3.99 3.85 3.92 4.03 3.78 3.64 2.58 1.57 1.16" yearly="2.95"/>
			<Etm monthly="49 56 100 120 120 118 125 117 109 80 47 36" yearly="1 077"/>
			<Eshare monthly="4.5 5.2 9.3 11.1 11.1 10.9 11.6 10.9 10.1 7.4 4.4 3.4" yearly="100.0"/>
			<PR monthly="85.3 84.3 82.8 79.8 77.9 76.9 76.2 76.6 78.7 80.8 83.1 84.7" yearly="79.4"/>
		</output>
		<losses>
			<global PRc="100.0" PRp="100.0" output="1356"/>
			<terrain PRc="100.0" PRp="100.0" lossAbs="0" lossRel="0.0" output="1356"/>
			<angular PRc="97.0" PRp="97.0" lossAbs="-41" lossRel="-3.0" output="1315"/>
			<conversion PRc="88.4" PRp="91.2" lossAbs="-116" lossRel="-8.8" output="1199"/>
			<dcLoss PRc="83.6" PRp="94.5" lossAbs="-66" lossRel="-5.5" output="1133"/>
			<inverter PRc="81.5" PRp="97.5" lossAbs="-28" lossRel="-2.5" output="1105"/>
			<acLoss PRc="80.2" PRp="98.5" lossAbs="-17" lossRel="-1.5" output="1088"/>
			<availability PRc="79.4" PRp="99.0" lossAbs="-11" lossRel="-1.0" output="1077"/>
			<total PRc="79.4" lossAbs="-279" lossRel="-20.6" output="1077"/>
		</losses>
	</calculation>
	<summary>PV system: 1.0 kWp, crystalline silicon, fixed roof, azim. 175&amp;deg; (south), inclination 45&amp;deg;</summary>
</calculateResponse>
  • No labels