天级别预报

天级别预报接口，返回目标位置未来多天的逐日天气预报，含全天/白天/夜晚分段变量、空气质量、生活指数与日出日落时间。

更新频率与空间分辨率

逐日数据为批次发布（通常 2-4 次/日），空间分辨率为 9-13 km 级（由逐小时聚合），时间范围为未来十五天逐日。生活指数时间范围为未来十五天逐日。详情见时空变量覆盖情况。

请求

GET https://api.caiyunapp.com/v2.6/{token}/{经度},{纬度}/daily

路径参数

参数	说明
`token`	API 认证凭证，详见认证与鉴权
`经度`	目标地点经度
`纬度`	目标地点纬度

注意：URL 路径中经度在前、纬度在后（如 101.6656,39.2072）；响应中的 location 字段为 [纬度, 经度] 顺序（如 [39.2072, 101.6656]）。

查询参数

名称	必填	默认值	取值范围	说明
`lang`	否	`zh_CN`	`zh_CN`/`zh_TW`/`en_US`/`en_GB`/`ja`	自然语言描述的语言，未匹配时回落 `zh_CN`，见语言
`unit`	否	`metric`	`metric`/`metric:v1`/`metric:v2`/`SI`/`imperial`	单位制，其他取值返回 422，见单位制
`alert`	否	`false`	`true`/`false`	`alert=true` 且 token 具备预警权限时，响应附带 `result.alert`，见预警数据
`callback`	否	-	-	JSONP 回调函数名
`dailysteps`	否	`5`	1~16	返回的天数；通常为 1~15 天，`dailysteps=16` 需配合 `dailystart=-1`；实际上限由套餐决定，超出套餐上限时按套餐上限返回
`dailystart`	否	`0`	-1/0	仅支持 -1 和 0（-1 表示回退一天），其他取值返回 422

请求示例

bash

curl "https://api.caiyunapp.com/v2.6/TAkhjf8d1nlSlspN/101.6656,39.2072/daily?dailysteps=1"

json

{
  "status": "ok", // 返回状态
  "api_version": "v2.6", // API 版本
  "api_status": "active", // API 状态
  "lang": "zh_CN", // 语言
  "unit": "metric", // 单位
  "tzshift": 28800, // 时区偏移
  "timezone": "Asia/Shanghai", // 时区
  "server_time": 1653552787, // 服务器时间
  "location": [
    39.2072, // 纬度
    101.6656 // 经度
  ],
  "result": {
    "daily": {
      "status": "ok",
      "astro": [ // 日出日落时间
        {
          "date": "2022-05-26T00:00+08:00",
          "sunrise": {
            "time": "05:51" // 日出时间
          },
          "sunset": {
            "time": "20:28" // 日落时间
          }
        }
      ],
      "precipitation_08h_20h": [ // 白天降水数据
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 0, // 白天最大降水量
          "min": 0, // 白天最小降水量
          "avg": 0, // 白天平均降水量
          "probability": 0 // 白天降水概率
        }
      ],
      "precipitation_20h_32h": [ // 夜晚降水数据
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 0, // 夜晚最大降水量
          "min": 0, // 夜晚最小降水量
          "avg": 0, // 夜晚平均降水量
          "probability": 0 // 夜晚降水概率
        }
      ],
      "precipitation": [ // 全天降水数据
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 0, // 全天最大降水量
          "min": 0, // 全天最小降水量
          "avg": 0, // 全天平均降水量
          "probability": 0 // 全天降水概率
        }
      ],
      "temperature": [ // 全天地表 2 米气温
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 27, // 全天最高气温
          "min": 18, // 全天最低气温
          "avg": 23.75 // 全天平均气温
        }
      ],
      "temperature_08h_20h": [ // 白天地表 2 米气温
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 27, // 白天最高气温
          "min": 18, // 白天最低气温
          "avg": 24.57 // 白天平均气温
        }
      ],
      "temperature_20h_32h": [ // 夜晚地表 2 米气温
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 24.8, // 夜晚最高气温
          "min": 18, // 夜晚最低气温
          "avg": 20.02 // 夜晚平均气温
        }
      ],
      "wind": [ // 全天地表 10 米风速与风向
        {
          "date": "2022-05-26T00:00+08:00",
          "max": {
            "speed": 28.24,
            "direction": 122.62
          },
          "min": {
            "speed": 9,
            "direction": 104
          },
          "avg": {
            "speed": 21.61,
            "direction": 118.02
          }
        }
      ],
      "wind_08h_20h": [ // 白天地表 10 米风速与风向
        {
          "date": "2022-05-26T00:00+08:00",
          "max": {
            "speed": 28.24,
            "direction": 122.62
          },
          "min": {
            "speed": 9,
            "direction": 104
          },
          "avg": {
            "speed": 22.74,
            "direction": 115.78
          }
        }
      ],
      "wind_20h_32h": [ // 夜晚地表 10 米风速与风向
        {
          "date": "2022-05-26T00:00+08:00",
          "max": {
            "speed": 22.39,
            "direction": 97.46
          },
          "min": {
            "speed": 9.73,
            "direction": 125.93
          },
          "avg": {
            "speed": 16,
            "direction": 121.62
          }
        }
      ],
      "humidity": [ // 地表 2 米相对湿度(0-1)
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 0.18,
          "min": 0.08,
          "avg": 0.09
        }
      ],
      "cloudrate": [ // 云量(0.0-1.0)
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 1,
          "min": 0,
          "avg": 0.75
        }
      ],
      "pressure": [ // 地面气压
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 84500.84,
          "min": 83940.84,
          "avg": 83991.97
        }
      ],
      "visibility": [ // 地表水平能见度
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 25, // 最大能见度
          "min": 24.13, // 最小能见度
          "avg": 25 // 平均能见度
        }
      ],
      "dswrf": [ // 向下短波辐射通量(W/M2)
        {
          "date": "2022-05-26T00:00+08:00",
          "max": 741.9, // 最大辐射通量
          "min": 0, // 最小辐射通量
          "avg": 368.6 // 平均辐射通量
        }
      ],
      "air_quality": {
        "aqi": [
          {
            "date": "2022-05-26T00:00+08:00",
            "max": {
              "chn": 183, // 中国国标 AQI 最大值
              "usa": 160 // 美国国标 AQI 最大值
            },
            "avg": {
              "chn": 29, // 中国国标 AQI 平均值
              "usa": 57 // 美国国标 AQI 平均值
            },
            "min": {
              "chn": 20, // 中国国标 AQI 最小值
              "usa": 42 // 美国国标 AQI 最小值
            }
          }
        ],
        "pm25": [
          {
            "date": "2022-05-26T00:00+08:00",
            "max": 74, // PM2.5 浓度最大值
            "avg": 15, // PM2.5 浓度平均值
            "min": 10 // PM2.5 浓度最小值
          }
        ]
      },
      "skycon": [
        {
          "date": "2022-05-26T00:00+08:00",
          "value": "PARTLY_CLOUDY_DAY" // 全天主要天气现象
        }
      ],
      "skycon_08h_20h": [
        {
          "date": "2022-05-26T00:00+08:00",
          "value": "PARTLY_CLOUDY_DAY" // 白天主要天气现象
        }
      ],
      "skycon_20h_32h": [
        {
          "date": "2022-05-26T00:00+08:00",
          "value": "CLOUDY" // 夜晚主要天气现象
        }
      ],
      "life_index": {
        "ultraviolet": [
          {
            "date": "2022-05-26T00:00+08:00",
            "index": "1",
            "desc": "最弱" // 紫外线指数自然语言
          }
        ],
        "carWashing": [
          {
            "date": "2022-05-26T00:00+08:00",
            "index": "1",
            "desc": "适宜" // 洗车指数自然语言
          }
        ],
        "dressing": [
          {
            "date": "2022-05-26T00:00+08:00",
            "index": "4",
            "desc": "温暖" // 穿衣指数自然语言
          }
        ],
        "comfort": [
          {
            "date": "2022-05-26T00:00+08:00",
            "index": "4",
            "desc": "温暖" // 舒适度指数自然语言
          }
        ],
        "coldRisk": [
          {
            "date": "2022-05-26T00:00+08:00",
            "index": "4",
            "desc": "极易发" // 感冒指数自然语言
          }
        ]
      }
    },
    "primary": 0
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255

响应字段

JSONPath `$.result.daily.`	说明
`temperature[max,min,avg]`	全天地表 2 米气温
`temperature_08h_20h[max,min,avg]`	白天地表 2 米气温
`temperature_20h_32h[max,min,avg]`	夜晚地表 2 米气温
`pressure[max,min,avg]`	地面气压
`humidity[max,min,avg]`	地表 2 米相对湿度(0-1)
`wind[max,min,avg]`	全天地表 10 米风，`max`/`min`/`avg` 均含 `speed`（风速）与 `direction`（风向）
`wind_08h_20h[max,min,avg]`	白天地表 10 米风，结构同上
`wind_20h_32h[max,min,avg]`	夜晚地表 10 米风，结构同上
`precipitation_08h_20h[max,min,avg,probability]`	白天降水数据
`precipitation_20h_32h[max,min,avg,probability]`	夜晚降水数据
`precipitation[max,min,avg,probability]`	全天降水数据
`cloudrate[max,min,avg]`	云量(0.0-1.0)
`dswrf[max,min,avg]`	向下短波辐射通量(W/M2)
`visibility[max,min,avg]`	地表水平能见度
`skycon.value`	全天主要天气现象
`skycon_08h_20h.value`	白天主要天气现象
`skycon_20h_32h.value`	夜晚主要天气现象
`life_index.ultraviolet[index,desc]`	紫外线指数，`index` 为字符串，取值 "0"-"5"（含 "0"=无，夜间），`desc` 语义见生活指数
`life_index.comfort[index,desc]`	舒适度指数，`index` 为字符串，取值 "0"-"13"，`desc` 语义见生活指数
`life_index.carWashing[index,desc]`	洗车指数，`index` 为字符串，取值 "1"-"4"，`desc` 语义见生活指数
`life_index.coldRisk[index,desc]`	感冒指数，`index` 为字符串，取值 "1"-"4"，`desc` 语义见生活指数
`life_index.dressing[index,desc]`	穿衣指数，`index` 为字符串，取值 "0"-"8"，`desc` 语义见生活指数
`air_quality.pm25[max,min,avg]`	PM2.5 浓度(μg/m3)
`air_quality.aqi[max,min,avg]`	国标 AQI，`max`/`min`/`avg` 均含 `chn` 与 `usa`
`astro[sunrise,sunset]`	日出日落时间为当地时区的时刻

对于 xxx, xxx_08h_20h, xxx_20h_32h:

xxx 表示全天，0时～24时的
xxx_08h_20h 表示当天 08～20 时
xxx_20h_32h 表示当天 20～次日 08 时的

备注：

对于全天变量 xxx.avg，在当日，表示的是从当前整点小时至当天结束的平均值，而不是全天的平均值；例外是 wind.avg（含 direction），恒为全天 24 小时的均值。
xxx_08h_20h.avg 与 xxx_20h_32h.avg 恒为完整 12 小时窗口的均值；max/min 始终为对应完整时段窗口的极值。

错误

接口错误统一返回如下结构，HTTP 状态码与含义详见错误信息。

{
  "status": "failed",
  "error": "token is invalid",
  "api_version": "2.6"
}

气象预警

CAP 气象预警

v3 API

API 列表

v2.6 API

API 列表

对照表

v1 API

API 列表

v2.5

API 列表

对照表

v2.4

API 列表

对照表

v2.3

API 列表

对照表

v2.2

API 列表

对照表

天级别预报

更新频率与空间分辨率

请求

路径参数

查询参数

请求示例

响应字段

错误

天级别预报 ​

更新频率与空间分辨率 ​

请求 ​

路径参数 ​

查询参数 ​

请求示例 ​

响应字段 ​

错误 ​

天级别预报

更新频率与空间分辨率

请求

路径参数

查询参数

请求示例

响应字段

错误