40 天次季节预报

Access Restriction

This API is a premium service available only to enterprise tier developers. Please contact Caiyun Sales to purchase.

数据限制

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

Request

• Errors

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

Query Parameters

Name	Required	Default	Range	Description
token	Yes	—	—	API token; see Authentication
longitude	Yes	—	—	Longitude
latitude	Yes	—	—	Latitude
days	No	—	—	Number of days to return

Request Example

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

Response Example

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

Response Fields

GetSubseasonalForecastResponse

JSONPath	Type	Description
$.data	array<SubseasonalForecast>	Forecast data

SubseasonalForecast

SubseasonalForecast 次季节预报天级别数据

JSONPath	Type	Description
$.data[].date	string	Date
$.data[].nlwrt	number	Net longwave radiation at top of atmosphere, W/m²
$.data[].cvpr	number	Convective precipitation rate, mm/hour
$.data[].lspr	number	Large-scale precipitation rate, mm/hour
$.data[].t_2m	number	2m temperature, °C
$.data[].t_max	number	Maximum temperature, °C
$.data[].t_min	number	Minimum temperature, °C
$.data[].mslp	number	Mean sea-level pressure, Pa
$.data[].wind_dir	number	Wind direction
$.data[].wind_speed	number	Wind speed, km/h
$.data[].humidity	number	Relative humidity; values greater than 1 indicate supersaturated air
$.data[].skycon	SubseasonalForecastSkycon	Weather phenomenon

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	暴雪（预留天气现象）