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

From Caiyun Wiki
Jump to: navigation, search
(→‎特性增强)
 
(39 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{彩云天气 API 版本状态}}
 
{{彩云天气 API 版本状态}}
  
−
== 数据覆盖范围 ==
+
{{彩云天气速查表}}
  
−
=== 天气数据覆盖区域 ===
 
−
# 小时级和天级天气数据覆盖全球任意经纬度；
 
−
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。
 
  
−
=== 空气质量数据覆盖区域 ===
+
== 接口格式说明 ==
  
−
中国全境。即将开通全球。
+
<code>TAkhjf8d1nlSlspN</code> 是个例子，请使用你的 token
  
−
==状态==
+
* '''[[通用预报接口/v2.5|通用预报接口]]'''：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>
−
状态：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>分钟级+小时级+天级预报接口
+
* '''[[实况天气接口/v2.5|实况天气接口]]'''：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code>
 +
* '''[[分钟级降雨预报接口/v2.5|分钟级降雨预报接口]]'''：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code>
 +
* '''[[小时级预报接口/v2.5|小时级预报接口]]'''：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>
 +
* '''[[天级预报接口/v2.5|天级预报接口]]'''：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code>
  
−
<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>
+
== 变更说明 ==
  
−
== 数据类型及预报时长 ==
+
=== 格式变更 ===
  
−
=== 数据类型 ===
+
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx
−
{| class="wikitable"
 
−
|'''数据类型'''
 
−
|'''描述'''
 
−
|-
 
−
|'''实时数据'''
 
−
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型
 
−
|-
 
−
|'''分钟级降水数据'''
 
−
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述
 
−
|-
 
−
|'''逐小时数据'''
 
−
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述
 
−
|-
 
−
|'''逐日数据'''
 
−
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数
 
−
|-
 
−
|'''生活指数'''
 
−
|穿衣、洗车、感冒、紫外线
 
−
|-
 
−
|'''预警信息'''
 
  
−
'''（同步于中央气象台）'''
+
*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下
−
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰
 
−
|}
 
  
−
=== 预报时长 ===
+
*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
−
{| class="wikitable"
+
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
−
|'''数据类型'''
+
*v2.4及以上版本pres字段改为了pressure
−
|'''描述'''
 
−
|-
 
−
|'''分钟级降水数据'''
 
−
|未来两小时逐分钟
 
−
|-
 
−
|'''逐小时数据'''
 
−
|未来十五天逐小时
 
−
|-
 
−
|'''逐日数据'''
 
−
|未来十五天逐日
 
−
|-
 
−
|'''空气质量(AQI 和 PM2.5) '''
 
−
|未来十五天逐小时
 
−
|-
 
−
|'''生活指数'''
 
−
|未来十五天逐日
 
−
|}
 
  
−
注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。
+
===特性增强===
  
−
== API 降水强度对照 ==
+
*air_quality（预报和实况）中， 增加美标和国标的AQI
 +
*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
 +
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
  
−
=== 实况、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 天逐小时、逐天降水强度对照表 ===
+
* [[彩云天气 API 的版本策略|全球点数据接口的版本策略]]
−
{| class="wikitable"
+
* 历史版本：[[彩云天气 API/v2.3|v2.3]]
−
|'''降水量数值 mm／h'''
+
* 历史版本：[[彩云天气 API/v2.4|v2.4]]
−
|'''天气现象'''
 
−
|-
 
−
|'''<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
 
−
 
 
−
==特性增强==
 
−
新开的2.5版本天气api，相对于v2.4，
 
−
 
 
−
1.使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；
 
−
 
 
−
2.新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；
 
−
 
 
−
{{天气现象v2.5}}
 
  
 
[[Category:API 产品]]
 
[[Category:API 产品]]

Latest revision as of 07:50, 26 January 2022

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

如果您需要

快速了解覆盖区域、涵盖变量、更新频次等信息，请参看彩云天气业务速查表

快速了解彩云天气的 API 格式信息，请参看彩云天气数据格式速查表

有问题，请参看彩云天气常见问题


接口格式说明

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

变更说明

格式变更

  • 实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx
  • v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下
  • v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）
  • v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致
  • v2.4及以上版本pres字段改为了pressure

特性增强

  • air_quality（预报和实况）中， 增加美标和国标的AQI
  • air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'
  • 使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；

参考文档

Retrieved from "https://open.caiyunapp.com/index.php?title=彩云天气_API/v2.5&oldid=7977"