Data delivery web service API

API Documentation

Contact us and request complete guide to Solargis API.

Request - Response Examples

Standard example (including PVOUT)

Request

<ws:dataDeliveryRequest dateFrom="2014-04-28+01:00" dateTo="2014-04-28+01:00"
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="site1dummy" lat="48.61259" lng="20.827079">
<geo:terrain elevation="111" azimuth="112" tilt="11"/>
<geo:horizon>0:5 7.5:3 15:7 22.5:0</geo:horizon>
<pv:geometry xsi:type="pv:GeometryFixedOneAngle" azimuth="165" tilt="22"/>
<pv:system installedPower="100" installationType="FREE_STANDING" dateStartup="2011-06-01">
<pv:module type="CSI">
<pv:degradation>3</pv:degradation>
<pv:degradationFirstYear>8</pv:degradationFirstYear>
<pv:surfaceReflectance>0.13</pv:surfaceReflectance>
<pv:powerTolerance low="3" high="3"/>
<pv:nominalOperatingCellTemp>44</pv:nominalOperatingCellTemp>
<pv:PmaxCoeff>-0.489</pv:PmaxCoeff>
</pv:module>
<pv:inverter>
<pv:efficiency xsi:type="pv:EfficiencyConstant" percent="94"/>
</pv:inverter>
<pv:losses>
<pv:acLosses cables="1" transformer="2.1"/>
<pv:dcLosses cables="1.2" mismatch="0.65" monthlySnowPollution="4 2 3 4 5 7 8 4 7 4 5 1"/>
</pv:losses>
<pv:topology xsi:type="pv:TopologySimple" relativeSpacing="2.5"/>
</pv:system>
</site>
<processing key="GHI DIF DNI PVOUT" summarization="HOURLY" terrainShading="true">
<timeZone>GMT+1</timeZone>
<timestampType>END</timestampType>
</processing>
</ws:dataDeliveryRequest>

 

Response

<dataDeliveryResponse>
<site id="site1dummy" lat="48.61259" lng="20.827079">
<metadata>
#HOURLY VALUES OF SOLAR RADIATION AND PV OUTPUT
#
#Issued: 2015-11-13 15:06
#
#Site name: Firstsite
#Latitude: 48.612590
#Longitude: 20.827079
#Elevation: 111.0 m a.s.l.
#http://solargis.info/imaps/#tl=Google:satellite&loc=48.612590,20.827079&z=14
#
#
#Output from the climate database SolarGIS v2.0.8
#
#Solar radiation data
#Description: data calculated from Meteosat MSG satellite data ((c) 2015
EUMETSAT) and from atmospheric data ((c) 2015 ECMWF and NOAA) by
SolarGIS method
#Summarization type: hourly
#Summarization period: 28/04/2014 - 28/04/2014
#Spatial resolution: 250 m
#
#
#Service provider: GeoModel Solar s.r.o., M. Marecka 3, Bratislava,
Slovakia
#Company ID: 45 354 766, VAT Number: SK2022962766
#Registration: Business register, District Court Bratislava I, Section
Sro, File 62765/B
#http://solargis.info, contact@solargis.info
#
#Disclaimer:
#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 data.
SolarGIS is a trade mark of GeoModel Solar s.r.o.
#
#Copyright (c) 2015 GeoModel Solar s.r.o.
#
#
#Columns:
#Date - Date of measurement, format DD.MM.YYYY
#Time - Time of measurement, time reference UTC+1, time step 60 min,
time format HH:MM, end of the averaging interval
#GHI - Global horizontal irradiation [Wh/m2], no data value -9
#DIF - Diffuse horizontal irradiation [Wh/m2], no data value -9
#DNI - Direct normal irradiation [Wh/m2], no data value -9
#PVOUT - PV output [kWh]
#
#Data:
Date;Time;GHI;DIF;DNI;PVOUT
</metadata>
<columns>GHI DIF DNI PVOUT</columns>
<row dateTime="2014-04-28T01:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
<row dateTime="2014-04-28T02:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
<row dateTime="2014-04-28T03:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
<row dateTime="2014-04-28T04:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
<row dateTime="2014-04-28T05:00:00.000+01:00" values="12.0 10.0 24.0 0.362"/>
<row dateTime="2014-04-28T06:00:00.000+01:00" values="123.0 61.0 314.0 7.642"/>
<row dateTime="2014-04-28T07:00:00.000+01:00" values="288.0 108.0 512.0 22.836"/>
<row dateTime="2014-04-28T08:00:00.000+01:00" values="472.0 128.0 682.0 39.531"/>
<row dateTime="2014-04-28T09:00:00.000+01:00" values="623.0 146.0 752.0 51.373"/>
<row dateTime="2014-04-28T10:00:00.000+01:00" values="710.0 200.0 694.0 56.572"/>
<row dateTime="2014-04-28T11:00:00.000+01:00" values="734.0 244.0 613.0 56.909"/>
<row dateTime="2014-04-28T12:00:00.000+01:00" values="454.0 283.0 208.0 33.365"/>
<row dateTime="2014-04-28T13:00:00.000+01:00" values="466.0 266.0 253.0 32.947"/>
<row dateTime="2014-04-28T14:00:00.000+01:00" values="677.0 248.0 578.0 48.315"/>
<row dateTime="2014-04-28T15:00:00.000+01:00" values="365.0 231.0 204.0 24.423"/>
<row dateTime="2014-04-28T16:00:00.000+01:00" values="462.0 170.0 579.0 28.702"/>
<row dateTime="2014-04-28T17:00:00.000+01:00" values="296.0 110.0 530.0 13.76"/>
<row dateTime="2014-04-28T18:00:00.000+01:00" values="120.0 61.0 269.0 3.287"/>
<row dateTime="2014-04-28T19:00:00.000+01:00" values="6.0 6.0 4.0 0.08"/>
<row dateTime="2014-04-28T20:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
<row dateTime="2014-04-28T21:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
<row dateTime="2014-04-28T22:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
<row dateTime="2014-04-28T23:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
<row dateTime="2014-04-29T00:00:00.000+01:00" values="0.0 0.0 0.0 0.0"/>
</site>
</dataDeliveryResponse>