Difference between revisions of "40 天预报接口"

From Caiyun Wiki
Jump to: navigation, search
(返回结构)
 
(4 intermediate revisions by the same user not shown)
Line 5: Line 5:
  
 
== 使用须知 ==
 
== 使用须知 ==
注意:前15天建议采用彩云 v2.5 天级别数据,本预报接口是<u>大尺度气候数据预报</u>。
+
注意:前15天建议采用彩云 v2.5 天级别数据,本预报接口是<u>大尺度气候预报数据</u>。
  
 
== API 地址 ==
 
== API 地址 ==
Line 44: Line 44:
 
       ...
 
       ...
 
       29.571069335937523
 
       29.571069335937523
 +
    ],
 +
    "SKYCON":[
 +
      "PARTLY_CLOUDY",
 +
      ...
 +
      "PARTLY_CLOUDY"
 
     ],
 
     ],
 
     "TMIN":[
 
     "TMIN":[
Line 49: Line 54:
 
       ...
 
       ...
 
       21.170587158203148
 
       21.170587158203148
 +
    ],
 +
    "WIND_DIR": [
 +
      163.5,
 +
      ...
 +
      357
 +
    ],
 +
    "WIND_SPEED": [
 +
      7.48,
 +
      ...
 +
      7.77
 +
    ],
 +
    "MSLP": [
 +
      103573.078125,
 +
      ...
 +
      103287.734375
 +
    ],
 +
    "HUMIDITY": [
 +
      0.9595627387425804,
 +
      ...
 +
      0.9244199039358567
 
     ]
 
     ]
 
   }
 
   }
Line 100: Line 125:
 
|
 
|
 
|天气现象
 
|天气现象
 +
|-
 +
|MSLP
 +
|float
 +
|Pa
 +
|海平面气压
 +
|-
 +
|WIND_DIR
 +
|float
 +
|
 +
|风向
 +
|-
 +
|WIND_SPEED
 +
|float
 +
|m/s
 +
|风速
 +
|-
 +
|HUMIDITY
 +
|float
 +
|
 +
|相对湿度;大于1的情况为「过饱和湿空气」
 +
|}
 +
SKYCON 对照表:
 +
{| class="wikitable"
 +
|天气现象
 +
|代码
 +
|-
 +
|晴
 +
|CLEAR
 +
|-
 +
|多云
 +
|PARTLY_CLOUDY
 +
|-
 +
|小雨
 +
|LIGHT_RAIN
 +
|-
 +
|中雨及以上
 +
|MODERATE_RAIN
 +
|-
 +
|小雪
 +
|LIGHT_SNOW
 +
|-
 +
|中雪及以上
 +
|MODERATE_SNOW
 
|}
 
|}

Latest revision as of 05:33, 13 December 2021

授权与认证

请先至彩云开放平台注册,注册后可以获得 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     "WIND_DIR": [
45       163.5,
46       ...
47       357
48     ],
49     "WIND_SPEED": [
50       7.48,
51       ...
52       7.77
53     ],
54     "MSLP": [
55       103573.078125,
56       ...
57       103287.734375
58     ],
59     "HUMIDITY": [
60       0.9595627387425804,
61       ...
62       0.9244199039358567
63     ]
64   }
65 }

变量名称及单位

变量 类型 单位 含义
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