| Table of Contents |
|---|
...
element name | processing |
|---|---|
defined in | |
description | Complex element with instructions about how response should be generated. |
content | optional one <timeZone>, optional one <timestampType> |
@summarization* | required, time frequency in the response. One of YEARLY, MONTHLY, DAILY, HOURLY, MIN_30, MIN_15, MIN_10, MIN_5 |
@key* | required, text value, output data parameters separated by white space. Example: key="GHI GTI TEMP WS PVOUT". See below table for all supported parameters. |
@terrainShading | optional, boolean, if 'true', the distant horizon taken from SRTM data is considered, default is 'false' (no horizon obstructions at all), Note: a user can also apply custom horizon data by providing <horizon> element within the <site> element |
Data parameters
Table of available data parameters in the XML requestrequests:
parameter | description |
|---|---|
GHI | Global Horizontal Irradiation [kWh/m2, Wh/m2, W/m2]. Regarding units see below note. |
GHI_C | Clear-sky Global Horizontal Irradiation [kWh/m2, Wh/m2, W/m2] |
GHI_UNC_HIGH | GHI high estimate (10 % |
probability of exceedance) [kWh/m2, Wh/m2, W/m2] | |
GHI_UNC_LOW | GHI low estimate (90 % |
probability of exceedance) [kWh/m2, Wh/m2, W/m2] | |
DNI | Direct Normal Irradiation [kWh/m2, Wh/m2, W/m2] |
DNI_C | Clear-sky Direct Normal Irradiation [kWh/m2, Wh/m2, W/m2] |
DIF | Diffuse Horizontal Irradiation [kWh/m2, Wh/m2, W/m2] |
GTI | Global Tilted Irradiation [kWh/m2, Wh/m2, W/m2] |
GTI_UNC_HIGH | GTI high estimate (10 % |
probability of exceedance) [kWh/m2, Wh/m2, W/m2] | |
GTI_UNC_LOW | GTI low estimate (90 % |
probability of exceedance) [kWh/m2, Wh/m2, W/m2] | |
GTI_C | Global tilted clear-sky irradiance [W/m2] |
CI_FLAG | Cloud identification quality flag [categories], this parameter is |
represented as 'flagR' in the response | |
FLAG_R | alias for CI_FLAG |
KTM | Deprecated alias of KC. Can be discontinued in future versions. |
KC | Clear-sky index [unitless] |
KT | clearness index, values range (0, 1.1), during the night -9 |
PAR | Photo-synthetically Active Irradiation [kWh/m2, Wh/m2, W/m2] |
SE | Sun Altitude (Elevation) Angle [deg.] |
SA | Sun Azimuth Angle [deg.] |
TEMP | Air Temperature at 2m [deg. C] |
TD | Dew Point Temperature [deg. C] |
WBT | Wet Bulb Temperature [deg. C] |
AP | Atmospheric Pressure [hPa] |
RH | Relative Humidity [%] |
WS | Wind Speed [m/s] |
WD | Wind Direction [deg.] |
PREC | Precipitation Rate [kg/m2] |
PWAT | Precipitable Water [kg/m2] |
PVOUT | Photovoltaic Output [kW, kWh]. Regarding units see below note. |
PVOUT_UNC_HIGH | PVOUT high estimate (10 % |
probability of exceedance) [kW, kWh] | |
PVOUT_UNC_LOW | PVOUT low estimate (90 % |
probability of exceedance) [kW, kWh] | |
SDWE | Water equivalent of accumulated snow depth [kg/m2] |
SWE | Deprecated alias of SDWE. Can be discontinued in future versions. SDWE will be returned in a response. |
TMOD | Module temperature [deg. C]. This parameter needs a PV system defined in the request. |
WG | Wind Gust [m/s] |
WS100 | Wind speed at 100 m [m/s] |
WD100 | Wind direction at 100 m [deg.] |
SFWE | Water equivalent of fresh snowfall rate [kg/m2/hour] - source ERA5 , the latest data available is approx. one month backward (no data for very recent or forecast period) |
INC | Incidence angle of direct irradiance [deg.], this parameter needs GTI or PVOUT in the request |
TILT | Tilt of inclined surface [deg.], this parameter needs GTI or PVOUT in the request |
ASPECT | Aspect of inclined surface [deg.], this parameter needs GTI or PVOUT in the request |
For detailed parameter description see the /wiki/spaces/public/pages/14975030.
...
| Note |
|---|
Timestamps used in the XML response comply with the ISO 8601 standard for date and time representation https://en.wikipedia.org/wiki/ISO_8601. Time stamps are also aware of time zone (offset from UTC). Time zone designators are appended after the the time part of timestamp string. If the time is in UTC (https://en.wikipedia.org/wiki/Coordinated_Universal_Time), Z is added directly after the time without a space. Z is the zone designator for the zero UTC offset e.g., 2017-09-22T01:00:00.000Z . If there is an offset from UTC, this is designated by appending +/-HH:MM after the timestamp string, e.g., 2017-09-22T01:00:00.000-05:00 (UTC-5). |
...