彩云天气 API 一览表

From Caiyun Wiki
Revision as of 13:49, 14 April 2020 by Mingli (talk | contribs) (支持的单位制)
Jump to: navigation, search

快速通道:天气业务 | 天气开发者 | 小译开发者

TAkhjf8d1nlSlspN 是个例子,请使用你的 token


接口说明

全球点数据接口

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

其他数据接口

行政区域经纬度对照表


预报数据覆盖范围

天气数据覆盖区域

  • 小时级和天级天气预报数据从 2015 年首次上线开始即覆盖全球任意经纬度
  • 彩云天气是全球首家且唯一的可以提供全球分钟级预报图和预报数据的天气 API 。彩云天气已接入全球 95% 以上的天气雷达资料,在以下地区提供分钟级预报:
彩云天气2020分钟级预报全球覆盖范围概览
国家或地区
欧洲 意大利、立陶宛、马耳他、法国、斯洛伐克、挪威、白俄罗斯、冰岛、 捷克、斯洛文尼亚、德国、西班牙、乌克兰、丹麦、波兰、芬兰、瑞典、克罗地亚、俄罗斯、罗马尼亚、葡萄牙、爱沙尼亚、塞尔维亚、英国、奥地利、希腊、匈牙利
大洋洲 澳大利亚、斐济,关岛,澳大利亚,马绍尔群岛,新喀里多尼亚
亚洲 中国(包括港澳台,钓鱼岛,南沙群岛),土耳其,巴林,沙特阿拉伯,印度尼西亚,伊朗,新加坡,阿曼,菲律宾,日本,印度,柬埔寨,塞浦路斯,马来西亚,越南,科威特,泰国,韩国,朝鲜
北美 加拿大,巴哈马,开曼群岛,墨西哥,巴拿马,马提尼克,古巴,美国,百慕大,波多黎各,库拉岛,瓜德罗普,尼加拉瓜
南美 巴西,法属圭亚那,哥伦比亚,圭亚那,巴拉圭,阿根廷

空气质量数据覆盖区域

中国全境。

预报中支持的变量

数据类型 描述
实时数据 温度、湿度、风向、风速、气压、云量、降水量(mm/h)/降水强度、PM 2.5、AQI、天气类型
分钟级降水数据 未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
逐小时数据 温度、湿度、风向、风速、气压、云量、降水量(mm/h)/降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
逐日数据 温度、湿度、风向、风速、气压、云量、降水量(mm/h)/降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
生活指数 穿衣、洗车、感冒、紫外线
预警信息 台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰(预警信息同中央气象台同步

预报时长

数据类型 描述
分钟级降水数据 未来两小时逐分钟
逐小时数据 未来十五天逐小时
逐日数据 未来十五天逐日
空气质量(AQI 和 PM2.5)  未来十五天逐小时
生活指数 未来十五天逐日
  • 彩云API预报接口默认返回5天数据,如果需15天数据需要增加参数,可在URL后增加参数 dailysteps=15&hourlysteps=360 来控制返回预报时长。

预报更新频率

数据类型 频率
实况天气数据 1 分钟
分钟级天气预报数据 1 分钟
小时级天气预报数据 15 分钟
天级天气预报数据 2 小时
PM 2.5 / AQI 数据 1 小时
  • 注:采用多数据源校正数据,每个数据源的更新频率不同,小时级和天级预报更新频率为综合测算估值。

预报地域精度

数据类型 精度
分钟级预报
小时级预报
天级预报
PM 2.5 / AQI 数据 5 km*5 km
  • 注:采用多数据源校正数据,每个数据源的地域精度不同,小时级和天级预报地域精度为综合测算估值。

数据来源

数据类型 数据源
天气数据 中国气象科学数据共享服务网
台湾地区交通部中央气象局
美国大气与海洋管理局
日本气象厅
Open Weather Map
世界各国气象局和气象组织
空气质量数据 PM 25.in、环保部、WMO

支持的单位制

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

单位制
要素
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)来判断,研发中...


天气现象代码表

天气现象 代码 备注
晴(白天) 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
  • 主要天气现象的优先级:降雪 > 降雨 > 雾 > 沙尘 > 浮尘 > 雾霾 > 大风 > 阴 > 多云 > 晴

降水强度对照

雷达降水强度 降水量 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 暴雨/雪

AQI 数据对照表

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

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

风力风速等级对照表

风力等级 风速范围 (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 超强台风

风向代码对照表

风向 符号 中心角度 角度
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

预警信息的字段

  • 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”,可以分解出结构:预警类型编码+预警级别编码,于是我们得到雷电蓝色预警

预警类型编码对照表

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

预警级别编码对照表

预警级别 级别编码
蓝色 01
黄色 02
橙色 03
红色 04

区域代码 adcode

生活指数等级

生活指数名称 等级 等级描述
紫外线(实况级别) ultraviolet0
ultraviolet1 很弱
ultraviolet2 很弱
ultraviolet3
ultraviolet4
ultraviolet5 中等
ultraviolet6 中等
ultraviolet7
ultraviolet8
ultraviolet9 很强
ultraviolet10 很强
ultraviolet11 极强
紫外线(天级别) ultraviolet1 最弱
ultraviolet2
ultraviolet3 中等
ultraviolet4
ultraviolet5 很强
穿衣 dressing0 极热
dressing1 极热
dressing2 很热
dressing3
dressing4 温暖
dressing5 凉爽
dressing6
dressing7 寒冷
dressing8 极冷
感冒 coldRisk1 少发
coldRisk2 较易发
coldRisk3 易发
coldRisk4: 极易发

区域代码 adcode对照表