太阳辐射预报
获取全球任意坐标的逐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 -
tilt光伏系统的倾斜角度，可选0-90，整数。当extra=poa时该参数必传。例如：tilt=30 -
azimuth光伏系统的方位角，可选0-359，整数，0 = 北。当extra=poa时该参数必传。例如：azimuth=180 -
extra为当前太阳辐照预报提供的额外信息，可选weather（基本天气数据）和poa（Plane of array，阵列平面辐照度，必须同时传递tilt和azimuth），多项使用英文逗号分割。例如：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-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数据标签 -
forecasts.forecastTime预报时间，ISO8601格式 -
forecasts.solarAngle.azimuth太阳方位角，正北为0度，顺时针增加 -
forecasts.solarAngle.elevation太阳高度角 -
forecasts.dni.value法向直接辐照的值 -
forecasts.dni.unit法向直接辐照的单位，瓦特每平方米 -
forecasts.dhi.value散射水平面辐照的值 -
forecasts.dhi.unit散射水平面辐照的单位，瓦特每平方米 -
forecasts.ghi.value总水平面辐照的值 -
forecasts.ghi.unit总水平面辐照的单位，瓦特每平方米 -
forecasts.weather.temperature.value温度值 -
forecasts.weather.temperature.unit温度单位，摄氏度 -
forecasts.weather.windSpeed.value风速值 -
forecasts.weather.windSpeed.unit风速单位，米每秒 -
forecasts.weather.humidity相对湿度，百分比数值 -
forecasts.poa.global.value组件平面总辐照的值 -
forecasts.poa.global.unit组件平面总辐照的单位，瓦特每平方米 -
forecasts.poa.direct.value组件平面直接辐照量 -
forecasts.poa.direct.unit组件平面直接辐照的单位，瓦特每平方米 -
forecasts.poa.diffuse.value组件平面散射辐照量 -
forecasts.poa.diffuse.unit组件平面散射辐照的单位，瓦特每平方米 -
forecasts.poa.reflected.value组件平面地面反射辐照量 -
forecasts.poa.reflected.unit组件平面地面反射辐照的单位，瓦特每平方米