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
extraAdditional information provided for the current solar radiation forecast, optional weather (basic weather data). 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-08-18T09:00Z",
            "solarAngle": {
                "azimuth": 135,
                "elevation": 35
            },
            "dni": {
                "value": 257.36,
                "unit": "W/m²"
            },
            "dhi": {
                "value": 176.57,
                "unit": "W/m²"
            },
            "ghi": {
                "value": 324.59,
                "unit": "W/m²"
            },
            "weather": {
                "temperature": {
                    "value": 15.73,
                    "unit": "°C"
                },
                "windSpeed": {
                    "value": 3.93,
                    "unit": "m/s"
                },
                "humidity": 77
            }
        },
        {
            "forecastTime": "2023-08-18T09:15Z",
            "solarAngle": {
                "azimuth": 139,
                "elevation": 37
            },
            "dni": {
                "value": 274.86,
                "unit": "W/m²"
            },
            "dhi": {
                "value": 185.39,
                "unit": "W/m²"
            },
            "ghi": {
                "value": 349.83,
                "unit": "W/m²"
            },
            "weather": {
                "temperature": {
                    "value": 15.91,
                    "unit": "°C"
                },
                "windSpeed": {
                    "value": 3.98,
                    "unit": "m/s"
                },
                "humidity": 76
            }
        },
        {
            "forecastTime": "2023-08-18T09:30Z",
            "solarAngle": {
                "azimuth": 143,
                "elevation": 38
            },
            "dni": {
                "value": 288.97,
                "unit": "W/m²"
            },
            "dhi": {
                "value": 193.16,
                "unit": "W/m²"
            },
            "ghi": {
                "value": 372.03,
                "unit": "W/m²"
            },
            "weather": {
                "temperature": {
                    "value": 16.07,
                    "unit": "°C"
                },
                "windSpeed": {
                    "value": 4.04,
                    "unit": "m/s"
                },
                "humidity": 74
            }
        },
        {
            "forecastTime": "2023-08-18T09:45Z",
            "solarAngle": {
                "azimuth": 148,
                "elevation": 40
            },
            "dni": {
                "value": 294.61,
                "unit": "W/m²"
            },
            "dhi": {
                "value": 198.86,
                "unit": "W/m²"
            },
            "ghi": {
                "value": 386.63,
                "unit": "W/m²"
            },
            "weather": {
                "temperature": {
                    "value": 16.22,
                    "unit": "°C"
                },
                "windSpeed": {
                    "value": 4.09,
                    "unit": "m/s"
                },
                "humidity": 73
            }
        }
    ]
}

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 W/m²
forecasts.dhi.value Diffuse horizontal irradiance value
forecasts.dhi.unit Diffuse horizontal irradiance unit, Watt per square meter W/m²
forecasts.ghi.value Global horizontal irradiance value
forecasts.ghi.unit Global horizontal irradiance unit, Watt per square meter W/m²
forecasts.weather.temperature.value Temperature value
forecasts.weather.temperature.unit Temperature unit, Celsius °C
forecasts.weather.windSpeed.value Wind speed value
forecasts.weather.windSpeed.unit Wind speed unit, meter per second m/s
forecasts.weather.humidity Relative humidity in percent