Difference between revisions of "彩云天气数据格式速查表"

From Caiyun Wiki
Jump to: navigation, search
(AQI 数据对照表)
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
== 天气现象代码表 ==
 
== 天气现象代码表 ==
  
{| 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
 
|
 
|}
 
 
 
* 主要天气现象的优先级:降雪 > 降雨 > 雾 > 沙尘 > 浮尘 > 雾霾 > 大风 > 阴 > 多云 > 晴
 
  
 
== 降水强度对照 ==
 
== 降水强度对照 ==
  
{| 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>,如:<code>https://api.caiyunapp.com/v2.5/your_token/121.4750,24.7695/forecast?unit=metric:v2</code>
 
  
 
== AQI 数据对照表 ==
 
== AQI 数据对照表 ==
 
{| class="wikitable"
 
|'''AQI数值'''
 
|'''空气质量等级'''
 
|-
 
|'''0 ~50'''
 
|优
 
|-
 
|'''50~100'''
 
|良
 
|-
 
|'''100~150'''
 
|轻度污染
 
|-
 
|'''150~200'''
 
|中度污染
 
|-
 
|'''>200'''
 
|重度污染
 
|}
 
  
 
空气污染的自然语言描述 <code>air_quality: description</code> 字段,根据AQI的值有六个等级划分:
 
空气污染的自然语言描述 <code>air_quality: description</code> 字段,根据AQI的值有六个等级划分:
Line 333: Line 200:
 
== 天气预警信息 ==
 
== 天气预警信息 ==
  
获取天气预警信息,需要在API接口后增加参数:<code>alert=true</code>。预警信息的编码规则是预警信息类型取 code 字段'''前两位''',预警级别取自 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
 
|}
 
  
 
== 生活指数等级 ==
 
== 生活指数等级 ==
  
{| 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:
 
|极易发
 
|}
 
 
 
  
 
== 区域代码 adcode对照表 ==
 
== 区域代码 adcode对照表 ==

Latest revision as of 03:37, 28 May 2021

天气现象代码表

天气现象 代码 备注
晴(白天) 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对照表