Child pages
  • Solargis API User Guide

Versions Compared

Key

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

...

element namedataDeliveryRequest
defined inhttp://solargis.info/schema/ws-data.xsd
descriptionThe root element of the XML request is the <dataDeliveryRequest> with the required attributes 'dateFrom' and 'dateTo' for setting required desired data period in the response. Accepted is the a date string in the form of  ''YYYY-mm-dd" e.g., "2017-09-30". It is assumed UTC (GMT+0 00) time zone for both dates unless otherwise specified by the <timeZone> element of the <processing>. 
contentrequired one <site> , required one <processing>
@dateFrom*start of the data period, ''YYYY-mm-dd"
@dateTo*end of the data period, ''YYYY-mm-dd"

Explanation of the table above: The element name is that what you can see in the XML request. If the element is of simple type, the content is a literal (text or number), otherwise the content can be list of another <element> or none. Attribute of the element is prefixed by '@' character. Required attribute is marked by '*' character.

...

element nameterrain
defined inhttp://solargis.info/schema/datacommon-requestgeo.xsd
descriptionGround terrain characterized by altitude, terrain slope and terrain azimuth. This element can affect the self shading of a fixed-angle PV array.
contentnone
@elevationoptional, meters above the mean see level. If missing, the value will be taken from SRTM terrain database
@azimuthoptional, orientation of tilted terrain in degrees, 0 for North, 180 for South, clockwise, default is 180, has no meaning for a flat terrain
@tiltoptional, slope tilt of terrain in degrees, 0 for flat ground, 90 for vertical surface, default is 0 (flat)


element namehorizon
defined inhttp://solargis.info/schema/common-geo.xsd
descriptionUser can provide custom skyline for expressing distant or close obstruction features (hills, trees, buildings, poles, etc.)
contentString of this form: space-delimited list of float number pairs [azimuth in degrees:0-360]:[horizon height in degrees:0-90], Example: "<geo:horizon>0:3.6 123:5.6 359:6</geo:horizon>"


element namegeometry
defined inhttp://solargis.info/schema/common-pv.xsd
description

Parametrization of PV system mounting type used for calculating GTI and PVOUT. If this element is missing and GTI/PVOUT is requested, flat-lying PV panels are considered (GTI=GHI). Examples:

<pv:geometry xsi:type="pv:GeometryFixedOneAngle" azimuth="180" tilt="25"/>

<pv:geometry xsi:type="pv:GeometryOneAxisHorizontalNS" rotationLimitEast="-90" rotationLimitWest="90" backTracking="true"/>

<pv:geometry xsi:type="pv:GeometryOneAxisInclinedNS" axisTilt="30" rotationLimitEast="-90" rotationLimitWest="90" backTracking="true"/>

<pv:geometry xsi:type="pv:GeometryOneAxisVertical" tilt="25" rotationLimitEast="-180" rotationLimitWest="180" backTracking="true"/>

<pv:geometry xsi:type="pv:GeometryTwoAxisAstronomical" rotationLimitEast="-180" rotationLimitWest="180" tiltLimitMin="10" tiltLimitMax="60" backTracking="true"/>

contentnone
@type*

required, concrete type of given geometry. Use one from GeometryFixedOneAngle, GeometryOneAxisHorizontalNS, GeometryOneAxisInclinedNS, GeometryOneAxisVertical, GeometryTwoAxisAstronomical


@azimuthorientation of tilted panel surface in degrees, 0 for North, 180 for South, clockwise, default is 180, has no meaning for a horizontal surface, required only for GeometryFixedOneAngle type
@tilttilt of panel surface in degrees, 0 = horizontal, 90 = vertical surface, required for GeometryFixedOneAngle and GeometryOneAxisVertical types
@axisTilt

optional, tilt of rotating inclined axis in degrees, 0 = horizontal, 90 = vertical axis, only considered for GeometryOneAxisInclinedNS,

WARNING: missing value defaults to 30 degree.


Table of supported geometries (PV mounting types):

GeometryFixedOneAngle

GeometryOneAxisVertical

GeometryOneAxisInclinedNS

GeometryOneAxisHorizontalNS

GeometryTwoAxisAstronomical

Image Added
Image Added
Image Added
Image Added
Image Added
  • fixed surface described by azimuth and tilt
  • self-shading simulation supported
  • single vertical axis tracking
  • tracks sun azimuth
  • tilted surface
  • rotation limits
  • back-tracking
  • relative column spacing applied
  • self-shading simulation not implemented
  • single inclined axis tracking
  • tracks sun azimuth
  • tilted surface
  • rotation limits
  • back-tracking
  • relative column spacing applied
  • self-shading simulation supported
  • single horizontal axis tracking
  • tracks sun azimuth
  • rotation limits
  • back-tracking
  • relative column spacing applied
  • self-shading simulation supported

  • two axes tracking
  • tracks sun elevation and azimuth
  • rotation limits both axes
  • back-tracking
  • relative column spacing applied
  • self-shading simulation not implemented

To be continued...


Request Examples

...

summarization


FixedOneAngle