40 天次季节预报

访问限制

本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务

数据限制

前 15 天建议采用彩云天级别数据，本预报接口是 大尺度气候预报数据，空间分辨率较粗。

请求

• 错误信息

GET https://singer.caiyunhub.com/v3/subseasonal

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
longitude	是	—	—	经度
latitude	是	—	—	纬度
days	否	—	—	返回天数

请求示例

curl "https://singer.caiyunhub.com/v3/subseasonal?token={token}&longitude=116.3883&latitude=39.9289&days=2"

响应示例

{
  "data": [
    {
      "date": "2022-09-22",
      "nlwrt": 117.73,
      "cvpr": 0.001,
      "lspr": 0.0011,
      "t_2m": -51.37,
      "t_max": -48.53,
      "t_min": -53,
      "mslp": 99774.12,
      "wind_dir": 245.52,
      "wind_speed": 37.04,
      "humidity": -13.54,
      "skycon": 1
    },
    {
      "date": "2022-09-23",
      "nlwrt": 118.8,
      "cvpr": 0.001,
      "lspr": 0.001,
      "t_2m": -51.78,
      "t_max": -47.65,
      "t_min": -54.6,
      "mslp": 99447.07,
      "wind_dir": 343.77,
      "wind_speed": 54.29,
      "humidity": -15.4,
      "skycon": 1
    }
  ]
}

响应字段

GetSubseasonalForecastResponse

JSONPath	类型	说明
$.data	array<SubseasonalForecast>	预报数据

SubseasonalForecast

SubseasonalForecast 次季节预报天级别数据

JSONPath	类型	说明
$.data[].date	string	日期
$.data[].nlwrt	number	总向外长波辐射，W/m2
$.data[].cvpr	number	对流降水率，mm/hour
$.data[].lspr	number	大尺度降水率，mm/hour
$.data[].t_2m	number	2m 气温，摄氏度
$.data[].t_max	number	最高气温，摄氏度
$.data[].t_min	number	最低气温，摄氏度
$.data[].mslp	number	海平面气压，Pa
$.data[].wind_dir	number	风向
$.data[].wind_speed	number	风速，km/h
$.data[].humidity	number	相对湿度；大于 1 的情况为「过饱和湿空气」
$.data[].skycon	SubseasonalForecastSkycon	天气现象

SubseasonalForecastSkycon

SubseasonalForecast 次季节预报天气现象枚举

实际业务可能返回的只是其中的一小部分

Name	Number	Description
UNKNOWN_SUBSEASONAL_SKYCON	0	未知天气现象，API 故障时返回
CLEAR	1	晴
PARTLY_CLOUDY	2	多云
CLOUDY	3	阴
LIGHT_RAIN	10	小雨
MODERATE_RAIN	11	中雨及以上
HEAVY_RAIN	12	大雨（预留天气现象）
STORM_RAIN	13	暴雨（预留天气现象）
LIGHT_SNOW	20	小雪
MODERATE_SNOW	21	中雪及以上
HEAVY_SNOW	22	大雪（预留天气现象）
STORM_SNOW	23	暴雪（预留天气现象）