o

Table of Contents |
---|

# Overview of Solargis API

...

Current spatial coverage of satellite data available through the API. Click image to enlarge:

Orange regions on the map are accessible via the API and data is updated every day (DAY-1 is available). In the subset of these regions, the real-time and nowcasting data is available (within the current day DAY+0, updated every 30 minutes). Main data parameters include GHI, DNI, DIF, GTI, PVOUT.

...

satellite region (from left to right as on the map) | data since | local DAY-1 is available at | real-time and nowcasting | original satellite scanning frequency |

GOES-W (America and Pacific) | 1999-01-01 | 13:30 UTC | planned | 10 min. (30 min. old GOES-W) |

GOES-E (America) | 1999-01-01 | 10:00 UTC | 15 min. resolution, 0-4 5 hours aheadaffected, data updated every 30 min., shipping by FTP every 1 hour | 15 min. (30 min. old GOES-E) |

MSG/MFG PRIME (Europe and Africa) | 1994-01-01 | 03:45 UTC | 15 min. resolution, 0-4 5 hours ahead affected, data updated every 30 min., shipping by FTP every 1 hour | 15 min. (30 min. old MFG PRIME before 2005) |

MSG/MFG IODC (Middle East, Central and South Asia) | 1999-01-01 | 22:40 UTC | 15 min. resolution, 0-4 5 hours ahead affected, data updated every 30 min., shipping by FTP every 1 hour | 15 min. (30 min. old MFG IODC before Feb 2017) |

HIMAWARI/MTSAT (Asia and Pacific) | 2006-07-01 | 22:40 UTC | 10 min. resolution, 0-4 5 hours ahead affected, data updated every 30 min., shipping by FTP every 1 hour | 10 min. (30 min. old MTSAT before 2016) |

...

parameter | description |
---|---|

GHI | Global Horizontal Irradiation [kWh/m2, Wh/m2 resp. W/m2] |

GHI_C | Clear-sky Global Horizontal Irradiation [kWh/m2, Wh/m2 resp. W/m2] |

GHI_UNC_HIGH | GHI high estimate (10 % prob. of exceedance) [kWh/m2, Wh/m2 resp. W/m2] |

GHI_UNC_LOW | GHI low estimate (90 % prob. of exceedance) [kWh/m2, Wh/m2 resp. W/m2] |

DNI | Direct Normal Irradiation [kWh/m2, Wh/m2 resp. W/m2] |

DNI_C | Clear-sky Direct Normal Irradiation [kWh/m2, Wh/m2 resp. W/m2] |

DIF | Diffuse Horizontal Irradiation [kWh/m2, Wh/m2 resp. W/m2] |

GTI | Global Tilted Irradiation [kWh/m2, Wh/m2 resp. W/m2] |

GTI_UNC_HIGH | GTI high estimate (10 % prob. of exceedance) [kWh/m2, Wh/m2 resp. W/m2] |

GTI_UNC_LOW | GTI low estimate (90 % prob. of exceedance) [kWh/m2, Wh/m2 resp. W/m2] |

GTI_C | Global tilted clear-sky irradiance [W/m2] |

CI_FLAG | Cloud identification quality flag [categories], this parameter is presented 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 resp. 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, resp. kWh] |

PVOUT_UNC_HIGH | PVOUT high estimate (10 % prob. of exceedance) [kW, resp. kWh] |

PVOUT_UNC_LOW | PVOUT low estimate (90 % prob. of exceedance) [kW, resp. kWh] |

SWESDWE | 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] - no data for 4 most recent months, source ERA5 |

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 |

...

element name | geometry |
---|---|

defined in | http://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" axisDeviationazimuth="0180"/> <pv:geometry xsi:type="pv:GeometryOneAxisInclinedNS" axisTilt="30" rotationLimitEast="-90" rotationLimitWest="90" backTracking="true" axisDeviationazimuth="0180"/> <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"/> |

content | none |

@type* | required, concrete type of given geometry. Use one from GeometryFixedOneAngle, GeometryOneAxisHorizontalNS, GeometryOneAxisInclinedNS, GeometryOneAxisVertical, GeometryTwoAxisAstronomical, see table below |

@azimuth | the value in degrees of a true geographical azimuth (0: north, 90: east, 180: south, 270: west, 360: north --> a compass value) . In the case of 'GeometryFixedOneAngle' the azimuth attribute is required. In the case of two tracker types (GeometryOneAxisHorizontalNS, GeometryOneAxisInclinedNS) the value is the compass value at which the |

@tilt | tilt of panel surface in degrees range (0, 90), 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 applicable for 'GeometryOneAxisInclinedNS', WARNING: if this attribute is missing, the value defaults to 30 degree. |

@rotationLimitEast | optional, default is the unlimited motion in the range (-180, 180), used for all trackers. The general rule is: negative value is used for the east side, positive for the west side, the same rule applies for both Earth hemispheres). The meaning is slightly different for different types of tracker: GeometryOneAxisHorizontalNS: rotation limits are defined as tilt of tracker table relative to its central position (which is horizontal=0 deg.), both limits are typically symmetric, e.g., rotationLimitEast=-50, rotationLimitWest=50 GeometryOneAxisInclinedNS: rotation limits are defined as tilt of tracker table relative to its central position (in this case the inclined plane defined by axisTilt attribute), both limits are typically symmetric, e.g., rotationLimitEast=-50, rotationLimitWest=50 GeometryOneAxisVertical: rotation limits are defined relative to 0 deg. (initial tracker position regardless of hemisphere), default range from -180 to 180 deg (-90 deg. east and +90 deg. west) GeometryTwoAxisAstronomical: definition (for vertical axis) is the same as with GeometryOneAxisVertical tracker |

@rotationLimitWest | optional, westward motion limit, described above |

@tiltLimitMin | optional, only used with the horizontal axis of 'GeometryTwoAxisAstronomical' tracker. Limit is defined in the range of degrees (-90, +90), relative to the horizontal position of the tracking surface (0 deg.). Example: tiltLimitMin="0" tiltLimitMax="60", the tracker follows the sun elevation in the range from horizontal position to 60 degree of tilt. |

@tiltLimitMax | optional, max tilt of the tracking surface, described above |

@backTracking | optional boolean value, default is 'false' - tracker moves freely regardless of the neighbors, value is 'true' - tracker moves in the way it avoids shading from neighboring tracker constructions. |

...