Difference between revisions of "彩云天气 API/v2.4"
Liuzhonghua (talk | contribs) (→状态) |
Liuzhonghua (talk | contribs) (→状态) (Tag: Visual edit) |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{彩云天气 API 版本状态}} | {{彩云天气 API 版本状态}} | ||
| − | + | 本版本尚在测试中，最终释出的特性与变更已经确定。 | |
==状态== | ==状态== | ||
| − | + | 状态：beta，继承v2.3<blockquote>实况天气接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</nowiki></blockquote><blockquote>分钟级降雨预报接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</nowiki></blockquote><blockquote>小时级预报接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki></blockquote><blockquote>天级预报接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</nowiki></blockquote><blockquote>通用预报接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</nowiki></blockquote> | |
==格式变更== | ==格式变更== | ||
| Line 18: | Line 18: | ||
==特性增强== | ==特性增强== | ||
| − | * | + | * air_quality（预报和实况）中， 增加美标和国标的AQI |
| + | |||
| + | * air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染' | ||
* 主要天气现象skycon，改进为： | * 主要天气现象skycon，改进为： | ||
Latest revision as of 04:41, 18 March 2019
本文版本：彩云天气 API/v2.4，当前稳定版本版本：v2.5，历史版本：v2.2，v2.3，和 v2.4。
本版本尚在测试中，最终释出的特性与变更已经确定。
Contents
状态
状态：beta，继承v2.3实况天气接口：
https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json
分钟级降雨预报接口：
https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json
小时级预报接口：
https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json
天级预报接口：
https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json
通用预报接口：
https://api.caiyunapp.com/v2.4/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json
格式变更
- 实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx
- 字段名 pres 变更成 pressure
- 生活指数相关的字段重组到 life_index 字段下
- 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
特性增强
- air_quality（预报和实况）中， 增加美标和国标的AQI
- air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
- 主要天气现象skycon，改进为：
天气现象 skycon v2.4
主要天气现象的优先级：冰雹 > 雷阵雨 > 降雪 > 降雨 > 雾 > 沙尘 > 浮尘 > 雾霾 > 大风 > 阴 > 多云 > 晴
| 天气现象 | 代码 | 备注 |
|---|---|---|
| 晴（白天） | 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 |
降水（RAIN，SNOW）强度 [单位：intensity]等级：
（小雨 < 0.25 < 中雨 < 0.35 < 大雨 < 0.48 < 暴雨）
雾霾类(HAZE）天气现象（skycon）分三个等级：
| 轻度雾霾 | 中度雾霾 | 重度雾霾 |
| AQI > 100 | AQI > 150 | AQI > 200 |
空气污染的自然语言描述air_quality: description字段，根据AQI有六个等级划分：
| 缺数据 missing | 优 Good | 良 Moderate | 轻度污染 Unhealthy for Sensitive Groups | 中度污染 Unhealthy | 重度污染 Very Unhealthy | 严重污染 Hazardous |
| 无测站国家和位置 | 0~50 | 51~100 | 101~150 | 151~200 | 201~300 | >300 |
