40 天预报接口

From Caiyun Wiki
Revision as of 05:23, 13 December 2021 by Ringsaturn (talk | contribs) (变量名称及单位)
Jump to: navigation, search

授权与认证

请先至彩云开放平台注册,注册后可以获得 token 。

使用本接口,开发者token需要额外开通权限,请联系商务:api@caiyunapp.com

使用须知

注意:前15天建议采用彩云 v2.5 天级别数据,本预报接口是大尺度气候预报数据

API 地址

http://api.caiyunapp.com/v1/subseasonal/40d?token=TOKEN&lng=116.3883&lat=39.9289

返回结构

 1 {
 2   "status":"ok",
 3   "result":{
 4     "timestamp":[
 5       1624597889,
 6       ...
 7       1627967489
 8     ],
 9     "NLWRT":[
10       221.110549926757812,
11       ...
12       233.494781494140625
13     ],
14     "CVPR":[
15       0.005500207489462,
16       ...
17       0.261872955320541
18     ],
19     "LSPR":[
20       0.043153221795933,
21       ...
22       0.172619601812585
23     ],
24     "2MT":[
25       25.242242431640648,
26       ...
27       25.044671630859398
28     ],
29     "TMAX":[
30       30.667199707031273,
31       ...
32       29.571069335937523
33     ],
34     "SKYCON":[
35       "PARTLY_CLOUDY",
36       ...
37       "PARTLY_CLOUDY"
38     ],
39     "TMIN":[
40       19.856713867187523,
41       ...
42       21.170587158203148
43     ]
44   }
45 }

变量名称及单位

变量 类型 单位 含义
timestamp integer 时间戳
NLWRT float W/m2 总向外长波辐射
CVPR float mm/hour 对流降水率
LSPR float mm/hour 大尺度降水率
2MT float 摄氏度 2m气温
TMAX float 摄氏度 最高气温
TMIN float 摄氏度 最低气温
SKYCON enum(str) 天气现象
MSLP float Pa 海平面气压
WIND_DIR float 风向
WIND_SPEED float m/s 风速
HUMIDITY float 相对湿度;大于1的情况为「过饱和湿空气」

SKYCON 对照表:

天气现象 代码
CLEAR
多云 PARTLY_CLOUDY
小雨 LIGHT_RAIN
中雨及以上 MODERATE_RAIN
小雪 LIGHT_SNOW
中雪及以上 MODERATE_SNOW