View source for 小时级预报接口/v2.5

{{彩云天气 API 版本状态}}

=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中，如

<code>
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json
</code>

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！

=='''请求样例'''==

=== '''示例1如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>

</blockquote><blockquote>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.jsonp?callback=MYCALLBACK</blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote>

=== '''示例2如下''' ===
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly?lang=en_US&hourlysteps=2</code></blockquote><blockquote>'''语言选项 lang：'''简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote>
==返回结构和说明==
<syntaxhighlight lang="yaml">
status: ok
status: ok                                         #返回状态
api_status: active                                 #API 服务状态
api_version: v2.5                                  #API 版本号
server_time: 1586247444                            #响应时刻服务器时间
timezone: Asia/Taipei                              #时区信息
tzshift: 28800                                     #时区偏移秒数
unit: metric                                       #单位制
lang: zh_CN                                        #语言
location:
- 25.1552                                          #纬度
- 121.6544                                         #经度
result:
  hourly:
    status: ok
    description: 未来24小时阴                       #预报自然语言表述
    skycon:                                       #天气状态
    - datetime: 2020-04-07T16:00+08:00
      value: CLOUDY
    temperature:                                  #温度
    - datetime: 2020-04-07T16:00+08:00
      value: 17.2
    precipitation:                                #降雨
    - datetime: 2020-04-07T16:00+08:00
      value: 0.0
    cloudrate:                                    #云量
    - datetime: 2020-04-07T16:00+08:00
      value: 1.0
    humidity:                                     #相对湿度
    - datetime: 2020-04-07T16:00+08:00
      value: 0.81
    pressure:                                     #气压
    - datetime: 2020-04-07T16:00+08:00
      value: 99897.4914560001
    wind:                                         #风力、风向
    - datetime: 2020-04-07T16:00+08:00
      direction: 26.03
      speed: 20.93
    visibility:                                   #能见度
    - datetime: 2020-04-07T16:00+08:00
      value: 23.77
    dswrf:                                        #短波辐射下向通量
    - datetime: 2020-04-07T16:00+08:00
      value: 113.6283648
    air_quality:
      aqi:                                        # AQI
      - datetime: 2020-04-07T16:00+08:00
        value:
          chn: 14                                 #国标
          usa: 14                                 #美标
      pm25:                                       #PM25
      - datetime: 2020-04-07T16:00+08:00
        value: 8
</syntaxhighlight>

=='''变量说明'''==
<blockquote>逐小时预报，没有生活指数变量</blockquote>
{| class="wikitable"
! 名称
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释
|-
! 温度
| $.result.hourly.temperature.value || 温度 || 逐小时预报 || 全球 || 地表2米气温
|-
! 气压
| $.result.hourly.pres.value || 气压(Pa) || 逐小时预报 || 全球 || 地面气压
|-
! 相对湿度
| $.result.hourly.humidity.value || 相对湿度(%) || 逐小时预报 || 全球 || 地表2米湿度
|-
! 风向
| $.result.hourly.wind.direction.value || 风向 || 逐小时预报 || 全球 || 地表10米风向
|-
! 风速
| $.result.hourly.wind.speed.value || 风速 || 逐小时预报 || 全球 || 地表10米风速
|-
! 本地降水强度
| $.result.hourly.precipitation.value || 降水量(mm/h) || 逐小时预报 || 全球 || 本地降水量
|-
! 云量
| $.result.hourly.cloudrate.value || 云量(0.0-1.0) || 逐小时预报 || 全球 || 全天总云量
|-
! 短波辐射
| $.result.hourly.dswrf.value|| 向下短波辐射通量(W/M2) || 逐小时预报 || 全球 || 地表向下短波辐射通量
|-
! 能见度
| $.result.hourly.visibility.value || 能见度 || 逐小时预报 || 全球 || 地表水平能见度
|-
!
!
!
!
!
!
|-
! 主要天气现象
| $.result.hourly.skycon.value || 天气状况 || 逐小时预报 || 全球 || 天气状况
|-
! 逐小时预报自然语言描述
| $.result.hourly.description || 舒适度指数自然语言 || 逐小时预报 || 全球 || 舒适度指数及其描述
|-
! 综合预报自然语言描述
| $.result.hourly.forecast_keypoint || 紫外线指数自然语言 || 逐小时预报 || 全球 || 逐小时和逐分钟天气预报，综合自然语言描述
|-
!
!
!
!
!
!
|-
! PM25浓度
| $.result.hourly.pm25.value || PM25浓度(μg/m3) || 逐小时预报 || 大陆、港澳台、暂无印度 || PM25浓度
|-
! AQI
| $.result.hourly.aqi.value || 国标AQI || 逐小时预报 || 大陆、港澳台、暂无印度 || 国标AQI
|}
{{天气现象}}

==支持的单位制==

{{Template:彩云天气 API/支持的单位制}}

[[Category:API 产品]]