Child pages
  • DataDelivery WS: request / response examples

Versions Compared

Key

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

Table of Contents

WSDL location

...

Production environment: https://solargis.info/ws/soap/dataDeliveryWebService.wsdl

DataDelivery dataDelivery

Web service access to DataDelivery "dataDelivery" functionality, available via POST method toREST endpoint: https://solargis.info/ws/dataDelivery/rest/datadelivery/request?key=demo

XML Schemas

Tip

Technical schema documentation is available here

Requext XML showing the most options with comments

This request can be used with "demo" API key. More examples can be found here: Solargis API User Guide#WebServices

Code Block
xml
languagexml

<ws:dataDeliveryRequest dateFrom="20112015-0107-01" dateTo="20112015-07-01-30"
	    xmlns="http://geomodel.eu/schema/data/request"
	    xmlns:ws="http://geomodel.eu/schema/ws/data"
	    xmlns:geo="http://geomodel.eu/schema/common/geo"
 	   xmlns:pv="http://geomodel.eu/schema/common/pv"
 	   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	
	     
    <site id="site1dummysite_1" name="FirstTest site" lat="48.61259" lng="20.827079">
		        <geo:terrain elevation="111" azimuth="112" tilt="11"/> 		<!--azimuth and tilt of terrain has only effect to PVOUT in case of GeometryFixedOneAngle geometry-->
        <geo:horizon>0:31.6 123:29.6 123.5:28 7192.5:323.6 15193:723.4 22206.5:0<23.2 207:28.4 359.5:25.4</geo:horizon> 		<!--colon delimited pairs of sun azimuth vs. sun elevation, in degrees-->
        <!-- value of the horizon element is obtainable/viewable from/in pvPlanner application - horizon editor widget -->
        <pv:geometry xsi:type="pv:GeometryFixedOneAngle" azimuth="165" tilt="22"/>
		<pv:system installationType="FREE_STANDING" dateStartup="2011-06-01" availability="99">
			<pv:module type="ASI" count="10" nominalPower="560">
				<pv:degradation>3</pv:degradation>
				        <!-- one axis horizontal tracker: <pv:geometry xsi:type="pv:GeometryOneAxisHorizontalNS" rotationLimitEast="-90" rotationLimitWest="90" backTracking="true"/>-->
        <!-- one axis inclined tracker: <pv:geometry xsi:type="pv:GeometryOneAxisInclinedNS" axisTilt="30" rotationLimitEast="-90" rotationLimitWest="90" backTracking="false"/>-->
        <!-- one vertical axis tracker: <pv:geometry xsi:type="pv:GeometryOneAxisVertical" tilt="25" rotationLimitEast="-180" rotationLimitWest="180" backTracking="true"/>-->
        <!--     vertical axis rotation limits are defined relative to 0 deg. (initial tracker position) from -180 to 180 deg with -90 deg.=east and +90 deg.=west, regardless of hemisphere-->
        <!-- two axis tracker: <pv:geometry xsi:type="pv:GeometryTwoAxisAstronomical" rotationLimitEast="-180" rotationLimitWest="180" tiltLimitMin="10" tiltLimitMax="60" backTracking="true"/>-->
        <pv:system installedPower="1000" installationType="FREE_STANDING" selfShading="false" dateStartup="2011-06-01">
        <!--switch on selfShading attribute and switch off back-tracking to determine the impact (losses) due to inter-row shading on PVOUT -->
            <pv:module type="CSI">
                <pv:degradation>3</pv:degradation>
                <pv:degradationFirstYear>8</pv:degradationFirstYear>
				                <pv:surfaceReflectance>0.13<16</pv:surfaceReflectance>
				                <!--<pv:powerTolerance low="10" high="90"/>
				-->
                <pv:nominalOperatingCellTemp>15</pv:nominalOperatingCellTemp>
				                <!--<pv:openCircuitVoltageCoeff>7</pv:openCircuitVoltageCoeff> 				not supported
                <pv:shortCircuitCurrentCoeff>4</pv:shortCircuitCurrentCoeff> 				not supported-->
                <pv:PmaxCoeff>10</pv:PmaxCoeff>
			            </pv:module>
			            <!--<pv:inverter count="2" interconnection="PARALLEL"> 				<pv:not supported-->
            <pv:inverter>
            	 <pv:startPower>10</pv:startPower>
                <pv:efficiency xsi:type="pv:EfficiencyConstant" percent="94"/>
				<pv:startPower>10</pv:startPower>
				<pv:limitationACPower>5</pv:limitationACPower>
				                <!--<pv:efficiency xsi:type="pv:EfficiencyCurve" dataPairs="0:20 50:60 100:80 150:90 233:97.5 350:97 466:96.5 583:96 700:95.5 750:93.33 800:87.5 850:82.35 900:77.8 950:73.7"/>-->
                <!--by using efficiency curve, we can model also clipping losses - having efficiency above certain power limit declining -->
                <pv:limitationACPower>900</pv:limitationACPower>  <!-- clipping can be defined here or via eff. curve -->
                <!--<pv:nominalDCPower>8</pv:nominalDCPower> 			not supported-->
            </pv:inverter>
			            <pv:losses>
				<pv:acLosses cables="1" transformer="2.1"/>
				            	 <!--for dcLosses enter either monthlySnowPollution 12 monthly % numbers or snowPollution as one % number-->
                <pv:dcLosses cables="1.2" mismatch="0.65" snowPollution="72.5" monthlySnowPollution="45 5.2 3 41 51 71 81 41 71 1 2 4"/>
5 1"/>
			                <pv:acLosses cables="1" transformer="2.1"/>
            </pv:losses>
			            <pv:topology xsi:type="pv:TopologySimpleTopologyRow" relativeSpacing="2.5" type="_1UNPROPORTIONAL1"/>
            <!-- for trackers use column spacing: <pv:topology xsi:type="pv:TopologyColumn" relativeSpacing="12.5" type="UNPROPORTIONAL2"/>
		<-->
            <!--with vertical axis tracker and two-axis trackers, it is assumed constructions equally distributed in both directions, so TopologyColumn is enough to define spacing-->
        </pv:system>
	    </site>
	
	     
    <processing key="GHI DIFGTI DNITEMP PVOUT" summarization="HOURLYDAILY" terrainShading="true"/>
	
</        <timestampType>CENTER</timestampType>
    </processing>
     
</ws:dataDeliveryRequest>

Response XML

Note

Note that rows of response contain mixed date/time formats. This is just for demo purposes while in normal operation only single format will be used for all rows.
The used date/time format is determined by "summarization" specified in request, allowed values are MONTHLY, DAILY, HOURLY, MIN_15


<ns2:dataDeliveryResponse xmlns:ns2
Code Block
xmlxml
Tip
titleMinimum XML request (PVOUT)


Code Block
languagehtml/xml
<ws:dataDeliveryRequest dateFrom="2015-02-15" dateTo="2015-02-15"
        xmlns="http://geomodel.eu/schema/data/request"
        xmlns:ws="http://geomodel.eu/schema/ws/data"
        xmlns:pv="http://geomodel.eu/schema/common/pv"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        
    <site id="site1" lat="48.61259" lng="20.827079">
        <pv:system installedPower="5.6">
            <pv:module type="ASI"/>
            <pv:inverter/>
            <pv:losses/>
        </pv:system>
    </site>
    <processing key="GHI DIF DNI PVOUT" summarization="MIN_15"/>
    
</ws:dataDeliveryRequest>



Tip
titleMinimum XML request (no PVOUT)


Code Block
 <ws:dataDeliveryRequest dateFrom="2015-02-15" dateTo="2015-02-15"
        xmlns="http://geomodel.eu/schema/data/request"
        xmlns:ws="http://geomodel.eu/schema/ws/data">
xmlns:ns3
        
    <site id="site1" lat="48.61259" lng="20.827079"/>
    <processing key="GHI DIF DNI" summarization="MIN_15"/>
    
</ws:dataDeliveryRequest>


Response XML

Code Block
languagehtml/xml
<dataDeliveryResponse xmlns="http://geomodel.eu/schema/commonws/geodata" xmlns:ns4ns2="http://geomodel.eu/schema/common/pvgeo">
   <site <ns2:site id="SITE_1site1dummy" lat="48.061259" lng="1820.0827079">
      <metadata>#HOURLY <ns2:metadata>MONTHLYVALUES SUMS OF SOLAR RADIATION CharacterAND encoding: utf-8
Issued: 2012PV OUTPUT
#
#Issued: 2015-02-2811 1015:0956
Site#
#Site name: Viala, BG
LatitudeFirstsite
#Latitude: 4248.841000612590
Longitude#Longitude: 2720.792500827079
Elevation#Elevation: 72111.0 m a.s.l.
http#http://solargis.info/imaps/#tl=Google:Satellite&amp;loc=4248.841000612590,2720.792500827079&amp;z=14 
#
Output#
#Output from the climate database SolarGIS v1v2.80.1
#
Solar#Solar radiation Descriptiondata
#Description: data calculated from Meteosat MSG and MFG satellite data ((c) 20112015 EUMETSAT) by SolarGIS method
Summarization type: monthly
Summarization period: 01/1994 - 01/2012
Spatial resolution: values represent an area of 250 m x 250 m

Meteorological parameters
Description: spatially disaggregated from CFSR and GFS and from atmospheric data ((c) 20112015 ECMWF and NOAA) by SolarGIS method Summarization
#Summarization type: monthlyhourly
Summarization#Summarization period: 01/199401/2015 - 01/201201/2015
Spatial#Spatial resolution: values represent an area of 1000 250 m
x#
1000#
m#Service 
Service provider: GeoModel Solar s.r.o., M. Marecka 3, Bratislava, Slovakia
Company#Company ID: 45 354 766, VAT Number: SK2022962766
Registration#Registration: Business register, District Court Bratislava I, Section Sro, File 62765/B
http#http://solargis.info, contact@solargis.info
#
Disclaimer#Disclaimer:
Considering#Considering the nature of climate fluctuations, interannual and long-term changes, as well as the uncertainty of measurements and calculations, GeoModel Solar s.r.o. cannot take full guarantee of the accuracy of estimates. The maximum possible has been done for the assessment of climate conditions based on the best available data, software and knowledge. GeoModel Solar s.r.o. shall not be liable for any direct, incidental, consequential, indirect or punitive damages arising or alleged to have arisen out of use of the provided report. This report is copyright to © 2010 GeoModel Solar s.r.o., all rights reserved. data. SolarGIS is a trade mark of GeoModel Solar s.r.o.
#
Copyright#Copyright (c) 20112015 GeoModel Solar s.r.o.
#
#
Columns#Columns:
Year#Date Month- GHId Date of measurement, format DD.MM.YYYY
#Time - AverageTime dailyof sum of global measurement, time reference UTC, time step 60 min, time format HH:MM, center of the averaging interval
#GHI - Global horizontal irradiation [kWhWh/m2], GHImno data value -9
Monthly#DIF sum- ofDiffuse global horizontal irradiation [kWhWh/m2], DIFdno -data Averagevalue daily-9
sum#DNI of- diffuseDirect horizontalnormal irradiation [kWhWh/m2], DIFmno -data Monthlyvalue sum-9
of#PVOUT diffuse- horizontalPV irradiationoutput [kWh/m2]
TEMP - Average diurnal (24 hour) air temperature at 2 m [deg. C]</ns2:metadata>
      <ns2:columns>GHId GHIm DIFd DIFm TEMP</ns2:columns>
      <ns2:row date="1994-01-10+01:00" values="1.698 52.6 0.994 30.8 5.6#
#Data:
Date;Time;GHI;DIF;DNI;PVOUT</metadata>
      <columns>GHI DIF DNI PVOUT</columns>
      <row dateTime="2015-01-01T00:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T01:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T02:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T03:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T04:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T05:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T06:30:00.000Z" values="5.919966280460358 5.390461027622223 10.358650207519531 0.0"/>
      <row dateTime="2015-01-01T07:30:00.000Z" values="68.19317054748535 50.710779666900635 150.0716438293457 0.0"/>
      <row dateTime="2015-01-01T08:30:00.000Z" values="126.30745887756348 94.16604423522949 137.40283393859863 0.0"/>
      <ns2:row <row dateTime="2015-01-01T09:30:00.000Z" values="105.13788652420044 84.07496500015259 74.75265902280807 0.0"/>
      <row dateTime="19942015-0201-12T1001T10:20:00+01:0030:00.000Z" values="93.83942031860352 93.83942031860352 0.0 0.0"/>
      <row dateTime="2015-01-01T11:30:00.000Z" values="1113.92357184791564941 54106.395848846435547 122.25652618885040283 35.3 3.7"0.0"/>
      <row dateTime="2015-01-01T12:30:00.000Z" values="91.86378479003906 83.2255973815918 33.165565490722656 0.0"/>
      <ns2:row<row dateTime="2015-01-01T13:30:00.000Z" values="352.83165634632110596 11851.837733268737793 19.844948320776224136 57.2 7.5" yearMonth="1994-03"0.0"/>
      <row dateTime="2015-01-01T14:30:00.000Z" values="6.830964244902134 6.830964244902134 0.0 0.0"/>
      <row dateTime="2015-01-01T15:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <ns2:row month="4" values="4.227 126.8 2.444 73.3 11.7"<row dateTime="2015-01-01T16:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T17:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T18:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <ns2:row dayOfYear="123" values="6.025 186.8 2.795 86.6 16.8"/>
   </ns2:site>
</ns2:dataDeliveryResponse>
<row dateTime="2015-01-01T19:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T20:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T21:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T22:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
      <row dateTime="2015-01-01T23:30:00.000Z" values="0.0 0.0 0.0 0.0"/>
   </site>
</dataDeliveryResponse>