太阳辐射预报

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

请求路径#

GET /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
localTime 是否返回查询地点的本地时间。true 返回本地时间，false 返回UTC时间（默认）。

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/solarradiation/v1/forecast/39.92/116.41?hours=24&interval=60&tilt=0&azimuth=0&extra=string&localTime=false'

请将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 数据唯一标识
forecasts array 太阳辐照预报数据列表
- forecastTime date-time 预报时间，ISO8601 格式
- 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 单位