Caiyun Wiki - User contributions [en]

Template:彩云天气 API/支持的单位制

2020-09-28T09:17:31Z

Mengqingye:

'''1.目前支持的单位制包括：科学单位体系（SI，大写）、英制（imperial）、公制（不带参数&unit默认公制，公制还包括: metric:v1和metric:v2）:'''

{| class="wikitable"
! {{diagonal split header|要素|单位制}}
! SI（科学单位体系） !! imperial（英制）!! metric:v1（公制v1）!! metric:v2（公制v2）!! default metric(默认公制)
|-
! 实况降水量
| 米/秒(meter/sec) || 英寸/小时(in/hr) || 雷达降水强度（0~1） || 毫米/小时(mm/hr) || 雷达降水强度（0~1）
|-
! 逐分钟降水短临预报降水量
| 米/秒(meter/sec) || 英寸/小时(in/hr) || 雷达降水强度（0~1） || 毫米/小时(mm/hr) || 雷达降水强度（0~1）
|-
! 逐小时预报降水量
| 米/秒(meter/sec) || 英寸/小时(in/hr) || 雷达降水强度（0~1） || 毫米/小时(mm/hr) || 毫米/小时(mm/hr)
|-
! 逐日预报降水量
| 米/秒(meter/sec) || 英寸/小时(in/hr) || 雷达降水强度（0~1） || 毫米/小时(mm/hr) || 毫米/小时(mm/hr)
|-
! 距离
| 米(m) || 英里(mi) || 公里(km) || 公里(km) || 公里(km)
|-
! 温度
| 开尔文(K) || 华氏度(℉) || 摄氏度(℃) || 摄氏度(℃) || 摄氏度(℃)
|-
! 气压
| 帕(Pa) || 帕(Pa) || 帕(Pa) || 帕(Pa) || 帕(Pa)
|-
! 相对湿度
| 0~1 || 0~1 || 0~1 || 0~1 || 0~1
|-
! 风向
| 从北顺时针(0~360°) || 从北顺时针(0~360°) || 从北顺时针(0~360°) || 从北顺时针(0~360°) || 从北顺时针(0~360°)
|-
! 风速
| '''米/秒（m/s）''' || 英里/小时（mi/hr） || 公里/小时（km/hr） || 公里/小时（km/hr） || 公里/小时（km/hr）
|-
! 云量
| 0~1 || 0~1 || 0~1 || 0~1 || 0~1
|-
! 能见度
| 米(m) || 英里(mi) || 公里(km) || 公里(km) || 公里(km)
|}

unit=metric:v1时，所有类型中precipitation的单位都是：雷达降水强度（0~1）

unit=metric:v2时，所有类型中precipitation的单位都是：毫米/小时(mm/hr)

'''2.判断降水等级:'''

* 带参数&unit=metric:v1，请求实况、分钟级、逐小时和逐日降水强度，单位都为雷达降水强度（0 ~ 1）；

* 雷达降水强度（0 ~ 1）判断降水等级：0.03~0.25 小雨(雪)， 0.25~0.35 中雨(雪)， 0.35~0.48大雨(雪)， >0.48 暴雨(雪)；

* v2.4版本中，本地存在降水时，可以根据skycon（存在于realtime、hourly、daily字段），和skycon_08h_20h和skycon_20h_32h（存在于daily字段），中的：LIGHT_RAIN, MODERATE_RAIN, HEAVY_RAIN, STORM_RAIN(LIGHT_SNOW, MODERATE_SNOW, HEAVY_SNOW，STORM_SNOW)直接获取降水等级

* 大暴雨(雪)和特大暴雨(雪)，需要根据24小时累计公制降水量（mm/24hr）来判断，研发中...

生活指数等级

2020-06-10T04:27:29Z

Mengqingye:

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="12" |紫外线
|ultraviolet0
|无
|-
|ultraviolet1
|很弱
|-
|ultraviolet2
|很弱
|-
|ultraviolet3
|弱
|-
|ultraviolet4
|弱
|-
|ultraviolet5
|中等
|-
|ultraviolet6
|中等
|-
|ultraviolet7
|强
|-
|ultraviolet8
|强
|-
|ultraviolet9
|很强
|-
|ultraviolet10
|很强
|-
|ultraviolet11
|极强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

行政区域经纬度对照表

2020-06-10T03:37:42Z

Mengqingye:

===劝解书===
* 如果你可以获取到经纬度，推荐使用经纬度直接查询天气，全球统一格式。
* 如果你要显示地址，推荐用高德或者谷歌地址 API 来显示地址。

===劝解无效===
* 我确定不想要定位 API，我没有经纬度，我一定要按照城市名字来查询天气，请往下看
[[File:城市名经纬度对照表例子.png|thumb|
经纬度城市名对照表例子
]]

====我的应用是国内的，我想用国内城市来查询天气====
* 对照表下载地址
** [[File:Adcode-release-2020-06-10.xlsx.zip|thumb]]（国内行政区经纬度对照表）
** [[File:cityidloc-20180625.csv.zip|经纬度对照表]]（老文件不推荐）
** [[File:adcode-20190416.csv.zip|国内行政区域编码]]（老文件不推荐）
* 该文档为全国县级以上城市（共计 3557 个）的经纬度对照表。给出城市名，查询对应的经纬度。

====我的应用面向全球，国际城市经纬度对照表====
* 下载地址：[[File: globalcities.csv.zip]]
* 该文档为全球主要城市的经纬度对照表。给出城市名，查询对应的经纬度。
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。

File:Adcode-release-2020-06-10.xlsx.zip

2020-06-10T03:35:44Z

Mengqingye:

天气预警信息

2020-06-04T07:59:24Z

Mengqingye: /* 预警信息的字段 */

获取天气预警信息，需要在API接口后增加参数：<code>alert=true</code>。

==== 预警信息的字段 ====

* pubtimestamp: 发布时间，单位是 Unix 时间戳，如 1587443583
* alertId: 预警ID，如 "35040041600001_20200421123203"
* status: 预警信息的状态，如"预警中"
* adcode: 区域代码，如 "350400"
* location: 位置，如"福建省三明市"
* province: 省，如"福建省"
* city: 市，如"三明市"
* county: 县，如"无"
* code: 预警代码，如"0902"
* source: 发布单位，如"国家预警信息发布中心",
* title: 标题，如"三明市气象台发布雷电黄色预警[Ⅲ级/较重]",
* description: 描述，如"三明市气象台2020年04月21日12时19分继续发布雷电黄色预警信号：预计未来6小时我市有雷电活动，局地伴有短时强降水、6-8级雷雨大风等强对流天气。请注意防范！"

==== 预警代码的编码规则 ====

预警代码取自 code 字段，预警代码的'''前两位'''是预警信息类型，预警代码的'''后两位'''是预警级别。举例："code": "0901”，可以分解出结构：预警类型编码＋预警级别编码，于是我们得到'''雷电蓝色预警'''。

==== 预警类型编码对照表 ====

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

==== 预警级别编码对照表 ====

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}

==== 区域代码 adcode ====

* 通用接口： http://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/weather.json?adcode=110100
** adcode 列表见 [[行政区域经纬度对照表]]

天级预报接口/v2.5/天气变量

2020-05-21T07:19:23Z

Mengqingye:

逐日预报，没有逐日预报的自然语言描述字段

{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.daily.temperature[max,min,avg] || 温度 || 逐日预报 || 全球 || 地表2米气温
|-
! 气压
| $.result.daily.pressure[max,min,avg] || 气压(Pa) || 逐日预报 || 全球 || 地面气压
|-
! 相对湿度
| $.result.daily.humidity[max,min,avg] || 相对湿度(%) || 逐日预报 || 全球 || 地表2米湿度
|-
! 风速
| $.result.daily.wind.speed[max,min,avg] || 风速 || 逐日预报 || 全球 || 地表10米风速
|-
! 本地降水强度
| $.result.daily.precipitation[max,min,avg] || 降水量(mm/h) || 逐日预报 || 全球 || 本地降水量
|-
! 云量
| $.result.daily.cloudrate[max,min,avg] || 云量(0.0-1.0) || 逐日预报 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.daily.dswrf[max,min,avg]|| 向下短波辐射通量(W/M2) || 逐日预报 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.daily.visibility[max,min,avg] || 能见度 || 逐日预报 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 全天主要天气现象
| $.result.daily.skycon.value || 天气状况 || 逐日预报 || 全球 || 全天主要天气现象，参见[[#天气现象代码]]
|-
! 白天主要天气现象
| $.result.daily.skycon_08h_20h.value|| 天气状况 || 逐日预报 || 全球 || 白天主要天气现象，参见[[#天气现象代码]]
|-
! 夜晚主要天气现象
| $.result.daily.skycon_20h_32h.value|| 天气状况 || 逐日预报 || 全球 || 夜晚主要天气现象，参见[[#天气现象代码]]
|-
! 紫外线指数
| $.result.daily.ultraviolet.desc|| 紫外线指数自然语言 || 逐日预报 || 全球 || 紫外线指数及其描述
|-
! 舒适度指数
| $.result.daily.comfort.desc|| 舒适度指数自然语言 || 逐日预报 || 全球 || 舒适度指数及其描述
|-
! 洗车指数
| $.result.daily.carWashing.desc|| 洗车指数自然语言 || 逐日预报 || 全球 || 洗车指数及其描述
|-
! 感冒指数
| $.result.daily.coldRisk.desc|| 感冒指数自然语言 || 逐日预报 || 全球 || 感冒指数及其描述
|-
! 穿衣指数
| $.result.daily.dressing.desc|| 冷热指数自然语言 || 逐日预报 || 全球 || 穿衣指数（dressing），不建议继续使用，请使用舒适度
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.daily.pm25[max,min,avg] || PM25浓度(μg/m3) || 逐日预报 || 大陆、港澳台、暂无印度 || PM25浓度
|-
! AQI
| $.result.daily.aqi[max,min,avg] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 国标AQI
|-
!
!
!
!
!
!
|-
! 日出日落
| $.result.daily.astro[sunrise,sunset] || 时间 || 逐日预报 || 大陆、港澳台、暂无印度 || 日出日落(当地时区的时刻，tzshift不作用在这个变量)
|}

雷达图API接口

2020-05-19T09:01:32Z

Mengqingye:

== API概述 ==
从API可以获取实况雷达图和预报雷达图数据，可用于构造高德地图的图片覆盖物，进行逐帧动画播放展现。

== 雷达图接口 ==
* [[雷达实况图API接口]]
* [[雷达预报图API接口]]

== 高德地图叠图参考 ==
# 根据API返回的图片边界创建 AMap.Bounds(southWest:LngLat, northEast:LngLat)
# 高德地图覆盖物文档： <nowiki>http://lbs.amap.com/api/javascript-api/reference/overlay/</nowiki>

雷达预报图API接口

2020-05-19T09:00:50Z

Mengqingye:

==API概述 '''：'''==
<blockquote>根据经纬度返回对应的雷达预报单站图和雷达预报区域拼图。</blockquote>
=='''授权与认证'''==
<blockquote>请先至彩云开放平台注册，注册后可以获得 token 。使用本接口，开发者token需要额外开通权限，请联系商务：api@caiyunapp.com</blockquote>

==API请求==

=== 示例 ===
http://api.caiyunapp.com/v1/radar/forecast_images?lon=116.427301&lat=39.902451&level=1&token=TOKEN

=== '''请求参数：''' ===
* lon：必须，无缺省值，经度。
* lat：必须，无缺省值，纬度。
* level: 必须，无缺省值，雷达图的类型。1 代表单站图，2 代表区域拼图。
* token ：必须，无缺省值，token。

==API 返回结果==
<syntaxhighlight lang="yaml">
{
status: "ok", #请求的状态
station: "NMIC_AZ9010", #单站雷达的站点编号或者区域拼图的编号
images: [ #雷达图的列表
[
"http://cdn.caiyunapp.com/weather/radar/color/AZ9010_1589878231_1589878231_5e1b05635d504e32ae8de63e0255dfec.png", # 雷达图片的url
1589878231, #雷达图的时间戳
[
37.742471186275736, #雷达图的西南角的纬度
113.78227438031607, #雷达图的西南角的经度
41.874723213724266, #雷达图的东北角的纬度
119.16149781968394 #雷达图的东北角的经度
],
[...],
[...],
],
}
</syntaxhighlight>

=== '''备注：''' ===
* 雷达图的 URL 如果没有 domain，请使用 http[s]://cdn.caiyunapp.com

雷达预报图API接口

2020-05-19T08:47:34Z

Mengqingye: Created page with " ==API概述 '''：'''== <blockquote>根据经纬度返回对应的实况雷达单站图和实况雷达区域拼图。</blockquote> =='''授权与认证'''== <blockquote>请..."

==API概述 '''：'''==
<blockquote>根据经纬度返回对应的实况雷达单站图和实况雷达区域拼图。</blockquote>
=='''授权与认证'''==
<blockquote>请先至彩云开放平台注册，注册后可以获得 token 。使用本接口，开发者token需要额外开通权限，请联系商务：api@caiyunapp.com</blockquote>

==API请求==

=== 示例 ===
http://api.caiyunapp.com/v1/radar/images?lon=116.427301&lat=39.902451&level=1&token=TOKEN

=== '''请求参数：''' ===
* lon：必须，无缺省值，经度。
* lat：必须，无缺省值，纬度。
* level: 雷达图的类型，缺省值为1。1 代表单站图，2 代表区域拼图。
* token ：必须，无缺省值，token。

==API 返回结果==
<syntaxhighlight lang="yaml">
{
status: "ok", #请求的状态
timezone: "Asia/Shanghai", #时区
tzshift: 28800, #时区的偏移秒数，如东八区就是 28800 秒
station: "CN01", #单站雷达的站点编号或者区域拼图的编号
images: [ #雷达图的列表
[
"http://cdn.caiyunapp.com/res/storm_radar/radar_CN01_nmc_fast/202005191207.png", # 雷达图片的url
1589861276, #雷达图的时间戳
[
3.9079, #雷达图的西南角的纬度
71.9282, #雷达图的西南角的经度
57.9079, #雷达图的东北角的纬度
134.8656 #雷达图的东北角的经度
],
[...],
[...],
],
}
</syntaxhighlight>

=== '''备注：''' ===
* 雷达图的 URL 如果没有 domain，请使用 http[s]://cdn.caiyunapp.com

彩云天气 API 一览表

2020-05-19T08:45:40Z

Mengqingye: /* 天气图与面降雨量数据接口 */

{{导览}}

<code>TAkhjf8d1nlSlspN</code> 是个例子，请使用你的 token

* [[通用预报接口/v2.5|通用预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>
* [[实况天气接口/v2.5|实况天气接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>
* [[分钟级降雨预报接口/v2.5|分钟级降雨预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>
* [[小时级预报接口/v2.5|小时级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>
* [[天级预报接口/v2.5|天级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>

== 接口说明 ==

=== 全球点数据接口 ===

* [[通用预报接口/v2.5|通用预报接口]]
* [[实况天气接口/v2.5|实况天气接口]]
* [[分钟级降雨预报接口/v2.5|分钟级降雨预报接口]]
* [[小时级预报接口/v2.5|小时级预报接口]]
* [[天级预报接口/v2.5|天级预报接口]]

=== 天气图与面降雨量数据接口 ===

* [[中国区域降水实况栅格图API|中国区域降水实况区域实况栅格数据]]
* [[雷达图API接口]]
* [[雾霾区域实况图接口|雾霾区域实况图]]

=== 其他数据接口 ===
* [[空气污染实况接口|空气污染站点实况]]
* [[空气污染实况城市排名接口|空气污染城市实况排名]]

===行政区域经纬度对照表===
* [[行政区域经纬度对照表|城市名经纬度表，让你可以按照城市来请求彩云天气接口]]

{{:彩云天气业务速查表}}

==支持的单位制==

{{Template:彩云天气 API/支持的单位制}}

{{:彩云天气数据格式速查表}}

雷达图API接口

2020-05-19T08:44:47Z

Mengqingye:

== API概述 ==
从API可以获取实况雷达图和预报雷达图数据，可用于构造高德地图的图片覆盖物，进行逐帧动画播放展现。

== 雷达图接口 ==
* [[雷达实况图API接口]]

== 高德地图叠图参考 ==
# 根据API返回的图片边界创建 AMap.Bounds(southWest:LngLat, northEast:LngLat)
# 高德地图覆盖物文档： <nowiki>http://lbs.amap.com/api/javascript-api/reference/overlay/</nowiki>

雷达图API接口

2020-05-19T08:38:37Z

Mengqingye: Created page with "API概述"

API概述

雷达实况图API接口

2020-05-19T08:36:16Z

Mengqingye:

<blockquote></blockquote>

==API概述 '''：'''==
<blockquote>根据经纬度返回对应的实况雷达单站图和实况雷达区域拼图。</blockquote>
=='''授权与认证'''==
<blockquote>请先至彩云开放平台注册，注册后可以获得 token 。使用本接口，开发者token需要额外开通权限，请联系商务：api@caiyunapp.com</blockquote>

==API请求==

=== 示例 ===
http://api.caiyunapp.com/v1/radar/images?lon=116.427301&lat=39.902451&level=1&token=TOKEN

=== '''请求参数：''' ===
* lon：必须，无缺省值，经度。
* lat：必须，无缺省值，纬度。
* level: 雷达图的类型，缺省值为1。1 代表单站图，2 代表区域拼图。
* token ：必须，无缺省值，token。

==API 返回结果==
<syntaxhighlight lang="yaml">
{
status: "ok", #请求的状态
timezone: "Asia/Shanghai", #时区
tzshift: 28800, #时区的偏移秒数，如东八区就是 28800 秒
station: "CN01", #单站雷达的站点编号或者区域拼图的编号
images: [ #雷达图的列表
[
"http://cdn.caiyunapp.com/res/storm_radar/radar_CN01_nmc_fast/202005191207.png", # 雷达图片的url
1589861276, #雷达图的时间戳
[
3.9079, #雷达图的西南角的纬度
71.9282, #雷达图的西南角的经度
57.9079, #雷达图的东北角的纬度
134.8656 #雷达图的东北角的经度
],
[...],
[...],
],
}
</syntaxhighlight>

=== '''备注：''' ===
* 雷达图的 URL 如果没有 domain，请使用 http[s]://cdn.caiyunapp.com

雷达实况图API接口

2020-05-19T08:32:47Z

Mengqingye:

雷达实况图API接口

2020-05-19T07:47:33Z

Mengqingye: Created page with "<blockquote></blockquote> =='''API概述：'''== <blockquote>雾霾区域实况图 API，提供两个区域的pm25实况栅格图：亚洲和北美（全球两切片)；</b..."

<blockquote></blockquote>

=='''API概述：'''==
<blockquote>雾霾区域实况图 API，提供两个区域的pm25实况栅格图：亚洲和北美（全球两切片)；</blockquote><blockquote>API会根据经纬度范围，自动选择亚洲或北美雾霾图返回(未来会提供欧洲雾霾切片)；</blockquote><blockquote>文件名为格林威治时间，提供最近48帧（47逐小时历史+实况），每60分钟更新1次（从00H:00M开始）；</blockquote>

=='''授权与认证'''==
<blockquote>请先至彩云开放平台注册，注册后可以获得 token 。使用本接口，开发者token需要额外开通权限，请联系商务：api@caiyunapp.com</blockquote>

=='''请求样例'''==
<blockquote>样例一（亚洲）：api.caiyunapp.com/v1/aqi/images?token=@TOKEN&lon=120&lat=20</blockquote><blockquote>样例二（北美）：api.caiyunapp.com/v1/aqi/images?token=@TOKEN&lon=-120&lat=20</blockquote><blockquote>'''参数：'''</blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 121.6544,25.1552；API会根据经纬度范围，自动选择亚洲或北美雾霾图返回（全球两切片)</blockquote><blockquote>'''token ：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote>

=='''返回结构和说明'''==
样例一（亚洲）：

<blockquote><syntaxhighlight lang="javascript">

{ status "ok"
category "aqi_latest_obs_image"
images:
0:{ #历史-48h帧
0: "http://cdn.caiyunapp.com/weather/pm25_rt_as_20190318_05.png", #UTC时间
1: 1552885200, #UTC时间戳
2:{
-10, #图片最南处纬度 lat0
60, #图片最西处经度 lon0
56, #图片最北处纬度 lat1
146 #图片最东处经度 lon1
}
},
1:{...},
...
47:{...} #当前实况帧
}

</syntaxhighlight></blockquote>

样例二（北美）：

<blockquote><syntaxhighlight lang="javascript">

{ status "ok"
category "aqi_latest_obs_image"
images:
0:{ #历史-48h帧
0: "http://cdn.caiyunapp.com/weather/pm25_rt_na_20190318_05.png" #UTC时间
1: 1552885200 #UTC时间戳
2:{
15, #图片最南处纬度 lat0
-169, #图片最西处经度 lon0
71.5, #图片最北处纬度 lat1
-52 #图片最东处经度 lon1
}
},
1:{...},
...
47:{...} #当前实况帧
}

</syntaxhighlight></blockquote>

Category:API 产品

2020-05-19T07:30:58Z

Mengqingye: Created page with "= 雷达图接口 ="

= 雷达图接口 =

彩云天气 API 一览表

2020-05-19T03:10:55Z

Mengqingye: /* 天气图与面降雨量数据接口 */

{{导览}}

<code>TAkhjf8d1nlSlspN</code> 是个例子，请使用你的 token

* [[通用预报接口/v2.5|通用预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>
* [[实况天气接口/v2.5|实况天气接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>
* [[分钟级降雨预报接口/v2.5|分钟级降雨预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>
* [[小时级预报接口/v2.5|小时级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>
* [[天级预报接口/v2.5|天级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>

== 接口说明 ==

=== 全球点数据接口 ===

* [[通用预报接口/v2.5|通用预报接口]]
* [[实况天气接口/v2.5|实况天气接口]]
* [[分钟级降雨预报接口/v2.5|分钟级降雨预报接口]]
* [[小时级预报接口/v2.5|小时级预报接口]]
* [[天级预报接口/v2.5|天级预报接口]]

=== 天气图与面降雨量数据接口 ===

* [[中国区域降水实况栅格图API|中国区域降水实况区域实况栅格数据]]
* [[雾霾区域实况图接口|雾霾区域实况图]]

=== 其他数据接口 ===
* [[空气污染实况接口|空气污染站点实况]]
* [[空气污染实况城市排名接口|空气污染城市实况排名]]

===行政区域经纬度对照表===
* [[行政区域经纬度对照表|城市名经纬度表，让你可以按照城市来请求彩云天气接口]]

{{:彩云天气业务速查表}}

==支持的单位制==

{{Template:彩云天气 API/支持的单位制}}

{{:彩云天气数据格式速查表}}

空气污染实况接口

2020-04-30T13:27:50Z

Mengqingye:

=='''授权与认证'''==

请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

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

把您的 token 拼到 API 请求的 URL 中，如: [http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN <code>http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN</code>]

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例及参数说明'''==
请求国控站点的数据：

[http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN <code>http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN</code>]

请求国控站点和省控站点的数据：

[http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN&options=EMC,ProvinceControl <code>http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN&options=EMC,ProvinceControl</code>]

options: 传入单个数据源或多个数据源，当传入多个数据源时用逗号分隔。现有数据源包含 EMC 和 ProvinceControl， EMC 代表国控站点数据，ProvinceControl 代表省控站点数据。options的默认值是EMC。

=='''返回结构和说明'''==
<syntaxhighlight lang="javascript">

{
status: ok
category: aqi_latest_obs_city
result: {
0000A02880: ## 彩云全球雾霾站点编号（10位字符串）
{ station_code: "0000A02880", ## 彩云全球雾霾站点编号（10位字符串）
area: "成都市", ## 站点所在城市、城区、县级名称（中文或者英文）
province_name:"四川", ## 站点所在省的名称
position_name:"大石西路", ## 站点地址（中文或者英文）
lon: "104.0238889",
lat: "30.65638889", ## 经纬度
time_point: "2019-01-14T17:00:00Z+08:00", ## 观测时间和时区信息
quality: "轻度污染", ## 空气污染等级，自然语言描述（中文）
primary_pollutant: "细颗粒物(PM2.5)", ## 主要污染物（中文）
pm25: "91", ## 细颗粒污染[μg/m3]，缺测为“null”
pm10: "134", ## 粗颗粒污染[μg/m3]，缺测为“null”
o3: "null", ## 臭氧[μg/m3]，缺测为“null”
no2: "49" ## 二氧化氮[μg/m3]，缺测为“null”
so2: "8", ## 二氧化硫[μg/m3]，缺测为“null”
co: "1.1", ## 一氧化碳[mg/m3]，缺测为“null”
aqi: "120" ## AQI（中国自然资源部，国标）
},
0000A02317:{...},
...
}
}
</syntaxhighlight>

[[Category:API 产品]]

实况天气接口/v2.5

2020-03-27T09:07:30Z

Mengqingye: /* 返回结构和说明 */

{{彩云天气 API 版本状态}}

=='''授权与认证'''==

请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
<nowiki>https://api.caiyunapp.com/v2.5</nowiki><nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

===== 示例1如下 =====
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</nowiki> </code></blockquote><blockquote><code> <nowiki>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.jsonp?callback=MYCALLBACK</nowiki></code></blockquote><blockquote>'''token ：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

==== 示例2如下 ====
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json?lang=en_US</nowiki> </code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote>

=='''返回结构和说明'''==
<syntaxhighlight lang="yaml">

status: ok
api_version: v2.5 # 版本号
api_status: active # 版本号状态
lang: zh_CN # 语言
unit: metric # 单位制
location: [25.1552 121.6544] # 经纬度
server_time: 1443418222 # 服务器本次返回的utc时间戳
tzshift: 28800 # 时区的偏移秒数，如东八区就是 28800 秒
result:
realtime:
status: ok # 实况模块返回状态
temperature: 28.0 # 温度
apparent_temperature: 27.0 # 体感温度
pres: 100991.3 # 气压
humidity: 0.92 # 相对湿度
wind:
direction: 25.33 # 风向，单位是度。正北方向为0度，顺时针增加到360度。
speed: 83.3 # 风速，米制下是公里每小时
precipitation:
nearest:
status: ok
distance: 0.77 # 最近的降水带距离
intensity: 0.3125 # 最近的降水带降水强度（单位为雷达降水强度）
local:
status: ok
intensity: 0.2812 # 本地降水强度（单位为雷达降水强度）
datasource: radar # 本地降水观测的数据源（radar，GFS）
cloudrate: 0.51 # 云量
dswrf: 8.3 # 向下短波辐射通量
visibility: 8.3 # 能见度
skycon: RAIN # 主要天气现象
life_index:
comfort: # 舒适度指数及其自然语言描述
index: 7
desc: 冷
ultraviolet: # 紫外线指数及其自然语言描述
index: 0
desc: 无
air_quality:
pm25: 18 # pm25，质量浓度值
pm10: 46 # pm10，质量浓度值
o3: 47 # 臭氧，质量浓度值
no2: 14 # 二氧化氮，质量浓度值
so2: 1 # 二氧化硫，质量浓度值
co: 0.3 # 一氧化碳，质量浓度值
aqi:
chn: 8 # AQI（中国标准）
usa: 0 # AQI（美国标准）
description:
usa: ""
chn: "优"

</syntaxhighlight>

=='''变量说明'''==

{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.temperature || 温度 || 实况 || 全球 || 地表2米气温
|-
! 气压
| $.result.pres || 气压(Pa) || 实况 || 全球 || 地面气压
|-
! 相对湿度
| $.result.humidity || 相对湿度(%) || 实况 || 全球 || 地表2米湿度
|-
! 风向
| $.result.wind.direction || 风向 || 实况 || 全球 || 地表10米风向
|-
! 风速
| $.result.wind.speed || 风速 || 实况 || 全球 || 地表10米风速
|-
! 最近降水距离
| $.result.precipitation.nearest.distance || 距离 || 实况 || 全球 || 最近降水带与本地的距离
|-
! 最近降水强度
| $.result.precipitation.nearest.intensity || 降水强度 || 实况 || 全球 || 最近降水处的降水强度
|-
! 本地降水强度
| $.result.precipitation.local.intensity || 雷达降水强度 || 实况 || 全球 || 最近降水处的降水强度
|-
! 云量
| $.result.cloudrate || 云量(0.0-1.0) || 实况 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.dswrf|| 向下短波辐射通量(W/M2) || 实况 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.visibility || 能见度 || 实况 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 天气状况
| $.result.skycon || 天气状况 || 实况 || 全球 || 天气状况
|-
! 舒适度指数
| $.result.comfort.index || 舒适度指数自然语言 || 实况 || 全球 || 舒适度指数及其描述
|-
! 紫外线指数
| $.result.ultraviolet.index || 紫外线指数自然语言 || 实况 || 全球 || 紫外线指数及其描述
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.pm25 || PM25浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM25浓度
|-
! PM10浓度
| $.result.pm10 || PM10浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM10浓度
|-
! 臭氧浓度
| $.result.o3 || 臭氧浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 臭氧浓度
|-
! 二氧化氮浓度
| $.result.no2 || 二氧化氮浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化氮浓度
|-
! 二氧化硫浓度
| $.result.so2 || 二氧化硫浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化硫浓度
|-
! 一氧化碳浓度
| $.result.co || 一氧化碳浓度(mg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 一氧化碳浓度
|-
! AQI
| $.result.aqi || 国标AQI || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 国标AQI
|}
{{天气现象}}

=='''生活指数'''==
{{生活指数}}

=='''支持的单位制'''==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

Template:天气现象

2020-02-26T04:36:00Z

Mengqingye: /* 天气现象 */

=='''天气现象 skycon v2.5'''==

主要天气现象的优先级：冰雹 > 雷阵雨 > 降雪 > 降雨 > 雾 > 沙尘 > 浮尘 > 雾霾 > 大风 > 阴 > 多云 > 晴

{| class="wikitable"
! 天气现象
! 代码
! 备注
|-
|晴（白天）
|CLEAR_DAY
|cloudrate < 0.2
|-
|晴（夜间）
|CLEAR_NIGHT
|cloudrate < 0.2
|-
|多云（白天）
|PARTLY_CLOUDY_DAY
|0.8 >= cloudrate > 0.2
|-
|多云（夜间）
|PARTLY_CLOUDY_NIGHT
|0.8 >= cloudrate > 0.2
|-
|阴
|CLOUDY
|cloudrate > 0.8
|-
|轻度雾霾
|LIGHT_HAZE
|PM2.5 100~150
|-
|中度雾霾
|MODERATE_HAZE
|PM2.5 150~200
|-
|重度雾霾
|HEAVY_HAZE
|PM2.5 > 200
|-
|小雨
|LIGHT_RAIN
|-
|中雨
|MODERATE_RAIN
|-
|大雨
|HEAVY_RAIN
|-
|暴雨
|STORM_RAIN
|-
|雾
|FOG
|能见度低，湿度高，风速低，温度低
|-
|小雪
|LIGHT_SNOW
|-
|中雪
|MODERATE_SNOW
|-
|大雪
|HEAVY_SNOW
|-
|暴雪
|STORM_SNOW
|-
|浮尘
|DUST
|aqi > 150，pm10 > 150，湿度 < 30%，风速 < 6 m/s
|-
|沙尘
|SAND
|aqi > 150，pm10 > 150，湿度 < 30%，风速 > 6 m/s
|-
|大风
|WIND
|-
|雷阵雨
|THUNDER_SHOWER
|闪电+降水
|-
|冰雹
|HAIL
|闪电+降水+其他
|-
|雨夹雪
|SLEET
|}

雾霾类(HAZE）天气现象（skycon）分三个等级：

{| class="wikitable"
|-
|轻度雾霾
|中度雾霾
|重度雾霾
|-
|AQI > 100
|AQI > 150
|AQI > 200
|}

空气污染的自然语言描述air_quality: description字段，根据AQI有六个等级划分：

{| class="wikitable"
|-
|缺数据 missing
|优 good
|良 satisfactory
|轻度污染 moderate
|中度污染 unhealthy
|重度污染 very poor
|严重污染 hazardous
|-
|无测站国家和位置
|0~50
|51~100
|101~150
|151~200
|201~300
|>300
|}

彩云天气 API/v2.5

2020-02-26T03:54:45Z

Mengqingye: /* 天气数据覆盖区域 */

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
* 小时级和天级天气数据覆盖全球任意经纬度；
* 分钟级降水数据覆盖范围如下：
# 欧洲: 意大利、立陶宛、马耳他、法国、斯洛伐克、挪威、白俄罗斯、冰岛、捷克、斯洛文尼亚、德国、西班牙、乌克兰、丹麦、波兰、芬兰、瑞典、克罗地亚、俄罗斯、罗马尼亚、葡萄牙、爱沙尼亚、塞尔维亚、英国、奥地利、希腊、匈牙利
# 澳大利亚: 斐济，关岛，澳大利亚，马绍尔群岛，新喀里多尼亚
# 亚洲: 中国大陆及港澳，台湾，钓鱼岛，南沙群岛，土耳其，巴林，沙特阿拉伯，印度尼西亚，伊朗，新加坡，阿曼，菲律宾，日本，印度，柬埔寨，塞浦路斯，马来西亚，越南，科威特，泰国，韩国，朝鲜
# 北美洲: 加拿大，巴哈马，开曼群岛，墨西哥，巴拿马，马提尼克，古巴，美国，百慕大，波多黎各，库拉岛，瓜德罗普，尼加拉瓜
# 南美洲: 巴西，法属圭亚那，哥伦比亚，圭亚那，巴拉圭，阿根廷

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：继承v2.4，本版本已经是稳定版本。

* [[实况天气接口/v2.5|实况天气接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
* [[分钟级降雨预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>
* [[小时级预报接口/v2.5|小时级预报接口]]：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]
* [[天级预报接口/v2.5|天级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>
* [[通用预报接口/v2.5|通用点数据接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.031'''
|'''<0.08'''
|无雨／雪
|-
|'''0.031～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2.5/your_token/121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

== 按区域代码adcode返回对应城市的数据 ==

通用接口： http://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/weather.json?adcode=110100

adcode 列表见 [[行政区域经纬度对照表]]

==格式变更==
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx

*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下

*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
*v2.4及以上版本pres字段改为了pressure
==特性增强==
*air_quality（预报和实况）中，增加美标和国标的AQI

*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
*新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；
{{天气现象v2.5}}

[[Category:API 产品]]

彩云天气 API/v2.5

2020-02-19T06:44:57Z

Mengqingye:

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
# 小时级和天级天气数据覆盖全球任意经纬度；
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：继承v2.4，本版本已经是稳定版本。

* [[实况天气接口/v2.5|实况天气接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
* [[分钟级降雨预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>
* [[小时级预报接口/v2.5|小时级预报接口]]：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]
* [[天级预报接口/v2.5|天级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>
* [[通用预报接口/v2.5|通用点数据接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.031'''
|'''<0.08'''
|无雨／雪
|-
|'''0.031～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2.5/your_token/%09121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

== 按区域代码adcode返回对应城市的数据 ==

通用接口： http://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/weather.json?adcode=110100

adcode 列表见 [[行政区域经纬度对照表]]

==格式变更==
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx

*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下

*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
*v2.4及以上版本pres字段改为了pressure
==特性增强==
*air_quality（预报和实况）中，增加美标和国标的AQI

*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
*新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；
{{天气现象v2.5}}

[[Category:API 产品]]

通用预报接口/v2.5

2020-02-19T06:41:27Z

Mengqingye:

{{彩云天气 API 版本状态}}

=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

=== '''示例1如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

</blockquote><blockquote>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.jsonp?callback=MYCALLBACK</blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

=== '''示例2如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather?lang=en_US</code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote><blockquote>'''返回周围预警: alert='''true (注意小写)</blockquote>

=='''返回结构和说明'''==
<blockquote>'''realtime'''分字段含义，请移步：[[实况天气接口/v2.5|实况接口/v2.5]]</blockquote><blockquote>'''minutely'''分字段含义，请移步：[[分钟级降雨预报接口|逐分钟降水短临预报接口/v2.5]]</blockquote><blockquote>'''hourly'''分字段含义，请移步：[[小时级预报接口/v2.5|逐小时预报接口/v2.5]]</blockquote><blockquote>'''daily'''分字段含义，请移步：[[天级预报接口/v2.5|逐日预报接口/v2.5]]</blockquote><blockquote>'''alert'''分字段含义，如下：</blockquote><syntaxhighlight lang="javascript">

{ status:ok,
api_version:v2.5,
api_status:active,
unit:metric,
lang:en_US,
result:{
forecast_keypoint:cloudy, clear weather after 23 this midnight,
primary:0,
realtime:{status:ok, ###请参考：实况接口/v2.5
temperature:-1.21,
pres:56320.24,
humidity:0.09,
wind:{direction:284.91,speed:30.12}},
precipitation:{local:{status:ok,intensity:0.0,datasource:gfs}},
cloudrate:0.3,
dswrf:677.9,
visibility:24.1,

skycon:PARTLY_CLOUDY_DAY,
ultraviolet:{index:5.0,desc:Moderat},
comfort:{index:11,desc:Icy wind cold},

pm25:3,
pm10:10.0,
o3:97.0,
no2:2.0,
so2:7.0,
co:0.4,
aqi:10
},
minutely:{status:ok, ###请参考：逐分钟降水短临预报接口/v2.5
precipitation_2h:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],
precipitation:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],
datasource:gfs,
description:No snow in the next hour
},
hourly:{status:ok, ###请参考：逐小时预报接口/v2.5
description:cloudy, clear weather after 23 this midnight,
temperature:[{value:-1.21,datetime:2018-11-20 16:00},{value:-0.51,datetime:2018-11-20 17:00}]},
pres:[{value:56320.2411405722,datetime:2018-11-20 16:00},{value:56309.4272949293,datetime:2018-11-20 17:00}],
humidity:[{value:0.09,datetime:2018-11-20 16:00},{value:0.11,datetime:2018-11-20 17:00}],
wind:[{direction:284.91,speed:30.12,datetime:2018-11-20 16:00},{direction:288.24,speed:32.91,datetime:2018-11-20 17:00}],
precipitation:[{value:0.0,datetime:2018-11-20 16:00},{value:0.0,datetime:2018-11-20 17:00}],
cloudrate:[{value:0.3,datetime:2018-11-20 16:00},{value:0.3,datetime:2018-11-20 17:00}],
dswrf:[{value:677.9121814107,datetime:2018-11-20 16:00},{value:596.25984,datetime:2018-11-20 17:00}],
visibility:[{value:24.1,datetime:2018-11-20 16:00},{value:24.1,datetime:2018-11-20 17:00}],

skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 16:00},{value:WIND,datetime:2018-11-20 17:00}],
pm25:[{value:3,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],
aqi:[{value:10,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],
},
daily:{status:ok, ###请参考：逐日预报接口/v2.5
temperature:[{date:2018-11-20,max:1.19,avg:-4.35,min:-16.0},{date:2018-11-21,max:2.0,avg:-7.32,min:-18.0}],
pres:[{date:2018-11-20,max:56600.24,avg:56422.06,min:56309.43},{date:2018-11-21,max:56833.63,avg:56653.05,min:56553.63}],
humidity:[{date:2018-11-20,max:0.23,avg:0.14,min:0.09},{date:2018-11-21,max:0.15,avg:0.11,min:0.06}],
wind:[{date:2018-11-20,max:{direction:290.25,speed:35.9},avg:{direction:278.27,speed:19.65},min:{direction:230.17,speed:4.77}},
{date:2018-11-21,max:{direction:276.13,speed:43.0},avg:{direction:262.47,speed:24.54},min:{direction:216.1,speed:12.48}}],
precipitation:[{date:2018-11-20,max:0.0,avg:0.0,min:0.0},{date:2018-11-21,max:0.0,avg:0.0,min:0.0}],

dswrf:[{date:2018-11-20,max:743.7,avg:321.5,min:0.0},{date:2018-11-21,max:748.3,avg:202.3,min:0.0}],
cloudrate:[{date:2018-11-20,max:0.76,avg:0.49,min:0.0},{date:2018-11-21,max:0.15,avg:0.02,min:0.0}],
visibility:[{date:2018-11-20,max:24.1,avg:24.1,min:24.1},{date:2018-11-21,max:24.1,avg:24.1,min:24.1}],

skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:CLEAR_DAY}],
skycon_08h_20h:[{date:2018-11-20,value:CLEAR_DAY},{date:2018-11-21,value:CLEAR_DAY}]},
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:CLEAR_NIGHT}],
ultraviolet:[{index:5,desc:Very high,datetime:2018-11-20},{index:5,desc:Very high,datetime:2018-11-21}],
comfort:[{index:13,desc:Dry cold,datetime:2018-11-20},{index:13,desc:Dry cold,datetime:2018-11-21}],
carWashing:[{index:1,desc:Suitable,datetime:2018-11-20},{index:1,desc:Suitable,datetime:2018-11-21}],
coldRisk:[{index:4,desc:Extremely prone,datetime:2018-11-20},{index:4,desc:Extremely prone,datetime:2018-11-21}],
dressing:[{index:8,desc:Extremely cold,datetime:2018-11-20},{index:8,desc:Extremely cold,datetime:2018-11-21}],

pm25:[{date:2018-11-20,max:3,avg:1.12,min:0},{date:2018-11-21,max:1,avg:0.58,min:0}],
aqi:[{date:2018-11-20,max:10,avg:1.25,min:0},{date:2018-11-21,max:0,avg:0.0,min:0}],

astro:[{date:2018-11-20,sunset:{time:19:07},sunrise:{time:08:40}},{date:2018-11-21,sunset:{time:19:07},sunrise:{time:08:41}}],
},
alert:{alert:{status:"ok"
content:{
0:{ request_status: "ok",
source: "国家预警信息发布中心",

county: "无",
province: "江苏省",
regionId: "unknown"
city: "南京市",
code: "1303", ##预警类型code
adcode: "320100",

alertId: "32010041600000_20181130104521",
status: "预警中",
title: "南京市气象台发布霾橙色预警[Ⅱ级/严重]",
description: "南京市气象台2018年11月30日10时41分升级霾黄色预警信号为霾橙色预警信号。目前我市已经出现中度霾，预计未来24小时内霾将持续，请注意防范。"

location: "江苏省南京市",
latlon: {
0: 32.060255,
1: 118.796877
}
pubtimestamp: 1543545921,
}
}
}
},
location:[31.658613,
87.815109]
server_time:1542702509,
tzshift:28800,
}

</syntaxhighlight>{{预警类型}}{{天气现象}}

=='''生活指数'''==
{{生活指数}}

=='''支持的单位制'''==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

彩云天气 API/v2.5

2020-02-19T06:39:02Z

Mengqingye:

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
# 小时级和天级天气数据覆盖全球任意经纬度；
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：继承v2.4，本版本已经是稳定版本。

* [[实况天气接口/v2.5|实况天气接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
* [[分钟级降雨预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>
* [[小时级预报接口/v2.5|小时级预报接口]]：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]
* [[天级预报接口/v2.5|天级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>
* [[通用预报接口/v2.5|通用点数据接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.031'''
|'''<0.08'''
|无雨／雪
|-
|'''0.031～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2/your_token/	121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

== 按区域代码adcode返回对应城市的数据 ==

通用接口： http://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/weather.json?adcode=110100

adcode 列表见 [[行政区域经纬度对照表]]

==格式变更==
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx

*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下

*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
*v2.4及以上版本pres字段改为了pressure
==特性增强==
*air_quality（预报和实况）中，增加美标和国标的AQI

*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
*新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；
{{天气现象v2.5}}

[[Category:API 产品]]

通用预报接口/v2.5

2020-02-19T06:36:22Z

Mengqingye:

{{彩云天气 API 版本状态}}

=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

=== '''示例1如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

</blockquote><blockquote>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.jsonp?callback=MYCALLBACK</blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

=== '''示例2如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather?lang=en_US</code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote><blockquote>'''返回周围预警: alert='''true (注意小写)</blockquote>

=='''返回结构和说明'''==
<blockquote>'''realtime'''分字段含义，请移步：[[实况天气接口/v2.5|实况接口/v2.5]]</blockquote><blockquote>'''minutely'''分字段含义，请移步：[[分钟级降雨预报接口|逐分钟降水短临预报接口/v2.5]]</blockquote><blockquote>'''hourly'''分字段含义，请移步：[[小时级预报接口/v2.5|逐小时预报接口/v2.5]]</blockquote><blockquote>'''daily'''分字段含义，请移步：[[天级预报接口/v2.5|逐日预报接口/v2.5]]</blockquote><blockquote>'''alert'''分字段含义，如下：</blockquote><syntaxhighlight lang="javascript">

{ status:ok,
api_version:v2.5,
api_status:active,
unit:metric,
lang:en_US,
result:{
forecast_keypoint:cloudy, clear weather after 23 this midnight,
primary:0,
realtime:{status:ok, ###请参考：实况接口/v2.2
temperature:-1.21,
pres:56320.24,
humidity:0.09,
wind:{direction:284.91,speed:30.12}},
precipitation:{local:{status:ok,intensity:0.0,datasource:gfs}},
cloudrate:0.3,
dswrf:677.9,
visibility:24.1,

skycon:PARTLY_CLOUDY_DAY,
ultraviolet:{index:5.0,desc:Moderat},
comfort:{index:11,desc:Icy wind cold},

pm25:3,
pm10:10.0,
o3:97.0,
no2:2.0,
so2:7.0,
co:0.4,
aqi:10
},
minutely:{status:ok, ###请参考：逐分钟降水短临预报接口/v2.2
precipitation_2h:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],
precipitation:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],
datasource:gfs,
description:No snow in the next hour
},
hourly:{status:ok, ###请参考：逐小时预报接口/v2.2
description:cloudy, clear weather after 23 this midnight,
temperature:[{value:-1.21,datetime:2018-11-20 16:00},{value:-0.51,datetime:2018-11-20 17:00}]},
pres:[{value:56320.2411405722,datetime:2018-11-20 16:00},{value:56309.4272949293,datetime:2018-11-20 17:00}],
humidity:[{value:0.09,datetime:2018-11-20 16:00},{value:0.11,datetime:2018-11-20 17:00}],
wind:[{direction:284.91,speed:30.12,datetime:2018-11-20 16:00},{direction:288.24,speed:32.91,datetime:2018-11-20 17:00}],
precipitation:[{value:0.0,datetime:2018-11-20 16:00},{value:0.0,datetime:2018-11-20 17:00}],
cloudrate:[{value:0.3,datetime:2018-11-20 16:00},{value:0.3,datetime:2018-11-20 17:00}],
dswrf:[{value:677.9121814107,datetime:2018-11-20 16:00},{value:596.25984,datetime:2018-11-20 17:00}],
visibility:[{value:24.1,datetime:2018-11-20 16:00},{value:24.1,datetime:2018-11-20 17:00}],

skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 16:00},{value:WIND,datetime:2018-11-20 17:00}],
pm25:[{value:3,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],
aqi:[{value:10,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],
},
daily:{status:ok, ###请参考：逐日预报接口/v2.2
temperature:[{date:2018-11-20,max:1.19,avg:-4.35,min:-16.0},{date:2018-11-21,max:2.0,avg:-7.32,min:-18.0}],
pres:[{date:2018-11-20,max:56600.24,avg:56422.06,min:56309.43},{date:2018-11-21,max:56833.63,avg:56653.05,min:56553.63}],
humidity:[{date:2018-11-20,max:0.23,avg:0.14,min:0.09},{date:2018-11-21,max:0.15,avg:0.11,min:0.06}],
wind:[{date:2018-11-20,max:{direction:290.25,speed:35.9},avg:{direction:278.27,speed:19.65},min:{direction:230.17,speed:4.77}},
{date:2018-11-21,max:{direction:276.13,speed:43.0},avg:{direction:262.47,speed:24.54},min:{direction:216.1,speed:12.48}}],
precipitation:[{date:2018-11-20,max:0.0,avg:0.0,min:0.0},{date:2018-11-21,max:0.0,avg:0.0,min:0.0}],

dswrf:[{date:2018-11-20,max:743.7,avg:321.5,min:0.0},{date:2018-11-21,max:748.3,avg:202.3,min:0.0}],
cloudrate:[{date:2018-11-20,max:0.76,avg:0.49,min:0.0},{date:2018-11-21,max:0.15,avg:0.02,min:0.0}],
visibility:[{date:2018-11-20,max:24.1,avg:24.1,min:24.1},{date:2018-11-21,max:24.1,avg:24.1,min:24.1}],

skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:CLEAR_DAY}],
skycon_08h_20h:[{date:2018-11-20,value:CLEAR_DAY},{date:2018-11-21,value:CLEAR_DAY}]},
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:CLEAR_NIGHT}],
ultraviolet:[{index:5,desc:Very high,datetime:2018-11-20},{index:5,desc:Very high,datetime:2018-11-21}],
comfort:[{index:13,desc:Dry cold,datetime:2018-11-20},{index:13,desc:Dry cold,datetime:2018-11-21}],
carWashing:[{index:1,desc:Suitable,datetime:2018-11-20},{index:1,desc:Suitable,datetime:2018-11-21}],
coldRisk:[{index:4,desc:Extremely prone,datetime:2018-11-20},{index:4,desc:Extremely prone,datetime:2018-11-21}],
dressing:[{index:8,desc:Extremely cold,datetime:2018-11-20},{index:8,desc:Extremely cold,datetime:2018-11-21}],

pm25:[{date:2018-11-20,max:3,avg:1.12,min:0},{date:2018-11-21,max:1,avg:0.58,min:0}],
aqi:[{date:2018-11-20,max:10,avg:1.25,min:0},{date:2018-11-21,max:0,avg:0.0,min:0}],

astro:[{date:2018-11-20,sunset:{time:19:07},sunrise:{time:08:40}},{date:2018-11-21,sunset:{time:19:07},sunrise:{time:08:41}}],
},
alert:{alert:{status:"ok"
content:{
0:{ request_status: "ok",
source: "国家预警信息发布中心",

county: "无",
province: "江苏省",
regionId: "unknown"
city: "南京市",
code: "1303", ##预警类型code
adcode: "320100",

alertId: "32010041600000_20181130104521",
status: "预警中",
title: "南京市气象台发布霾橙色预警[Ⅱ级/严重]",
description: "南京市气象台2018年11月30日10时41分升级霾黄色预警信号为霾橙色预警信号。目前我市已经出现中度霾，预计未来24小时内霾将持续，请注意防范。"

location: "江苏省南京市",
latlon: {
0: 32.060255,
1: 118.796877
}
pubtimestamp: 1543545921,
}
}
}
},
location:[31.658613,
87.815109]
server_time:1542702509,
tzshift:28800,
}

</syntaxhighlight>{{预警类型}}{{天气现象}}

=='''生活指数'''==
{{生活指数}}

=='''支持的单位制'''==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

通用预报接口/v2.5

2020-02-19T06:31:51Z

Mengqingye: Created page with "{{彩云天气 API 版本状态}} =='''授权与认证'''== 请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token..."

{{彩云天气 API 版本状态}}

=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</nowiki>
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

=== '''示例1如下''' ===
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</nowiki></code>

</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

=== '''示例2如下''' ===
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/weather?lang=en_US</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote><blockquote>'''返回周围预警: alert='''true (注意小写)</blockquote>

=='''返回结构和说明'''==
<blockquote>'''realtime'''分字段含义，请移步：[http://open.caiyunapp.com/%E5%AE%9E%E5%86%B5%E5%A4%A9%E6%B0%94%E6%8E%A5%E5%8F%A3/v2.2 实况接口/v2.2]</blockquote><blockquote>'''minutely'''分字段含义，请移步：[http://open.caiyunapp.com/%E7%9F%AD%E4%B8%B4%E9%99%8D%E6%B0%B4%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.2 逐分钟降水短临预报接口/v2.2]</blockquote><blockquote>'''hourly'''分字段含义，请移步：[[逐小时预报接口/v2.2]]</blockquote><blockquote>'''daily'''分字段含义，请移步：[[逐日预报接口/v2.2]]</blockquote><blockquote>'''alert'''分字段含义，如下：</blockquote><syntaxhighlight lang="javascript">

{ status:ok,
api_version:v2.2,
api_status:active,
unit:metric,
lang:en_US,
result:{
forecast_keypoint:cloudy, clear weather after 23 this midnight,
primary:0,
realtime:{status:ok, ###请参考：实况接口/v2.2
temperature:-1.21,
pres:56320.24,
humidity:0.09,
wind:{direction:284.91,speed:30.12}},
precipitation:{local:{status:ok,intensity:0.0,datasource:gfs}},
cloudrate:0.3,
dswrf:677.9,
visibility:24.1,

skycon:PARTLY_CLOUDY_DAY,
ultraviolet:{index:5.0,desc:Moderat},
comfort:{index:11,desc:Icy wind cold},

pm25:3,
pm10:10.0,
o3:97.0,
no2:2.0,
so2:7.0,
co:0.4,
aqi:10
},
minutely:{status:ok, ###请参考：逐分钟降水短临预报接口/v2.2
precipitation_2h:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],
precipitation:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],
datasource:gfs,
description:No snow in the next hour
},
hourly:{status:ok, ###请参考：逐小时预报接口/v2.2
description:cloudy, clear weather after 23 this midnight,
temperature:[{value:-1.21,datetime:2018-11-20 16:00},{value:-0.51,datetime:2018-11-20 17:00}]},
pres:[{value:56320.2411405722,datetime:2018-11-20 16:00},{value:56309.4272949293,datetime:2018-11-20 17:00}],
humidity:[{value:0.09,datetime:2018-11-20 16:00},{value:0.11,datetime:2018-11-20 17:00}],
wind:[{direction:284.91,speed:30.12,datetime:2018-11-20 16:00},{direction:288.24,speed:32.91,datetime:2018-11-20 17:00}],
precipitation:[{value:0.0,datetime:2018-11-20 16:00},{value:0.0,datetime:2018-11-20 17:00}],
cloudrate:[{value:0.3,datetime:2018-11-20 16:00},{value:0.3,datetime:2018-11-20 17:00}],
dswrf:[{value:677.9121814107,datetime:2018-11-20 16:00},{value:596.25984,datetime:2018-11-20 17:00}],
visibility:[{value:24.1,datetime:2018-11-20 16:00},{value:24.1,datetime:2018-11-20 17:00}],

skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 16:00},{value:WIND,datetime:2018-11-20 17:00}],
pm25:[{value:3,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],
aqi:[{value:10,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],
},
daily:{status:ok, ###请参考：逐日预报接口/v2.2
temperature:[{date:2018-11-20,max:1.19,avg:-4.35,min:-16.0},{date:2018-11-21,max:2.0,avg:-7.32,min:-18.0}],
pres:[{date:2018-11-20,max:56600.24,avg:56422.06,min:56309.43},{date:2018-11-21,max:56833.63,avg:56653.05,min:56553.63}],
humidity:[{date:2018-11-20,max:0.23,avg:0.14,min:0.09},{date:2018-11-21,max:0.15,avg:0.11,min:0.06}],
wind:[{date:2018-11-20,max:{direction:290.25,speed:35.9},avg:{direction:278.27,speed:19.65},min:{direction:230.17,speed:4.77}},
{date:2018-11-21,max:{direction:276.13,speed:43.0},avg:{direction:262.47,speed:24.54},min:{direction:216.1,speed:12.48}}],
precipitation:[{date:2018-11-20,max:0.0,avg:0.0,min:0.0},{date:2018-11-21,max:0.0,avg:0.0,min:0.0}],

dswrf:[{date:2018-11-20,max:743.7,avg:321.5,min:0.0},{date:2018-11-21,max:748.3,avg:202.3,min:0.0}],
cloudrate:[{date:2018-11-20,max:0.76,avg:0.49,min:0.0},{date:2018-11-21,max:0.15,avg:0.02,min:0.0}],
visibility:[{date:2018-11-20,max:24.1,avg:24.1,min:24.1},{date:2018-11-21,max:24.1,avg:24.1,min:24.1}],

skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:CLEAR_DAY}],
skycon_08h_20h:[{date:2018-11-20,value:CLEAR_DAY},{date:2018-11-21,value:CLEAR_DAY}]},
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:CLEAR_NIGHT}],
ultraviolet:[{index:5,desc:Very high,datetime:2018-11-20},{index:5,desc:Very high,datetime:2018-11-21}],
comfort:[{index:13,desc:Dry cold,datetime:2018-11-20},{index:13,desc:Dry cold,datetime:2018-11-21}],
carWashing:[{index:1,desc:Suitable,datetime:2018-11-20},{index:1,desc:Suitable,datetime:2018-11-21}],
coldRisk:[{index:4,desc:Extremely prone,datetime:2018-11-20},{index:4,desc:Extremely prone,datetime:2018-11-21}],
dressing:[{index:8,desc:Extremely cold,datetime:2018-11-20},{index:8,desc:Extremely cold,datetime:2018-11-21}],

pm25:[{date:2018-11-20,max:3,avg:1.12,min:0},{date:2018-11-21,max:1,avg:0.58,min:0}],
aqi:[{date:2018-11-20,max:10,avg:1.25,min:0},{date:2018-11-21,max:0,avg:0.0,min:0}],

astro:[{date:2018-11-20,sunset:{time:19:07},sunrise:{time:08:40}},{date:2018-11-21,sunset:{time:19:07},sunrise:{time:08:41}}],
},
alert:{alert:{status:"ok"
content:{
0:{ request_status: "ok",
source: "国家预警信息发布中心",

county: "无",
province: "江苏省",
regionId: "unknown"
city: "南京市",
code: "1303", ##预警类型code
adcode: "320100",

alertId: "32010041600000_20181130104521",
status: "预警中",
title: "南京市气象台发布霾橙色预警[Ⅱ级/严重]",
description: "南京市气象台2018年11月30日10时41分升级霾黄色预警信号为霾橙色预警信号。目前我市已经出现中度霾，预计未来24小时内霾将持续，请注意防范。"

location: "江苏省南京市",
latlon: {
0: 32.060255,
1: 118.796877
}
pubtimestamp: 1543545921,
}
}
}
},
location:[31.658613,
87.815109]
server_time:1542702509,
tzshift:28800,
}

</syntaxhighlight>{{预警类型}}{{天气现象}}

=='''生活指数'''==
{{生活指数}}

=='''支持的单位制'''==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

通用预报接口

2020-02-19T06:31:35Z

Mengqingye: Redirected page to 通用预报接口/v2.5

#REDIRECT [[通用预报接口/v2.5]]

天级预报接口/v2.5

2020-02-19T06:30:56Z

Mengqingye:

{{彩云天气 API 版本状态}}

=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

=== '''示例1如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>

</blockquote><blockquote>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.jsonp?callback=MYCALLBACK</blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

=== '''示例2如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json?lang=en_US&dailysteps=360</code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''定制返回逐日预报总日数 dailysteps'''：默认为5日</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，v2.3之后版本，返回时区信息，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote>
==返回结构和说明==
<syntaxhighlight lang="javascript">
{ status:ok, // 返回状态
api_version:v2.5, // 版本号
api_status:active, // 版本号状态
lang:en_US, // 语言
unit:metric, // 单位制
result:{
primary:0,
daily:{
status:ok, // 逐日预报模块返回状态
temperature:[{date:2018-11-20,max:23.0,avg:20.37,min:20.0},{date:2018-11-21,max:26.0,avg:22.97,min:20.33}], // 温度，最大值，平均值，最小值
pres:[{date:2018-11-20,max:100519.86,avg:100238.05,min:100119.53},{date:2018-11-21,max:100470.46,avg:100214.34,min:99940.79}], // 气压，最大值，平均值，最小值
humidity:[{date:2018-11-20,max:0.86,avg:0.84,min:0.76},{date:2018-11-21,max:0.87,avg:0.79,min:0.68}], // 相对湿度，最大值，平均值，最小值
wind:[{ date:2018-11-20,
max:{direction:70.43,speed:24.17}, // 风速，最大值，平均值，最小值
avg:{direction:101.11,speed:21.81},
min:{direction:148.08,speed:14.8}},
{ date:2018-11-21,
max:{direction:19.36,speed:29.25},
avg:{direction:24.59,speed:14.73},
min:{direction:254.91,speed:2.53}}],
precipitation:[{date:2018-11-20,max:0.0699,avg:0.0,min:0.0},{date:2018-11-21,max:0.2583,avg:0.0581,min:0.0}], // 本地降水强度，最大值，平均值，最小值(单位见表格)

cloudrate:[{date:2018-11-20,max:0.91,avg:0.62,min:0.18},{date:2018-11-21,max:1.0,avg:0.45,min:0.0}], // 云量，最大值，平均值，最小值
dswrf:[{date:2018-11-20,max:344.1,avg:84.0,min:0.0},{date:2018-11-21,max:601.5,avg:197.7,min:0.0}], // 短波辐射，最大值，平均值，最小值
visibility:[{date:2018-11-20,max:24.1,avg:22.9,min:14.2},{date:2018-11-21,max:24.1,avg:20.4,min:13.7}], // 能见度，最大值，平均值，最小值

skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:PARTLY_CLOUDY_DAY}], // 全天，主要天气现象
skycon_08h_20h:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:PARTLY_CLOUDY_DAY}] // 白天，主要天气现象
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:RAIN}], // 夜晚，主要天气现象

ultraviolet:[{index:3,desc:Moderat,datetime:2018-11-20},{index:3,desc:Moderat,datetime:2018-11-21}], // 午间，紫外线指数和自然语言描述
comfort:[{index:4,desc:Warm,datetime:2018-11-20},{index:4,desc:Warm,datetime:2018-11-21}], // 全天，舒适度指数和自然语言描述
carWashing:[{index:3,desc:Less appropriate,datetime:2018-11-20},{index:3,desc:Less appropriate,datetime:2018-11-21}], // 全天，洗车指数和自然语言描述
coldRisk:[{index:3,desc:Prone,datetime:2018-11-20},{index:3,desc:Prone,datetime:2018-11-21}], // 全天，感冒指数和自然语言描述
dressing:[{index:5,desc:Cool,datetime:2018-11-20},{index:3,desc:Hot,datetime:2018-11-21}], // 全天，冷暖指数和自然语言描述（淘汰...）

pm25:[{date:2018-11-20,max:20,avg:15.62,min:8},{date:2018-11-21,max:28,avg:22.29,min:12}], // PM2.5，最大值，平均值，最小值
aqi:[{date:2018-11-20,max:42,avg:24.08,min:14},{date:2018-11-21,max:40,avg:31.75,min:17}], // AQI(国标)，最大值，平均值，最小值

astro:[{date:2018-11-20,
sunset:{time:17:04},
sunrise:{time:06:13}},
{date:2018-11-21,
sunset:{time:17:04}, // 日出时间(北京时间，tzshift不作用在这个变量)
sunrise:{time:06:14}}], // 日出时间(返回北京时间，tzshift不作用在这个变量)
}
},
location:[25.1552,
121.6544], // 经纬度
server_time:1542698313, // 服务器本次返回的utc时间戳
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒
}

</syntaxhighlight>

=='''变量说明'''==
<blockquote>逐日预报，没有逐日预报的自然语言描述字段</blockquote>
{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.daily.temperature[max,min,avg] || 温度 || 逐日预报 || 全球 || 地表2米气温
|-
! 气压
| $.result.daily.pres[max,min,avg] || 气压(Pa) || 逐日预报 || 全球 || 地面气压
|-
! 相对湿度
| $.result.daily.humidity[max,min,avg] || 相对湿度(%) || 逐日预报 || 全球 || 地表2米湿度
|-
! 风速
| $.result.daily.wind.speed[max,min,avg] || 风速 || 逐日预报 || 全球 || 地表10米风速
|-
! 本地降水强度
| $.result.daily.precipitation[max,min,avg] || 降水量(mm/h) || 逐日预报 || 全球 || 本地降水量
|-
! 云量
| $.result.daily.cloudrate[max,min,avg] || 云量(0.0-1.0) || 逐日预报 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.daily.dswrf[max,min,avg]|| 向下短波辐射通量(W/M2) || 逐日预报 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.daily.visibility[max,min,avg] || 能见度 || 逐日预报 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 全天主要天气现象
| $.result.daily.skycon.value || 天气状况 || 逐日预报 || 全球 || 全天主要天气现象
|-
! 白天主要天气现象
| $.result.daily.skycon_08h_20h.value|| 天气状况 || 逐日预报 || 全球 || 白天主要天气现象
|-
! 夜晚主要天气现象
| $.result.daily.skycon_20h_32h.value|| 天气状况 || 逐日预报 || 全球 || 夜晚主要天气现象
|-
! 紫外线指数
| $.result.daily.ultraviolet.desc|| 紫外线指数自然语言 || 逐日预报 || 全球 || 紫外线指数及其描述
|-
! 舒适度指数
| $.result.daily.comfort.desc|| 舒适度指数自然语言 || 逐日预报 || 全球 || 舒适度指数及其描述
|-
! 洗车指数
| $.result.daily.carWashing.desc|| 洗车指数自然语言 || 逐日预报 || 全球 || 洗车指数及其描述
|-
! 感冒指数
| $.result.daily.coldRisk.desc|| 感冒指数自然语言 || 逐日预报 || 全球 || 感冒指数及其描述
|-
! 穿衣指数
| $.result.daily.dressing.desc|| 冷热指数自然语言 || 逐日预报 || 全球 || 穿衣指数（dressing），不建议继续使用，请使用舒适度
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.daily.pm25[max,min,avg] || PM25浓度(μg/m3) || 逐日预报 || 大陆、港澳台、暂无印度 || PM25浓度
|-
! AQI
| $.result.daily.aqi[max,min,avg] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 国标AQI
|-
!
!
!
!
!
!
|-
! 日出日落
| $.result.astro.aqi[sunrise,sunset] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 日出日落(当地时区的时刻，tzshift不作用在这个变量)
|}
{{天气现象}}

=='''生活指数'''==
{{生活指数}}

==支持的单位制==
{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

天级预报接口/v2.5

2020-02-19T06:29:28Z

{{彩云天气 API 版本状态}}

=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</nowiki>
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

=== '''示例1如下''' ===
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</nowiki></code>

</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

=== '''示例2如下''' ===
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json?lang=en_US&dailysteps=360</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''定制返回逐日预报总日数 dailysteps'''：默认为5日</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，v2.3之后版本，返回时区信息，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote>
==返回结构和说明==
<syntaxhighlight lang="javascript">
{ status:ok, // 返回状态
api_version:v2.2, // 版本号
api_status:active, // 版本号状态
lang:en_US, // 语言
unit:metric, // 单位制
result:{
primary:0,
daily:{
status:ok, // 逐日预报模块返回状态
temperature:[{date:2018-11-20,max:23.0,avg:20.37,min:20.0},{date:2018-11-21,max:26.0,avg:22.97,min:20.33}], // 温度，最大值，平均值，最小值
pres:[{date:2018-11-20,max:100519.86,avg:100238.05,min:100119.53},{date:2018-11-21,max:100470.46,avg:100214.34,min:99940.79}], // 气压，最大值，平均值，最小值
humidity:[{date:2018-11-20,max:0.86,avg:0.84,min:0.76},{date:2018-11-21,max:0.87,avg:0.79,min:0.68}], // 相对湿度，最大值，平均值，最小值
wind:[{ date:2018-11-20,
max:{direction:70.43,speed:24.17}, // 风速，最大值，平均值，最小值
avg:{direction:101.11,speed:21.81},
min:{direction:148.08,speed:14.8}},
{ date:2018-11-21,
max:{direction:19.36,speed:29.25},
avg:{direction:24.59,speed:14.73},
min:{direction:254.91,speed:2.53}}],
precipitation:[{date:2018-11-20,max:0.0699,avg:0.0,min:0.0},{date:2018-11-21,max:0.2583,avg:0.0581,min:0.0}], // 本地降水强度，最大值，平均值，最小值(单位见表格)

cloudrate:[{date:2018-11-20,max:0.91,avg:0.62,min:0.18},{date:2018-11-21,max:1.0,avg:0.45,min:0.0}], // 云量，最大值，平均值，最小值
dswrf:[{date:2018-11-20,max:344.1,avg:84.0,min:0.0},{date:2018-11-21,max:601.5,avg:197.7,min:0.0}], // 短波辐射，最大值，平均值，最小值
visibility:[{date:2018-11-20,max:24.1,avg:22.9,min:14.2},{date:2018-11-21,max:24.1,avg:20.4,min:13.7}], // 能见度，最大值，平均值，最小值

skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:PARTLY_CLOUDY_DAY}], // 全天，主要天气现象
skycon_08h_20h:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:PARTLY_CLOUDY_DAY}] // 白天，主要天气现象
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:RAIN}], // 夜晚，主要天气现象

ultraviolet:[{index:3,desc:Moderat,datetime:2018-11-20},{index:3,desc:Moderat,datetime:2018-11-21}], // 午间，紫外线指数和自然语言描述
comfort:[{index:4,desc:Warm,datetime:2018-11-20},{index:4,desc:Warm,datetime:2018-11-21}], // 全天，舒适度指数和自然语言描述
carWashing:[{index:3,desc:Less appropriate,datetime:2018-11-20},{index:3,desc:Less appropriate,datetime:2018-11-21}], // 全天，洗车指数和自然语言描述
coldRisk:[{index:3,desc:Prone,datetime:2018-11-20},{index:3,desc:Prone,datetime:2018-11-21}], // 全天，感冒指数和自然语言描述
dressing:[{index:5,desc:Cool,datetime:2018-11-20},{index:3,desc:Hot,datetime:2018-11-21}], // 全天，冷暖指数和自然语言描述（淘汰...）

pm25:[{date:2018-11-20,max:20,avg:15.62,min:8},{date:2018-11-21,max:28,avg:22.29,min:12}], // PM2.5，最大值，平均值，最小值
aqi:[{date:2018-11-20,max:42,avg:24.08,min:14},{date:2018-11-21,max:40,avg:31.75,min:17}], // AQI(国标)，最大值，平均值，最小值

astro:[{date:2018-11-20,
sunset:{time:17:04},
sunrise:{time:06:13}},
{date:2018-11-21,
sunset:{time:17:04}, // 日出时间(北京时间，tzshift不作用在这个变量)
sunrise:{time:06:14}}], // 日出时间(返回北京时间，tzshift不作用在这个变量)
}
},
location:[25.1552,
121.6544], // 经纬度
server_time:1542698313, // 服务器本次返回的utc时间戳
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒
}

</syntaxhighlight>

=='''变量说明'''==
<blockquote>逐日预报，没有逐日预报的自然语言描述字段</blockquote>
{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.daily.temperature[max,min,avg] || 温度 || 逐日预报 || 全球 || 地表2米气温
|-
! 气压
| $.result.daily.pres[max,min,avg] || 气压(Pa) || 逐日预报 || 全球 || 地面气压
|-
! 相对湿度
| $.result.daily.humidity[max,min,avg] || 相对湿度(%) || 逐日预报 || 全球 || 地表2米湿度
|-
! 风速
| $.result.daily.wind.speed[max,min,avg] || 风速 || 逐日预报 || 全球 || 地表10米风速
|-
! 本地降水强度
| $.result.daily.precipitation[max,min,avg] || 降水量(mm/h) || 逐日预报 || 全球 || 本地降水量
|-
! 云量
| $.result.daily.cloudrate[max,min,avg] || 云量(0.0-1.0) || 逐日预报 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.daily.dswrf[max,min,avg]|| 向下短波辐射通量(W/M2) || 逐日预报 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.daily.visibility[max,min,avg] || 能见度 || 逐日预报 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 全天主要天气现象
| $.result.daily.skycon.value || 天气状况 || 逐日预报 || 全球 || 全天主要天气现象
|-
! 白天主要天气现象
| $.result.daily.skycon_08h_20h.value|| 天气状况 || 逐日预报 || 全球 || 白天主要天气现象
|-
! 夜晚主要天气现象
| $.result.daily.skycon_20h_32h.value|| 天气状况 || 逐日预报 || 全球 || 夜晚主要天气现象
|-
! 紫外线指数
| $.result.daily.ultraviolet.desc|| 紫外线指数自然语言 || 逐日预报 || 全球 || 紫外线指数及其描述
|-
! 舒适度指数
| $.result.daily.comfort.desc|| 舒适度指数自然语言 || 逐日预报 || 全球 || 舒适度指数及其描述
|-
! 洗车指数
| $.result.daily.carWashing.desc|| 洗车指数自然语言 || 逐日预报 || 全球 || 洗车指数及其描述
|-
! 感冒指数
| $.result.daily.coldRisk.desc|| 感冒指数自然语言 || 逐日预报 || 全球 || 感冒指数及其描述
|-
! 穿衣指数
| $.result.daily.dressing.desc|| 冷热指数自然语言 || 逐日预报 || 全球 || 穿衣指数（dressing），不建议继续使用，请使用舒适度
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.daily.pm25[max,min,avg] || PM25浓度(μg/m3) || 逐日预报 || 大陆、港澳台、暂无印度 || PM25浓度
|-
! AQI
| $.result.daily.aqi[max,min,avg] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 国标AQI
|-
!
!
!
!
!
!
|-
! 日出日落
| $.result.astro.aqi[sunrise,sunset] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 日出日落(当地时区的时刻，tzshift不作用在这个变量)
|}
{{天气现象}}

=='''生活指数'''==
{{生活指数}}

==支持的单位制==
{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

天级预报接口

2020-02-19T06:28:56Z

Mengqingye: Redirected page to 天级预报接口/v2.5

#REDIRECT [[天级预报接口/v2.5]]

小时级预报接口/v2.5

2020-02-19T06:28:10Z

Mengqingye:

{{彩云天气 API 版本状态}}

=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

=== '''示例1如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>

</blockquote><blockquote>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.jsonp?callback=MYCALLBACK</blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

=== '''示例2如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly?lang=en_US&hourlysteps=2</code></blockquote><blockquote>'''语言选项 lang：'''简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote>
==返回结构和说明==
<syntaxhighlight lang="javascript">

{ status:ok,
api_version:v2.5, // 版本号
api_status:active, // 版本号状态
lang:en_US, // 语言
unit:metric, // 单位制
result:{
hourly:{
status:ok, // 逐小时预报模块返回状态
temperature:[{value:23.0,datetime:2018-11-20 10:00},{value:22.0,datetime:2018-11-20 11:00}]}, // 温度
pres:[{value:100279.8643200001,datetime:2018-11-20 10:00},{value:100249.1918336001,datetime:2018-11-20 11:00}], // 气压
humidity:[{value:0.77,datetime:2018-11-20 10:00},{value:0.77,datetime:2018-11-20 11:00}], // 相对湿度
wind:[ { direction:95.62, // 风向，单位是度。正北方向为0度，顺时针增加到360度。
speed:22.85,datetime:2018-11-20 10:00}, // 风速，米制下是公里每小时
{ direction:97.97,
speed:23.27,datetime:2018-11-20 11:00}],
precipitation:[{value:0.0,datetime:2018-11-20 10:00},{value:0.0,datetime:2018-11-20 11:00}], // 本地降水强度(单位见表格)
cloudrate:[{value:0.77,datetime:2018-11-20 10:00},{value:0.46,datetime:2018-11-20 11:00}], // 云量
dswrf:[{value:344.09456384,datetime:2018-11-20 10:00},{value:325.9617024,datetime:2018-11-20 11:00}], // 短波辐射
visibility:[{value:23.24,datetime:2018-11-20 10:00},{value:23.0,datetime:2018-11-20 11:00}], // 能见度

skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 10:00},{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 11:00}], // 主要天气现象
description:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness, // 逐小时天气预报，自然语言描述
forecast_keypoint:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness,primary:0， // 逐小时和逐分钟天气预报，综合自然语言描述

pm25:[{value:8,datetime:2018-11-20 10:00},{value:9,datetime:2018-11-20 11:00}], // PM2.5
aqi:[{value:33,datetime:2018-11-20 10:00},{value:13,datetime:2018-11-20 11:00}] // AQI(国标)
},
location:[25.1552,
121.6544] // 经纬度
server_time:1542695724, // 服务器本次返回的utc时间戳
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒
}

</syntaxhighlight>

=='''变量说明'''==
<blockquote>逐小时预报，没有生活指数变量</blockquote>
{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.hourly.temperature.value || 温度 || 逐小时预报 || 全球 || 地表2米气温
|-
! 气压
| $.result.hourly.pres.value || 气压(Pa) || 逐小时预报 || 全球 || 地面气压
|-
! 相对湿度
| $.result.hourly.humidity.value || 相对湿度(%) || 逐小时预报 || 全球 || 地表2米湿度
|-
! 风向
| $.result.hourly.wind.direction.value || 风向 || 逐小时预报 || 全球 || 地表10米风向
|-
! 风速
| $.result.hourly.wind.speed.value || 风速 || 逐小时预报 || 全球 || 地表10米风速
|-
! 本地降水强度
| $.result.hourly.precipitation.value || 降水量(mm/h) || 逐小时预报 || 全球 || 本地降水量
|-
! 云量
| $.result.hourly.cloudrate.value || 云量(0.0-1.0) || 逐小时预报 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.hourly.dswrf.value|| 向下短波辐射通量(W/M2) || 逐小时预报 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.hourly.visibility.value || 能见度 || 逐小时预报 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 主要天气现象
| $.result.hourly.skycon.value || 天气状况 || 逐小时预报 || 全球 || 天气状况
|-
! 逐小时预报自然语言描述
| $.result.hourly.description || 舒适度指数自然语言 || 逐小时预报 || 全球 || 舒适度指数及其描述
|-
! 综合预报自然语言描述
| $.result.hourly.forecast_keypoint || 紫外线指数自然语言 || 逐小时预报 || 全球 || 逐小时和逐分钟天气预报，综合自然语言描述
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.hourly.pm25.value || PM25浓度(μg/m3) || 逐小时预报 || 大陆、港澳台、暂无印度 || PM25浓度
|-
! AQI
| $.result.hourly.aqi.value || 国标AQI || 逐小时预报 || 大陆、港澳台、暂无印度 || 国标AQI
|}
{{天气现象}}

==支持的单位制==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

小时级预报接口/v2.5

2020-02-19T06:26:30Z

{{彩云天气 API 版本状态}}

=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki>
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

=== '''示例1如下''' ===
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki></code>

</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

=== '''示例2如下''' ===
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly?lang=en_US&hourlysteps=2</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote>
==返回结构和说明==
<syntaxhighlight lang="javascript">

{ status:ok,
api_version:v2.2, // 版本号
api_status:active, // 版本号状态
lang:en_US, // 语言
unit:metric, // 单位制
result:{
hourly:{
status:ok, // 逐小时预报模块返回状态
temperature:[{value:23.0,datetime:2018-11-20 10:00},{value:22.0,datetime:2018-11-20 11:00}]}, // 温度
pres:[{value:100279.8643200001,datetime:2018-11-20 10:00},{value:100249.1918336001,datetime:2018-11-20 11:00}], // 气压
humidity:[{value:0.77,datetime:2018-11-20 10:00},{value:0.77,datetime:2018-11-20 11:00}], // 相对湿度
wind:[ { direction:95.62, // 风向，单位是度。正北方向为0度，顺时针增加到360度。
speed:22.85,datetime:2018-11-20 10:00}, // 风速，米制下是公里每小时
{ direction:97.97,
speed:23.27,datetime:2018-11-20 11:00}],
precipitation:[{value:0.0,datetime:2018-11-20 10:00},{value:0.0,datetime:2018-11-20 11:00}], // 本地降水强度(单位见表格)
cloudrate:[{value:0.77,datetime:2018-11-20 10:00},{value:0.46,datetime:2018-11-20 11:00}], // 云量
dswrf:[{value:344.09456384,datetime:2018-11-20 10:00},{value:325.9617024,datetime:2018-11-20 11:00}], // 短波辐射
visibility:[{value:23.24,datetime:2018-11-20 10:00},{value:23.0,datetime:2018-11-20 11:00}], // 能见度

skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 10:00},{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 11:00}], // 主要天气现象
description:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness, // 逐小时天气预报，自然语言描述
forecast_keypoint:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness,primary:0， // 逐小时和逐分钟天气预报，综合自然语言描述

pm25:[{value:8,datetime:2018-11-20 10:00},{value:9,datetime:2018-11-20 11:00}], // PM2.5
aqi:[{value:33,datetime:2018-11-20 10:00},{value:13,datetime:2018-11-20 11:00}] // AQI(国标)
},
location:[25.1552,
121.6544] // 经纬度
server_time:1542695724, // 服务器本次返回的utc时间戳
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒
}

</syntaxhighlight>

=='''变量说明'''==
<blockquote>逐小时预报，没有生活指数变量</blockquote>
{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.hourly.temperature.value || 温度 || 逐小时预报 || 全球 || 地表2米气温
|-
! 气压
| $.result.hourly.pres.value || 气压(Pa) || 逐小时预报 || 全球 || 地面气压
|-
! 相对湿度
| $.result.hourly.humidity.value || 相对湿度(%) || 逐小时预报 || 全球 || 地表2米湿度
|-
! 风向
| $.result.hourly.wind.direction.value || 风向 || 逐小时预报 || 全球 || 地表10米风向
|-
! 风速
| $.result.hourly.wind.speed.value || 风速 || 逐小时预报 || 全球 || 地表10米风速
|-
! 本地降水强度
| $.result.hourly.precipitation.value || 降水量(mm/h) || 逐小时预报 || 全球 || 本地降水量
|-
! 云量
| $.result.hourly.cloudrate.value || 云量(0.0-1.0) || 逐小时预报 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.hourly.dswrf.value|| 向下短波辐射通量(W/M2) || 逐小时预报 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.hourly.visibility.value || 能见度 || 逐小时预报 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 主要天气现象
| $.result.hourly.skycon.value || 天气状况 || 逐小时预报 || 全球 || 天气状况
|-
! 逐小时预报自然语言描述
| $.result.hourly.description || 舒适度指数自然语言 || 逐小时预报 || 全球 || 舒适度指数及其描述
|-
! 综合预报自然语言描述
| $.result.hourly.forecast_keypoint || 紫外线指数自然语言 || 逐小时预报 || 全球 || 逐小时和逐分钟天气预报，综合自然语言描述
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.hourly.pm25.value || PM25浓度(μg/m3) || 逐小时预报 || 大陆、港澳台、暂无印度 || PM25浓度
|-
! AQI
| $.result.hourly.aqi.value || 国标AQI || 逐小时预报 || 大陆、港澳台、暂无印度 || 国标AQI
|}
{{天气现象}}

==支持的单位制==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

小时级预报接口

2020-02-19T06:25:45Z

Mengqingye: Redirected page to 小时级预报接口/v2.5

#REDIRECT [[小时级预报接口/v2.5]]

分钟级降雨预报接口/v2.5

2020-02-19T06:23:28Z

Mengqingye:

分钟级降雨预报接口/v2.5

2020-02-19T06:22:58Z

Mengqingye:

实况天气接口/v2.5

2020-02-19T06:15:40Z

Mengqingye:

{{彩云天气 API 版本状态}}

=='''授权与认证'''==

请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
<nowiki>https://api.caiyunapp.com/v2.5</nowiki><nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

===== 示例1如下 =====
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</nowiki> </code></blockquote><blockquote><code> <nowiki>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.jsonp?callback=MYCALLBACK</nowiki></code></blockquote><blockquote>'''token ：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

==== 示例2如下 ====
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json?lang=en_US</nowiki> </code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote>

=='''返回结构和说明'''==
<syntaxhighlight lang="yaml">

status: ok
api_version: v2.5 # 版本号
api_status: active # 版本号状态
lang: zh_CN # 语言
unit: metric # 单位制
location: [25.1552 121.6544] # 经纬度
server_time: 1443418222 # 服务器本次返回的utc时间戳
tzshift: 28800 # 时区的偏移秒数，如东八区就是 28800 秒
result:
realtime:
status: ok # 实况模块返回状态
temperature: 28.0 # 温度
pres: 100991.3 # 气压
humidity: 0.92 # 相对湿度
wind:
direction: 25.33 # 风向，单位是度。正北方向为0度，顺时针增加到360度。
speed: 83.3 # 风速，米制下是公里每小时
precipitation:
nearest:
status: ok
distance: 0.77 # 最近的降水带距离
intensity: 0.3125 # 最近的降水带降水强度（单位为雷达降水强度）
local:
status: ok
intensity: 0.2812 # 本地降水强度（单位为雷达降水强度）
datasource: radar # 本地降水观测的数据源（radar，GFS）
cloudrate: 0.51 # 云量
dswrf: 8.3 # 向下短波辐射通量
visibility: 8.3 # 能见度
skycon: RAIN # 主要天气现象
life_index:
comfort: # 舒适度指数及其自然语言描述
index: 7
desc: 冷
ultraviolet: # 紫外线指数及其自然语言描述
index: 0
desc: 无
air_quality:
pm25: 18 # pm25，质量浓度值
pm10: 46 # pm10，质量浓度值
o3: 47 # 臭氧，质量浓度值
no2: 14 # 二氧化氮，质量浓度值
so2: 1 # 二氧化硫，质量浓度值
co: 0.3 # 一氧化碳，质量浓度值
aqi:
chn: 8 # AQI（中国标准）
usa: 0 # AQI（美国标准）
description:
usa: ""
chn: "优"

</syntaxhighlight>

=='''变量说明'''==

{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.temperature || 温度 || 实况 || 全球 || 地表2米气温
|-
! 气压
| $.result.pres || 气压(Pa) || 实况 || 全球 || 地面气压
|-
! 相对湿度
| $.result.humidity || 相对湿度(%) || 实况 || 全球 || 地表2米湿度
|-
! 风向
| $.result.wind.direction || 风向 || 实况 || 全球 || 地表10米风向
|-
! 风速
| $.result.wind.speed || 风速 || 实况 || 全球 || 地表10米风速
|-
! 最近降水距离
| $.result.precipitation.nearest.distance || 距离 || 实况 || 全球 || 最近降水带与本地的距离
|-
! 最近降水强度
| $.result.precipitation.nearest.intensity || 降水强度 || 实况 || 全球 || 最近降水处的降水强度
|-
! 本地降水强度
| $.result.precipitation.local.intensity || 雷达降水强度 || 实况 || 全球 || 最近降水处的降水强度
|-
! 云量
| $.result.cloudrate || 云量(0.0-1.0) || 实况 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.dswrf|| 向下短波辐射通量(W/M2) || 实况 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.visibility || 能见度 || 实况 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 天气状况
| $.result.skycon || 天气状况 || 实况 || 全球 || 天气状况
|-
! 舒适度指数
| $.result.comfort.index || 舒适度指数自然语言 || 实况 || 全球 || 舒适度指数及其描述
|-
! 紫外线指数
| $.result.ultraviolet.index || 紫外线指数自然语言 || 实况 || 全球 || 紫外线指数及其描述
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.pm25 || PM25浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM25浓度
|-
! PM10浓度
| $.result.pm10 || PM10浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM10浓度
|-
! 臭氧浓度
| $.result.o3 || 臭氧浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 臭氧浓度
|-
! 二氧化氮浓度
| $.result.no2 || 二氧化氮浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化氮浓度
|-
! 二氧化硫浓度
| $.result.so2 || 二氧化硫浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化硫浓度
|-
! 一氧化碳浓度
| $.result.co || 一氧化碳浓度(mg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 一氧化碳浓度
|-
! AQI
| $.result.aqi || 国标AQI || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 国标AQI
|}
{{天气现象}}

=='''生活指数'''==
{{生活指数}}

=='''支持的单位制'''==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

实况天气接口/v2.5

2020-02-19T06:01:55Z

Mengqingye:

{{彩云天气 API 版本状态}}

=='''授权与认证'''==

请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
https://api.caiyunapp.com/v2.5<nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

===== 示例1如下 =====
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</nowiki> </code></blockquote><blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.jsonp?callback=MYCALLBACK</nowiki></code></blockquote><blockquote>'''token ：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

==== 示例2如下 ====
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json?lang=en_US</nowiki> </code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote>

=='''返回结构和说明'''==
<syntaxhighlight lang="yaml">

status: ok
api_version: v2.2 # 版本号
api_status: active # 版本号状态
lang: zh_CN # 语言
unit: metric # 单位制
location: [25.1552 121.6544] # 经纬度
server_time: 1443418222 # 服务器本次返回的utc时间戳
tzshift: 28800 # 时区的偏移秒数，如东八区就是 28800 秒
result:
status: ok # 实况模块返回状态
temperature: 28.0 # 温度
pres: 100991.3 # 气压
humidity: 0.92 # 相对湿度
wind:
direction: 25.33 # 风向，单位是度。正北方向为0度，顺时针增加到360度。
speed: 83.3 # 风速，米制下是公里每小时
precipitation:
nearest:
status: ok
distance: 0.77 # 最近的降水带距离
intensity: 0.3125 # 最近的降水带降水强度（单位为雷达降水强度）
local:
status: ok
intensity: 0.2812 # 本地降水强度（单位为雷达降水强度）
datasource: radar # 本地降水观测的数据源（radar，GFS）
cloudrate: 0.51 # 云量
dswrf: 8.3 # 向下短波辐射通量
visibility: 8.3 # 能见度
skycon: RAIN # 主要天气现象
comfort: # 舒适度指数及其自然语言描述
index: 7
desc: 冷
ultraviolet: # 紫外线指数及其自然语言描述
index: 0
desc: 无
pm25: 18 # pm25，质量浓度值
pm10: 46 # pm10，质量浓度值
o3: 47 # 臭氧，质量浓度值
no2: 14 # 二氧化氮，质量浓度值
so2: 1 # 二氧化硫，质量浓度值
co: 0.3 # 一氧化碳，质量浓度值
aqi: 46 # AQI（国标）

</syntaxhighlight>

=='''变量说明'''==

{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.temperature || 温度 || 实况 || 全球 || 地表2米气温
|-
! 气压
| $.result.pres || 气压(Pa) || 实况 || 全球 || 地面气压
|-
! 相对湿度
| $.result.humidity || 相对湿度(%) || 实况 || 全球 || 地表2米湿度
|-
! 风向
| $.result.wind.direction || 风向 || 实况 || 全球 || 地表10米风向
|-
! 风速
| $.result.wind.speed || 风速 || 实况 || 全球 || 地表10米风速
|-
! 最近降水距离
| $.result.precipitation.nearest.distance || 距离 || 实况 || 全球 || 最近降水带与本地的距离
|-
! 最近降水强度
| $.result.precipitation.nearest.intensity || 降水强度 || 实况 || 全球 || 最近降水处的降水强度
|-
! 本地降水强度
| $.result.precipitation.local.intensity || 雷达降水强度 || 实况 || 全球 || 最近降水处的降水强度
|-
! 云量
| $.result.cloudrate || 云量(0.0-1.0) || 实况 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.dswrf|| 向下短波辐射通量(W/M2) || 实况 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.visibility || 能见度 || 实况 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 天气状况
| $.result.skycon || 天气状况 || 实况 || 全球 || 天气状况
|-
! 舒适度指数
| $.result.comfort.index || 舒适度指数自然语言 || 实况 || 全球 || 舒适度指数及其描述
|-
! 紫外线指数
| $.result.ultraviolet.index || 紫外线指数自然语言 || 实况 || 全球 || 紫外线指数及其描述
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.pm25 || PM25浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM25浓度
|-
! PM10浓度
| $.result.pm10 || PM10浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM10浓度
|-
! 臭氧浓度
| $.result.o3 || 臭氧浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 臭氧浓度
|-
! 二氧化氮浓度
| $.result.no2 || 二氧化氮浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化氮浓度
|-
! 二氧化硫浓度
| $.result.so2 || 二氧化硫浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化硫浓度
|-
! 一氧化碳浓度
| $.result.co || 一氧化碳浓度(mg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 一氧化碳浓度
|-
! AQI
| $.result.aqi || 国标AQI || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 国标AQI
|}
{{天气现象}}

=='''生活指数'''==
{{生活指数}}

=='''支持的单位制'''==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

Template:彩云天气 API 版本状态

2020-02-19T06:01:14Z

Mengqingye:

''本文版本：[[{{FULLPAGENAME}}|{{SUBPAGENAME}}]]，当前稳定版本版本：[[彩云天气 API/v2.5|v2.5]]，历史版本：[[彩云天气 API/v2.2|v2.2]]，[[彩云天气 API/v2.3|v2.3]]，和 [[彩云天气 API/v2.4|v2.4]]。''

实况天气接口/v2.5

2020-02-19T06:00:06Z

{{彩云天气 API 版本状态}}

=='''授权与认证'''==

请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</nowiki>
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

===== 示例1如下 =====
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</nowiki> </code></blockquote><blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.jsonp?callback=MYCALLBACK</nowiki></code></blockquote><blockquote>'''token ：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

==== 示例2如下 ====
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json?lang=en_US</nowiki> </code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI）、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote>

=='''返回结构和说明'''==
<syntaxhighlight lang="yaml">

status: ok
api_version: v2.2 # 版本号
api_status: active # 版本号状态
lang: zh_CN # 语言
unit: metric # 单位制
location: [25.1552 121.6544] # 经纬度
server_time: 1443418222 # 服务器本次返回的utc时间戳
tzshift: 28800 # 时区的偏移秒数，如东八区就是 28800 秒
result:
status: ok # 实况模块返回状态
temperature: 28.0 # 温度
pres: 100991.3 # 气压
humidity: 0.92 # 相对湿度
wind:
direction: 25.33 # 风向，单位是度。正北方向为0度，顺时针增加到360度。
speed: 83.3 # 风速，米制下是公里每小时
precipitation:
nearest:
status: ok
distance: 0.77 # 最近的降水带距离
intensity: 0.3125 # 最近的降水带降水强度（单位为雷达降水强度）
local:
status: ok
intensity: 0.2812 # 本地降水强度（单位为雷达降水强度）
datasource: radar # 本地降水观测的数据源（radar，GFS）
cloudrate: 0.51 # 云量
dswrf: 8.3 # 向下短波辐射通量
visibility: 8.3 # 能见度
skycon: RAIN # 主要天气现象
comfort: # 舒适度指数及其自然语言描述
index: 7
desc: 冷
ultraviolet: # 紫外线指数及其自然语言描述
index: 0
desc: 无
pm25: 18 # pm25，质量浓度值
pm10: 46 # pm10，质量浓度值
o3: 47 # 臭氧，质量浓度值
no2: 14 # 二氧化氮，质量浓度值
so2: 1 # 二氧化硫，质量浓度值
co: 0.3 # 一氧化碳，质量浓度值
aqi: 46 # AQI（国标）

</syntaxhighlight>

=='''变量说明'''==

{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.temperature || 温度 || 实况 || 全球 || 地表2米气温
|-
! 气压
| $.result.pres || 气压(Pa) || 实况 || 全球 || 地面气压
|-
! 相对湿度
| $.result.humidity || 相对湿度(%) || 实况 || 全球 || 地表2米湿度
|-
! 风向
| $.result.wind.direction || 风向 || 实况 || 全球 || 地表10米风向
|-
! 风速
| $.result.wind.speed || 风速 || 实况 || 全球 || 地表10米风速
|-
! 最近降水距离
| $.result.precipitation.nearest.distance || 距离 || 实况 || 全球 || 最近降水带与本地的距离
|-
! 最近降水强度
| $.result.precipitation.nearest.intensity || 降水强度 || 实况 || 全球 || 最近降水处的降水强度
|-
! 本地降水强度
| $.result.precipitation.local.intensity || 雷达降水强度 || 实况 || 全球 || 最近降水处的降水强度
|-
! 云量
| $.result.cloudrate || 云量(0.0-1.0) || 实况 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.dswrf|| 向下短波辐射通量(W/M2) || 实况 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.visibility || 能见度 || 实况 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 天气状况
| $.result.skycon || 天气状况 || 实况 || 全球 || 天气状况
|-
! 舒适度指数
| $.result.comfort.index || 舒适度指数自然语言 || 实况 || 全球 || 舒适度指数及其描述
|-
! 紫外线指数
| $.result.ultraviolet.index || 紫外线指数自然语言 || 实况 || 全球 || 紫外线指数及其描述
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.pm25 || PM25浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM25浓度
|-
! PM10浓度
| $.result.pm10 || PM10浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM10浓度
|-
! 臭氧浓度
| $.result.o3 || 臭氧浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 臭氧浓度
|-
! 二氧化氮浓度
| $.result.no2 || 二氧化氮浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化氮浓度
|-
! 二氧化硫浓度
| $.result.so2 || 二氧化硫浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化硫浓度
|-
! 一氧化碳浓度
| $.result.co || 一氧化碳浓度(mg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 一氧化碳浓度
|-
! AQI
| $.result.aqi || 国标AQI || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 国标AQI
|}
{{天气现象}}

=='''生活指数'''==
{{生活指数}}

=='''支持的单位制'''==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]

实况天气接口

2020-02-19T05:59:22Z

Mengqingye: Redirected page to 实况天气接口/v2.5

#REDIRECT [[实况天气接口/v2.5]]

彩云天气 API/v2.5

2020-02-19T03:57:13Z

Mengqingye: /* 状态 */

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
# 小时级和天级天气数据覆盖全球任意经纬度；
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：继承v2.4，本版本已经是稳定版本。

* [[实况天气接口/v2.2|实况天气接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
* [[分钟级降雨预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>
* [[小时级预报接口]]：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]
* [[天级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>
* [[通用预报接口|通用点数据接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.031'''
|'''<0.08'''
|无雨／雪
|-
|'''0.031～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2/your_token/	121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

== 按区域代码adcode返回对应城市的数据 ==

通用接口： http://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/weather.json?adcode=110100

adcode 列表见 [[行政区域经纬度对照表]]

==格式变更==
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx

*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下

*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
*v2.4及以上版本pres字段改为了pressure
==特性增强==
*air_quality（预报和实况）中，增加美标和国标的AQI

*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
*新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；
{{天气现象v2.5}}

[[Category:API 产品]]

彩云天气 API/v2.5

2020-02-19T03:26:21Z

Mengqingye: /* 状态 */

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
# 小时级和天级天气数据覆盖全球任意经纬度；
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：继承v2.4，本版本已经是稳定版本。

* 实况天气接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
** 分钟级降雨预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>

** 小时级预报接口：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]

** 天级预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>

* 通用接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.031'''
|'''<0.08'''
|无雨／雪
|-
|'''0.031～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2/your_token/	121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

== 按区域代码adcode返回对应城市的数据 ==

通用接口： http://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/weather.json?adcode=110100

adcode 列表见 [[行政区域经纬度对照表]]

==格式变更==
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx

*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下

*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
*v2.4及以上版本pres字段改为了pressure
==特性增强==
*air_quality（预报和实况）中，增加美标和国标的AQI

*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
*新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；
{{天气现象v2.5}}

[[Category:API 产品]]

Template:彩云天气 API 版本状态

2020-02-19T03:13:23Z

Mengqingye:

''本文版本：[[{{FULLPAGENAME}}|{{SUBPAGENAME}}]]，历史版本：[[彩云天气 API/v2.2|v2.2]]，[[彩云天气 API/v2.3|v2.3]]，和 [[彩云天气 API/v2.4|v2.4]]，当前稳定版本版本：[[彩云天气 API/v2.5|v2.5]]''

彩云天气 API/v2.5

2020-01-02T04:00:52Z

Mengqingye: 增加按adcode请求数据的说明

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
# 小时级和天级天气数据覆盖全球任意经纬度；
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：alpha，继承v2.4；本版本尚在开发中，最终释出的特性与变更未完全确定。

* 实况天气接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
** 分钟级降雨预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>

** 小时级预报接口：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]

** 天级预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>

* 通用接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.031'''
|'''<0.08'''
|无雨／雪
|-
|'''0.031～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2/your_token/	121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

== 按区域代码adcode返回对应城市的数据 ==

通用接口： http://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/weather.json?adcode=110100

adcode 列表见 [[行政区域经纬度对照表]]

==格式变更==
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx

*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下

*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
*v2.4及以上版本pres字段改为了pressure
==特性增强==
*air_quality（预报和实况）中，增加美标和国标的AQI

*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
*新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；
{{天气现象v2.5}}

[[Category:API 产品]]

彩云天气 API

2019-12-26T14:37:57Z

Mengqingye:

彩云天气 API 是彩云开发者和企业合作伙伴获得彩云天气数据的主要渠道。

==区域栅格数据接口==
* [[中国区域降水实况栅格图API|雷达区域实况拼图接口]]
* [[雾霾区域实况图接口]]

==全球点数据接口==

包含了如下几个时间尺度接口：

* [[实况天气接口]]
* [[分钟级降雨预报接口]]
* [[小时级预报接口]]
* [[天级预报接口]]
* [[通用预报接口|通用点数据接口]]

==全球点数据接口的版本==

* [[彩云天气 API 的版本策略|全球点数据接口的版本策略]]
* 历史版本：v2.2
* 历史版本：[[彩云天气 API/v2.3|v2.3]]
* 历史版本：[[彩云天气 API/v2.4|v2.4]]
* 当前版本：[[彩云天气 API/v2.5|v2.5]]

== 其他数据接口 ==
* [[空气污染实况接口|空气污染站点实况接口]]
* [[空气污染实况城市排名接口|空气污染城市实况排名接口]]

== 参考文档 ==
* [[行政区域经纬度对照表]]

==反馈渠道==

* [https://trello.com/b/RRa3flng/ 新特性自助申请]
* [https://trello.com/b/z62UnLlw/ 现存BUG自助反馈]
* [https://trello.com/b/z62UnLlw/ 彩云天气常见问题]
* [[联系我们]]

[[Category:API 产品]]

彩云天气 API/v2.5

2019-12-26T14:33:34Z

Mengqingye: /* 格式变更 */

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
# 小时级和天级天气数据覆盖全球任意经纬度；
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：alpha，继承v2.4；本版本尚在开发中，最终释出的特性与变更未完全确定。

* 实况天气接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
** 分钟级降雨预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>

** 小时级预报接口：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]

** 天级预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>

* 通用接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.031'''
|'''<0.08'''
|无雨／雪
|-
|'''0.031～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2/your_token/	121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

==格式变更==
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx

*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下

*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
*v2.4及以上版本pres字段改为了pressure
==特性增强==
*air_quality（预报和实况）中，增加美标和国标的AQI

*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
*新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；
{{天气现象v2.5}}

[[Category:API 产品]]

行政区域经纬度对照表

2019-12-18T08:39:55Z

Mengqingye: 更新行政区经纬度对照表

国内行政区域编码
* [[File:adcode-20190416.csv.zip|国内行政区域编码]]
* 20190416 更新

国内城市经纬度对照表
* [[File:cityidloc-20180625.csv.zip|经纬度对照表]]
* 该文档为全国县级以上城市（共计2588个）的经纬度对照表。给出城市名，查询对应的经纬度。
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。
* 此文件不推荐使用，请使用 "国内行政区域编码" 获取国内城市对应的数据。
*[[File:Adcode-release-20191218.xlsx.zip|thumb]]

国际城市经纬度对照表
* [[File: globalcities.csv.zip]]
* 该文档为全球主要城市的经纬度对照表。给出城市名，查询对应的经纬度。
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。

File:Adcode-release-20191218.xlsx.zip

2019-12-18T08:36:06Z

Mengqingye:

行政区域经纬度对照表

彩云天气 API/v2.5

2019-12-02T08:38:41Z

Mengqingye: /* 降水强度对照表 */

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
# 小时级和天级天气数据覆盖全球任意经纬度；
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：alpha，继承v2.4；本版本尚在开发中，最终释出的特性与变更未完全确定。

* 实况天气接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
** 分钟级降雨预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>

** 小时级预报接口：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]

** 天级预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>

* 通用接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.031'''
|'''<0.08'''
|无雨／雪
|-
|'''0.031～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2/your_token/	121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

==格式变更==
skycon新增：SLEET，THUNDER_SHOWER，HAIL

==特性增强==
新开的2.5版本天气api，相对于v2.4，

1.使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；

2.新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；

{{天气现象v2.5}}

[[Category:API 产品]]

彩云天气 API/v2.5

2019-12-02T08:05:33Z

Mengqingye: /* 实况、2 小时分钟级降水强度对照表 */

{{彩云天气 API 版本状态}}

== 数据覆盖范围 ==

=== 天气数据覆盖区域 ===
# 小时级和天级天气数据覆盖全球任意经纬度；
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。

=== 空气质量数据覆盖区域 ===

中国全境。即将开通全球。

==状态==
状态：alpha，继承v2.4；本版本尚在开发中，最终释出的特性与变更未完全确定。

* 实况天气接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>

* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code>
** 分钟级降雨预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>

** 小时级预报接口：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]

** 天级预报接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>

* 通用接口：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>

== 数据类型及预报时长 ==

=== 数据类型 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''实时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
|-
|'''分钟级降水数据'''
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
|-
|'''逐小时数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
|-
|'''逐日数据'''
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
|-
|'''生活指数'''
|穿衣、洗车、感冒、紫外线
|-
|'''预警信息'''

'''（同步于中央气象台）'''
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
|}

=== 预报时长 ===
{| class="wikitable"
|'''数据类型'''
|'''描述'''
|-
|'''分钟级降水数据'''
|未来两小时逐分钟
|-
|'''逐小时数据'''
|未来十五天逐小时
|-
|'''逐日数据'''
|未来十五天逐日
|-
|'''空气质量(AQI 和 PM2.5) '''
|未来十五天逐小时
|-
|'''生活指数'''
|未来十五天逐日
|}

注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。

== API 降水强度对照 ==

=== 降水强度对照表 ===
{| class="wikitable"
|'''降水强度值'''
|'''降水量数值 mm／h'''
|'''天气现象'''
|-
|'''<0.03'''
|'''<0.08'''
|无雨／雪
|-
|'''0.03～0.25'''
|'''0.08~3.44'''
|小雨／雪
|-
|'''0.25～0.35'''
|'''3.44~11.33'''
|中雨／雪
|-
|'''0.35～0.48'''
|'''11.33~51.30'''
|大雨／雪
|-
|'''>=0.48'''
|'''>=51.30'''
|暴雨／雪
|}
注：
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
如：https://api.caiyunapp.com/v2/your_token/	121.4750,24.7695/forecast?unit=metric:v2

== AQI数据基本对照表 ==
{| class="wikitable"
|'''AQI数值'''
|'''空气质量等级'''
|-
|'''0 ~50'''
|优
|-
|'''50~100'''
|良
|-
|'''100~150'''
|轻度污染
|-
|'''150~200'''
|中度污染
|-
|'''>200'''
|重度污染
|}

== 预报数据更新频率 ==

{| class="wikitable"
|'''数据类型'''
|'''频率'''
|-
|'''实况天气数据'''
|1 分钟
|-
|'''分钟级天气预报数据'''
|1 分钟
|-
|'''小时级天气预报数据'''
|15 分钟
|-
|'''天级天气预报数据'''
|2 小时
|-
|'''PM 2.5 / AQI 数据'''
|1 小时
|}
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

== 预报数据地域精度 ==
{| class="wikitable"
|'''数据类型'''
|'''精度'''
|-
|'''分钟级预报'''
|
|-
|'''小时级预报'''
|
|-
|'''天级预报'''
|
|-
|'''PM 2.5 / AQI 数据'''
|5 km*5 km
|}
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。

== 风力风速风向等级对照表 ==

'''风力等级对照表'''

{| class="wikitable"
|'''风力等级'''
|'''风速范围（km/h）'''
|'''自然语言描述'''
|-
|'''0级'''
|<1
|无风
|-
|'''1级'''
|1-5
|微风徐徐
|-
|'''2级'''
|6-11
|清风
|-
|'''3级'''
|12-19
|树叶摇摆
|-
|'''4级'''
|20-28
|树枝摇动
|-
|'''5级'''
|29-38
|风力强劲
|-
|'''6级'''
|39-49
|风力强劲
|-
|'''7级'''
|50-61
|风力超强
|-
|'''8级'''
|62-74
|狂风大作
|-
|'''9级'''
|75-88
|狂风呼啸
|-
|'''10级'''
|89-102
|暴风毁树
|-
|'''11级'''
|103-117
|暴风毁树
|-
|'''12级'''
|118-133
|飓风
|-
|'''13级'''
|134-149
|台风
|-
|'''14级'''
|150-166
|强台风
|-
|'''15级'''
|167-183
|强台风
|-
|'''16级'''
|184-201
|超强台风
|-
|'''17级'''
|202-220
|超强台风
|}

'''风向对照表'''

{| class="wikitable"
|'''风向'''
|'''符号'''
|'''中心角度'''
|'''角度'''
|-
|'''北'''
|N
|0
|348.76-11.25
|-
|'''北东北'''
|NNE
|22.5
|11.26-33.75
|-
|'''东北'''
|NE
|45
|33.76-56.25
|-
|'''东东北'''
|ENE
|67.5
|56.26-78.75
|-
|'''东'''
|E
|90
|78.76-101.25
|-
|'''东东南'''
|ESE
|112.5
|101.26-123.75
|-
|'''东南'''
|SE
|135
|123.76-146.25
|-
|'''南东南'''
|SSE
|157.5
|146.26-168.75
|-
|'''南'''
|S
|180
|168.76-191.25
|-
|'''南西南'''
| SSW
|202.5
|191.26-213.75
|-
|'''西南'''
|SW
|225
|213.76-236.25
|-
|'''西西南'''
|WSW
|247.5
|236.26-258.75
|-
|'''西'''
|W
|270
|258.76-281.25
|-
|'''西西北'''
|WNW
|295.5
|281.26-303.75
|-
|'''西北'''
|NW
|315
|303.76-326.25
|-
|'''北西北'''
|NNW
|337.5
|326.26-348.75
|}

== 天气预警 ==

获取天气预警信息，需要在API接口后增加参数：alert=true

增加参数以后，返回的数据里会增加：alert:{} 字段

预警信息类型取 code 字段'''前两位'''

预警类型编码对照表：

{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|台风
|01
|-
|暴雨
|02
|-
|暴雪
|03
|-
|寒潮
|04
|-
|大风
|05
|-
|沙尘暴
|06
|-
|高温
|07
|-
|干旱
|08
|-
|雷电
|09
|-
|冰雹
|10
|-
|霜冻
|11
|-
|大雾
|12
|-
|霾
|13
|-
|道路结冰
|14
|-
|森林火灾
|15
|-
|雷雨大风
|16
|}

预警级别取 code 字段'''后两位'''

预警级别编码对照表：
{| class="wikitable"
|'''预警级别'''
|'''级别编码'''
|-
|'''蓝色'''
|01
|-
|'''黄色'''
|02
|-
|'''橙色'''
|03
|-
|'''红色'''
|04
|}
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''

== 生活指数等级 ==

{| class="wikitable"
|'''生活指数名称'''
|'''等级'''
|'''等级描述'''
|-
| rowspan="5" |紫外线
|ultraviolet1
|最弱
|-
|ultraviolet2
|弱
|-
|ultraviolet3
|中等
|-
|ultraviolet4
|强
|-
|ultraviolet5
|很强
|-
| rowspan="4" |洗车
|carWashing1
|适宜
|-
|carWashing2
|较适宜
|-
|carWashing3
|较不适宜
|-
|carWashing4
|不适宜
|-
| rowspan="9" |穿衣
|dressing0
|极热
|-
|dressing1
|极热
|-
|dressing2
|很热
|-
|dressing3
|热
|-
|dressing4
|温暖
|-
|dressing5
|凉爽
|-
|dressing6
|冷
|-
|dressing7
|寒冷
|-
|dressing8
|极冷
|-
| rowspan="4" |感冒
|coldRisk1
|少发
|-
|coldRisk2
|较易发
|-
|coldRisk3
|易发
|-
|coldRisk4:
|极易发
|}

== 数据来源 ==
{| class="wikitable"
|'''数据类型'''
|'''数据源'''
|-
| rowspan="5" |天气数据
|中国气象科学数据共享服务网
|-
|台湾地区交通部中央气象局
|-
|美国大气与海洋管理局
|-
|日本气象厅
|-
|Open Weather Map
|-
|空气质量数据
|PM 25.in、环保部、WMO
|}

== 数据 API 语言种类 ==

英语、中文简体、中文繁体

== 调用次数如何计算 ==

用户发出一次 URL 请求并得到返回数据为一次调用

== 数据坐标 ==

数据所用坐标系 GCJ－02 坐标系统

== 是否支持返回历史数据 ==

API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。

==格式变更==
skycon新增：SLEET，THUNDER_SHOWER，HAIL

==特性增强==
新开的2.5版本天气api，相对于v2.4，

1.使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；

2.新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；

{{天气现象v2.5}}

[[Category:API 产品]]