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

From CaiyunWiki
Jump to: navigation, search
(状态)
(接口格式说明)
 
(39 intermediate revisions by 5 users not shown)
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>
 
==格式变更==
 
skycon新增:SLEET,THUNDER_SHOWER,HAIL
 
  
==特性增强==
+
{{彩云天气速查表}}
新开的2.5版本天气api,相对于v2.4,
 
  
1.使用了新的数据融合算法,提高了十五日内逐小时降水预报准确度;
 
  
2.新增了雨夹雪(SLEET),雷阵雨(THUNDER_SHOWER),雷阵雨并伴有冰雹(HAIL)3个天气现象;
+
== 接口格式说明 ==
  
{{天气现象v2.5}}
+
<code>TAkhjf8d1nlSlspN</code> 是个例子,请使用你的 token
 +
 
 +
* '''[[通用预报接口/v2.5|通用预报接口]]''':<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code>
 +
* '''[[实况天气接口/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>
 +
 
 +
== 变更说明 ==
 +
 
 +
=== 格式变更 ===
 +
 
 +
*实况接口(/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六个等级,可能出现的字符串有七种:'缺数据','优','良','轻度污染','中度污染','重度污染','严重污染'
 +
*使用了新的数据融合算法,提高了十五日内逐小时降水预报准确度;
 +
*新增了雨夹雪(SLEET),雷阵雨(THUNDER_SHOWER),雷阵雨并伴有冰雹(HAIL)3个天气现象;
 +
 
 +
== 参考文档 ==
 +
 
 +
* [[彩云天气 API 的版本策略|全球点数据接口的版本策略]]
 +
* 历史版本:[[彩云天气 API/v2.3|v2.3]]
 +
* 历史版本:[[彩云天气 API/v2.4|v2.4]]
  
 
[[Category:API 产品]]
 
[[Category:API 产品]]

Latest revision as of 13:07, 7 April 2020

本文版本:彩云天气 API/v2.5,当前稳定版本版本:v2.5,历史版本:v2.2v2.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六个等级,可能出现的字符串有七种:'缺数据','优','良','轻度污染','中度污染','重度污染','严重污染'
  • 使用了新的数据融合算法,提高了十五日内逐小时降水预报准确度;
  • 新增了雨夹雪(SLEET),雷阵雨(THUNDER_SHOWER),雷阵雨并伴有冰雹(HAIL)3个天气现象;

参考文档