Difference between revisions of "彩云天气 API/v2.4"

From Caiyun Wiki
Jump to: navigation, search
(研发中的字段(不稳定!))
(状态)
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{彩云天气 API 版本状态}}
 
{{彩云天气 API 版本状态}}
  
本版本尚在开发之中,最终释出的特性与变更还没有最终确定。
+
本版本尚在测试中,最终释出的特性与变更已经确定。
  
=='''状态'''==
+
==状态==
  
状态:alpha
+
状态: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>
  
=='''格式变更'''==
+
==格式变更==
  
 
* 实况接口(/realtime.json)中各变量,在json中的位置,从result.xxxx变为result.realtime.xxxx
 
* 实况接口(/realtime.json)中各变量,在json中的位置,从result.xxxx变为result.realtime.xxxx
Line 17: Line 17:
 
* 空气质量相关的字段重组到 air_quality 字段下(位于realtime,hourly和daily中)
 
* 空气质量相关的字段重组到 air_quality 字段下(位于realtime,hourly和daily中)
  
=='''特性增强'''==
+
==特性增强==
* air_quality(预报和实况) 中增加美标和国标的aqi,air_quality 中增加相应的六个等级的空气质量自然语言描述description:
+
* air_quality(预报和实况)中, 增加美标和国标的AQI
      {| class="wikitable"
 
!'缺数据' 
 
!'优' 
 
!'良'
 
!'轻度污染'
 
!'中度污染'
 
!'重度污染'
 
!'严重污染'
 
|}
 
  
=='''研发中的字段(不稳定!)'''==
+
* air_quality(预报和实况)中,增加空气质量自然语言描述descripition六个等级,可能出现的字符串有七种:'缺数据','优','良''轻度污染''中度污染','重度污染','严重污染'
* <big>主要天气现象skycon,正在增加雾,浮尘,沙尘暴,大中小雨,大中小雪,所以skycon字段可能出现的内容还不稳定</big>
 
  
=='''接口类型'''==
+
* 主要天气现象skycon,改进为:
*[[实况接口/v2.4|实况接口(realtime)]]
+
{{天气现象v2.4}}
*[[分钟级降雨预报接口/v2.4|分钟级降雨预报接口(minutely)]]
 
*[[逐小时预报接口/v2.4|逐小时预报接口(hourly)]]
 
*[[逐日预报接口/v2.4|逐日预报接口(daily)]]
 
*[[通用预报接口/v2.4|通用预报接口(weather)]]
 
  
 
[[Category:API 产品]]
 
[[Category:API 产品]]

Latest revision as of 04:41, 18 March 2019

本文版本:彩云天气 API/v2.4,当前稳定版本版本:v2.5,历史版本:v2.2v2.3,和 v2.4

本版本尚在测试中,最终释出的特性与变更已经确定。

状态

状态: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