Solar Radiation Forecast

Platform: API

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 example 39.92
longitude(required)The longitude of the desired location. Decimal format, up to 2 decimal places. For example 116.41

Query parameters

hoursForecast hours, supports 1-60 hours, default is 24. For example: hours=12
intervalInterval of forecast data, supports 15, 30, 60 minutes, default is 60. For example: interval=15
tiltThe tilt angle of the PV system (range 0-90, integer). Required when extra=poa. For example: tilt=30
azimuthThe azimuth angle of the PV system (range 0-359, integer, 0 = North). Required when extra=poa. For example: azimuth=180
extraAdditional information provided for the current solar radiation forecast, optional weather (basic weather data) and poa (plane of array irradiance, must pass both tilt and azimuth), 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.tag Unique tag for this data
forecasts.forecastTime Forecast time, ISO8601 format
forecasts.solarAngle.azimuth Solar azimuth angle, 0 degree for North, increasing clockwise
forecasts.solarAngle.elevation Solar elevation angle
forecasts.dni.value Direct normal irradiance value
forecasts.dni.unit Direct normal irradiance unit，Watt per square meter
forecasts.dhi.value Diffuse horizontal irradiance value
forecasts.dhi.unit Diffuse horizontal irradiance unit, Watt per square meter
forecasts.ghi.value Global horizontal irradiance value
forecasts.ghi.unit Global horizontal irradiance unit, Watt per square meter
forecasts.weather.temperature.value Temperature value
forecasts.weather.temperature.unit Temperature unit, Celsius
forecasts.weather.windSpeed.value Wind speed value
forecasts.weather.windSpeed.unit Wind speed unit, meter per second
forecasts.weather.humidity Relative humidity in percent
forecasts.poa.global.value Plane of array global irradiance value
forecasts.poa.global.unit Plane of array global irradiance unit, Watt per square meter
forecasts.poa.direct.value Plane of array direct irradiance value
forecasts.poa.direct.unit Plane of array direct irradiance unit, Watt per square meter
forecasts.poa.diffuse.value Plane of array diffuse irradiance value
forecasts.poa.diffuse.unit Plane of array diffuse irradiance unit, Watt per square meter
forecasts.poa.reflected.value Plane of array ground-reflected irradiance value
forecasts.poa.reflected.unit Plane of array ground-reflected irradiance unit, Watt per square meter