太阳辐射预报

平台: API

获取全球任意坐标的逐15分钟太阳辐射预报及相关数据，最多支持未来60小时预报，分辨率为1x1公里。

请求路径

/solarradiation/v1/forecast/{latitude}/{longitude}

参数

路径参数

latitude(必选)所需位置的纬度。十进制，最多支持小数点后两位。例如 39.92
longitude(必选)所需位置的经度。十进制，最多支持小数点后两位。例如 116.41

查询参数

hours预报小时数，可选1-60，默认24。例如： hours=12
interval预报数据时间间隔，可选15、30、60分钟，默认60。例如：interval=15
extra为当前太阳辐照预报提供的额外信息，可选weather(基本天气数据)。例如：extra=weather

请求示例

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/solarradiation/v1/forecast/50.11/8.68'

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

返回数据

返回数据是JSON格式并进行了Gzip压缩。

{
    "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 数据标签
forecasts.forecastTime 预报时间，ISO8601格式
forecasts.solarAngle.azimuth 太阳方位角，正北为0度，顺时针增加
forecasts.solarAngle.elevation 太阳高度角
forecasts.dni.value 法向直接辐照的值
forecasts.dni.unit 法向直接辐照的单位，瓦特每平方米 W/m²
forecasts.dhi.value 散射水平面辐照的值
forecasts.dhi.unit 散射水平面辐照的单位，瓦特每平方米 W/m²
forecasts.ghi.value 总水平面辐照的值
forecasts.ghi.unit 总水平面辐照的单位，瓦特每平方米 W/m²
forecasts.weather.temperature.value 温度值
forecasts.weather.temperature.unit 温度单位，摄氏度 °C
forecasts.weather.windSpeed.value 风速值
forecasts.weather.windSpeed.unit 风速单位，米每秒 m/s
forecasts.weather.humidity 相对湿度，百分比数值