太阳辐射预报

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

请求路径#

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

参数#

路径参数

latitude^必选

number

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

number

所需位置的经度。十进制，最多支持小数点后两位。例如 116.41

查询参数

hours

integer

预报小时数，可选1-60，默认24。例如： hours=12
interval

integer

预报数据时间间隔，可选15、30、60分钟，默认60。例如：interval=15
tilt

integer

光伏系统的倾斜角度，可选0-90，整数。当extra=poa时该参数必传。例如：tilt=30
azimuth

integer

光伏系统的方位角，可选0-359，整数，0 = 北。当extra=poa时该参数必传。例如：azimuth=180
extra

string

为当前太阳辐照预报提供的额外信息，可选weather（基本天气数据）和poa（Plane of array，阵列平面辐照度，必须同时传递tilt和azimuth），多项使用英文逗号分割。例如：extra=weather
localTime

boolean

是否返回查询地点的本地时间

可选值： false UTC时间（默认），true 本地时间

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/solarradiation/v1/forecast/39.92/116.41'

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

试一下

返回数据#

{
  "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

object

元数据
- tag
  
  string
  
  数据唯一标识
- attributions
  
  array
  
  数据归因信息或声明，必须与当前数据共同显示
forecasts

array

太阳辐照预报数据列表
- forecastTime
  
  date-time
  
  预报时间
- solarAngle
  
  object
  
  太阳角度
  - azimuth
    
    number
    
    太阳方位角，正北为0度
  - elevation
    
    number
    
    太阳高度角
- dni
  
  object
  
  法向直接辐照
  - value
    
    number
    
    数值
  - unit
    
    string
    
    单位
- dhi
  
  object
  
  散射水平面辐照
  - value
    
    number
    
    数值
  - unit
    
    string
    
    单位
- ghi
  
  object
  
  总水平面辐照
  - value
    
    number
    
    数值
  - unit
    
    string
    
    单位
- weather
  
  object
  
  基本天气数据，仅在 extra=weather 时返回
  - temperature
    
    object
    
    温度
    - value
      
      number
      
      数值
    - unit
      
      string
      
      单位
  - windSpeed
    
    object
    
    风速
    - value
      
      number
      
      数值
    - unit
      
      string
      
      单位
  - humidity
    
    number
    
    相对湿度
- poa
  
  object
  
  阵列平面辐照度，仅在 extra=poa 时返回
  - global
    
    object
    
    阵列平面总辐照度
    - value
      
      number
      
      数值
    - unit
      
      string
      
      单位
  - direct
    
    object
    
    阵列平面直接辐照度
    - value
      
      number
      
      数值
    - unit
      
      string
      
      单位
  - diffuse
    
    object
    
    阵列平面散射辐照度
    - value
      
      number
      
      数值
    - unit
      
      string
      
      单位
  - reflected
    
    object
    
    阵列平面反射辐照度
    - value
      
      number
      
      数值
    - unit
      
      string
      
      单位