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

From Caiyun Wiki
Jump to: navigation, search
(→‎状态)
Line 1: Line 1:
 
{{彩云天气 API 版本状态}}
 
{{彩云天气 API 版本状态}}
 +
 +
== 数据覆盖范围 ==
 +
 +
=== 天气数据覆盖区域 ===
 +
# 小时级和天级天气数据覆盖全球任意经纬度；
 +
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。
 +
 +
=== 空气质量数据覆盖区域 ===
 +
 +
中国全境。即将开通全球。
 +
 
==状态==
 
==状态==
−
状态：alpha，继承v2.4；本版本尚在开发中，最终释出的特性与变更未完全确定。<blockquote>实况天气接口：</blockquote><blockquote>https://api.caiyunapp.com/v2.5<nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</blockquote><blockquote>分钟级降雨预报接口：</blockquote><blockquote>https://api.caiyunapp.com/v2.5<nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</blockquote><blockquote>小时级预报接口：</blockquote><blockquote>https://api.caiyunapp.com/v2.5<nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</blockquote><blockquote>天级预报接口：</blockquote><blockquote>https://api.caiyunapp.com/v2.5<nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</blockquote><blockquote>通用预报接口：</blockquote><blockquote>https://api.caiyunapp.com/v2.5<nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</blockquote>
+
状态：alpha，继承v2.4；本版本尚在开发中，最终释出的特性与变更未完全确定。<blockquote>实况天气接口：</blockquote><blockquote><code><nowiki>https://api.caiyunapp.com/v2.5</nowiki><nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code></blockquote><blockquote>分钟级降雨预报接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.5</nowiki><nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</blockquote><blockquote>小时级预报接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.5</nowiki><nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</blockquote><blockquote>天级预报接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.5</nowiki><nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</blockquote>分钟级+小时级+天级预报接口
 +
 
 +
<nowiki>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</nowiki><blockquote>通用接口：</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2.5</nowiki><nowiki/>/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</blockquote>
 +
 
 +
== 数据类型及预报时长 ==
 +
 
 +
=== 数据类型 ===
 +
{| 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 降水强度对照 ==
 +
 
 +
=== 实况、2 小时分钟级降水强度对照表 ===
 +
{| 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.50'''
 +
|'''11.33~64.64'''
 +
|大雨／雪
 +
|-
 +
|'''>0.50'''
 +
|'''>64.64'''
 +
|暴雨／雪
 +
|}
 +
注：API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code>
 +
 
 +
=== 15 天逐小时、逐天降水强度对照表 ===
 +
{| class="wikitable"
 +
|'''降水量数值 mm／h'''
 +
|'''天气现象'''
 +
|-
 +
|'''<0.05'''
 +
|无雨／雪
 +
|-
 +
|'''0.05~0.90'''
 +
|小雨／雪
 +
|-
 +
|'''0.90~2.87'''
 +
|中雨／雪
 +
|-
 +
|'''2.87~16.16'''
 +
|大雨／雪
 +
|-
 +
|'''>16.16'''
 +
|暴雨／雪
 +
|}
 +
 
 +
注：
 +
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。
 +
# 如需直接返回降雨量数值，加参数 <code>unit=metric:v2</code> 即可。
 +
             如：https://api.caiyunapp.com/v2/your_token/&#x09;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 小时
 +
|}
 +
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。
 +
 
 
==格式变更==
 
==格式变更==
 
skycon新增：SLEET，THUNDER_SHOWER，HAIL
 
skycon新增：SLEET，THUNDER_SHOWER，HAIL

Revision as of 10:22, 20 November 2019

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

数据覆盖范围

天气数据覆盖区域

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

空气质量数据覆盖区域

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

状态

状态：alpha，继承v2.4；本版本尚在开发中，最终释出的特性与变更未完全确定。
实况天气接口：
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json
分钟级降雨预报接口：
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json
小时级预报接口：
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json
天级预报接口：
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json
分钟级+小时级+天级预报接口 https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json
通用接口：
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json

数据类型及预报时长

数据类型

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

（同步于中央气象台）

台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰

预报时长

数据类型 描述
分钟级降水数据 未来两小时逐分钟
逐小时数据 未来十五天逐小时
逐日数据 未来十五天逐日
空气质量(AQI 和 PM2.5)  未来十五天逐小时
生活指数 未来十五天逐日

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

API 降水强度对照

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

降水强度值 降水量数值 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.50 11.33~64.64 大雨／雪
>0.50 >64.64 暴雨／雪

注：API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 unit=metric:v2

15 天逐小时、逐天降水强度对照表

降水量数值 mm／h 天气现象
<0.05 无雨／雪
0.05~0.90 小雨／雪
0.90~2.87 中雨／雪
2.87~16.16 大雨／雪
>16.16 暴雨／雪

注：

  1. 雨雪相态判断使用 SKYCON 表示，RAIN 表示雨，SNOW 表示雪。
  2. 如需直接返回降雨量数值，加参数 unit=metric:v2 即可。

             如：https://api.caiyunapp.com/v2/your_token/%09121.4750,24.7695/forecast?unit=metric:v2

AQI数据基本对照表

AQI数值 空气质量等级
0 ~50 优
50~100 良
100~150 轻度污染
150~200 中度污染
>200 重度污染

预报数据更新频率

数据类型 频率
实况天气数据 1 分钟
分钟级天气预报数据 1 分钟
小时级天气预报数据 15 分钟
天级天气预报数据 2 小时
PM 2.5 / AQI 数据 1 小时

注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。

格式变更

skycon新增：SLEET，THUNDER_SHOWER，HAIL

特性增强

新开的2.5版本天气api，相对于v2.4，

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

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

天气现象 skycon v2.5

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

天气现象 代码 备注
晴（白天） 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



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

轻度雾霾 中度雾霾 重度雾霾
AQI > 100 AQI > 150 AQI > 200

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

缺数据 missing 优 good 良 satisfactory 轻度污染 moderate 中度污染 unhealthy 重度污染 very poor 严重污染 hazardous
无测站国家和位置 0~50 51~100 101~150 151~200 201~300 >300
Retrieved from "https://open.caiyunapp.com/index.php?title=彩云天气_API/v2.5&oldid=5500"