Solar Radiation Forecast
Provide solar radiation forecasts and related data at 15-minute intervals for any location worldwide, up to 60 hours ahead, with a spatial resolution of 1×1 km.
Endpoint
/solarradiation/v1/forecast/{latitude}/{longitude}
Parameters
Path parameters
-
latitude(required)The latitude of the desired location. Decimal format, up to 2 decimal places. For example39.92 -
longitude(required)The longitude of the desired location. Decimal format, up to 2 decimal places. For example116.41
Query parameters
-
hoursForecast hours, supports 1-60 hours, default is24. For example:hours=12 -
intervalInterval of forecast data, supports15,30,60minutes, default is60. For example:interval=15 -
tiltThe tilt angle of the PV system (range 0-90, integer). Required whenextra=poa. For example:tilt=30 -
azimuthThe azimuth angle of the PV system (range 0-359, integer, 0 = North). Required whenextra=poa. For example:azimuth=180 -
extraAdditional information provided for the current solar radiation forecast, optionalweather(basic weather data) andpoa(plane of array irradiance, must pass bothtiltandazimuth), multiple items are separated by commas. For example:extra=weather
Request example
curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/solarradiation/v1/forecast/50.11/8.68'Replace your_token and your_api_host with your JWT Authentication and API Host
Response
The response is in JSON format and is Gzip compressed.
{
"metadata": {
"tag": "c4ca4238a0b923820dcc509a6f75849b"
},
"forecasts": [
{
"forecastTime": "2023-10-15T11:30Z",
"solarAngle": {
"azimuth": 184,
"elevation": 40
},
"dni": {
"value": 25.16,
"unit": "W/m²"
},
"dhi": {
"value": 136.29,
"unit": "W/m²"
},
"ghi": {
"value": 152.57,
"unit": "W/m²"
},
"weather": {
"temperature": {
"value": 18.6,
"unit": "°C"
},
"windSpeed": {
"value": 2.78,
"unit": "m/s"
},
"humidity": 76
},
"poa": {
"global": {
"value": 134.39,
"unit": "W/m²"
},
"direct": {
"value": 9.35,
"unit": "W/m²"
},
"diffuse": {
"value": 125.04,
"unit": "W/m²"
},
"reflected": {
"value": 1.52,
"unit": "W/m²"
}
}
},
{
"forecastTime": "2023-10-15T11:45Z",
"solarAngle": {
"azimuth": 189,
"elevation": 40
},
"dni": {
"value": 20.71,
"unit": "W/m²"
},
"dhi": {
"value": 132.14,
"unit": "W/m²"
},
"ghi": {
"value": 145.47,
"unit": "W/m²"
},
"weather": {
"temperature": {
"value": 18.27,
"unit": "°C"
},
"windSpeed": {
"value": 2.98,
"unit": "m/s"
},
"humidity": 76
},
"poa": {
"global": {
"value": 128.26,
"unit": "W/m²"
},
"direct": {
"value": 7.28,
"unit": "W/m²"
},
"diffuse": {
"value": 120.98,
"unit": "W/m²"
},
"reflected": {
"value": 1.45,
"unit": "W/m²"
}
}
},
{
"forecastTime": "2023-10-15T12:00Z",
"solarAngle": {
"azimuth": 194,
"elevation": 40
},
"dni": {
"value": 15.58,
"unit": "W/m²"
},
"dhi": {
"value": 127.72,
"unit": "W/m²"
},
"ghi": {
"value": 137.65,
"unit": "W/m²"
},
"weather": {
"temperature": {
"value": 17.94,
"unit": "°C"
},
"windSpeed": {
"value": 3.17,
"unit": "m/s"
},
"humidity": 76
},
"poa": {
"global": {
"value": 121.85,
"unit": "W/m²"
},
"direct": {
"value": 5.14,
"unit": "W/m²"
},
"diffuse": {
"value": 116.72,
"unit": "W/m²"
},
"reflected": {
"value": 1.37,
"unit": "W/m²"
}
}
},
{
"forecastTime": "2023-10-15T12:15Z",
"solarAngle": {
"azimuth": 198,
"elevation": 39
},
"dni": {
"value": 10.1,
"unit": "W/m²"
},
"dhi": {
"value": 124.08,
"unit": "W/m²"
},
"ghi": {
"value": 130.43,
"unit": "W/m²"
},
"weather": {
"temperature": {
"value": 17.63,
"unit": "°C"
},
"windSpeed": {
"value": 3.3,
"unit": "m/s"
},
"humidity": 76
},
"poa": {
"global": {
"value": 118.87,
"unit": "W/m²"
},
"direct": {
"value": 3.1,
"unit": "W/m²"
},
"diffuse": {
"value": 115.77,
"unit": "W/m²"
},
"reflected": {
"value": 1.3,
"unit": "W/m²"
}
}
}
]
}
-
metadata.tagUnique tag for this data -
forecasts.forecastTimeForecast time, ISO8601 format -
forecasts.solarAngle.azimuthSolar azimuth angle, 0 degree for North, increasing clockwise -
forecasts.solarAngle.elevationSolar elevation angle -
forecasts.dni.valueDirect normal irradiance value -
forecasts.dni.unitDirect normal irradiance unit,Watt per square meter -
forecasts.dhi.valueDiffuse horizontal irradiance value -
forecasts.dhi.unitDiffuse horizontal irradiance unit, Watt per square meter -
forecasts.ghi.valueGlobal horizontal irradiance value -
forecasts.ghi.unitGlobal horizontal irradiance unit, Watt per square meter -
forecasts.weather.temperature.valueTemperature value -
forecasts.weather.temperature.unitTemperature unit, Celsius -
forecasts.weather.windSpeed.valueWind speed value -
forecasts.weather.windSpeed.unitWind speed unit, meter per second -
forecasts.weather.humidityRelative humidity in percent -
forecasts.poa.global.valuePlane of array global irradiance value -
forecasts.poa.global.unitPlane of array global irradiance unit, Watt per square meter -
forecasts.poa.direct.valuePlane of array direct irradiance value -
forecasts.poa.direct.unitPlane of array direct irradiance unit, Watt per square meter -
forecasts.poa.diffuse.valuePlane of array diffuse irradiance value -
forecasts.poa.diffuse.unitPlane of array diffuse irradiance unit, Watt per square meter -
forecasts.poa.reflected.valuePlane of array ground-reflected irradiance value -
forecasts.poa.reflected.unitPlane of array ground-reflected irradiance unit, Watt per square meter