Difference between revisions of "分钟级降雨预报接口/v2.5"
(→API 返回值) |
|||
| Line 36: | Line 36: | ||
<syntaxhighlight lang="yaml"> | <syntaxhighlight lang="yaml"> | ||
| − | status: ok #返回状态 | + | status: ok # 返回状态 |
| − | api_status: active #API 服务状态 | + | api_status: active # API 服务状态 |
| − | api_version: v2.5 #API 版本号 | + | api_version: v2.5 # API 版本号 |
| − | server_time: 1586247444 #响应时刻服务器时间 | + | server_time: 1586247444 # 响应时刻服务器时间 |
| − | timezone: Asia/Taipei #时区信息 | + | timezone: Asia/Taipei # 时区信息 |
| − | tzshift: 28800 #时区偏移秒数 | + | tzshift: 28800 # 时区偏移秒数 |
| − | unit: metric #单位制 | + | unit: metric # 单位制 |
| − | lang: zh_CN #语言 | + | lang: zh_CN # 语言 |
location: | location: | ||
| − | - 25.1552 #纬度 | + | - 25.1552 # 纬度 |
| − | - 121.6544 #经度 | + | - 121.6544 # 经度 |
result: | result: | ||
minutely: | minutely: | ||
status: ok | status: ok | ||
| − | datasource: radar #预报依据的数据源 | + | datasource: radar # 预报依据的数据源 |
| − | description: 附近正在下雨，出门还是带把伞吧~ #预报的自然语言描述 | + | description: 附近正在下雨，出门还是带把伞吧~ # 预报的自然语言描述 |
| − | probability: #降雨概率 | + | probability: # 降雨概率 |
| − | - 0.0 #0.0~0.5 小时间的降雨概率 | + | - 0.0 # 0.0~0.5 小时间的降雨概率 |
| − | - 0.0 #0.5~1.0 小时间的降雨概率 | + | - 0.0 # 0.5~1.0 小时间的降雨概率 |
| − | - 0.0 #1.0~1.5 小时间的降雨概率 | + | - 0.0 # 1.0~1.5 小时间的降雨概率 |
| − | - 0.0 #1.5~2.0 小时间的降雨概率 | + | - 0.0 # 1.5~2.0 小时间的降雨概率 |
| − | precipitation: #预报的分钟级别的降雨强度 00~60 分钟 | + | precipitation: # 预报的分钟级别的降雨强度 00~60 分钟 |
| − | - 0.0 #第 0 分钟的预报值 | + | - 0.0 # 第 0 分钟的预报值 |
| − | - ... #共 60 个数据项 | + | - ... # 共 60 个数据项 |
| − | precipitation_2h: #预报的分钟级别的降雨强度 000~120 分钟 | + | precipitation_2h: # 预报的分钟级别的降雨强度 000~120 分钟 |
| − | - 0.0 #第 0 分钟的预报值 | + | - 0.0 # 第 0 分钟的预报值 |
| − | - ... #共 120 个数据项 | + | - ... # 共 120 个数据项 |
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 74: | Line 74: | ||
! 健值路径（jsonpath） !! 量 !! 取值范围 !! 时间粒度 !! 更新频次 !! 地理范围 !! 注释 | ! 健值路径（jsonpath） !! 量 !! 取值范围 !! 时间粒度 !! 更新频次 !! 地理范围 !! 注释 | ||
|- | |- | ||
| − | ! | + | ! 降水概率 |
| $.result.minutely.probability | | $.result.minutely.probability | ||
| 降水概率 | | 降水概率 | ||
| Line 83: | Line 83: | ||
| 本地未来1小时逐分钟短临降水强度预报 | | 本地未来1小时逐分钟短临降水强度预报 | ||
|- | |- | ||
| − | ! | + | ! 一小时降水强度 |
| $.result.minutely.precipitation | | $.result.minutely.precipitation | ||
| 雷达降水强度 | | 雷达降水强度 | ||
| Line 92: | Line 92: | ||
| 本地未来1小时逐分钟短临降水强度预报 | | 本地未来1小时逐分钟短临降水强度预报 | ||
|- | |- | ||
| − | ! | + | ! 两小时降水强度 |
| $.result.minutely.precipitation_2h | | $.result.minutely.precipitation_2h | ||
| 雷达降水强度 | | 雷达降水强度 | ||
Revision as of 09:12, 9 April 2020
本文版本：分钟级降雨预报接口/v2.5，当前稳定版本版本：v2.5，历史版本：v2.2，v2.3，和 v2.4。
Contents
授权与认证
请先至彩云开放平台注册，注册后可以获得 token 。
把您的 token 拼到 API 请求的 URL 中，如
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！
API 请求
示例
这里是测试 token ，即 TAkhjf8d1nlSlspN
-
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json -
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.jsonp?callback=MYCALLBACK -
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/118.7087,26.9582/minutely?lang=en_US
请求参数
- 经纬度：必须，无缺省值，经度在前，纬度在后，中间用半角逗号隔开，如
121.6544,25.1552 - 返回格式：必须，无缺省值，可选项目包括json 或者 jsonp，jsonp 需提供回调函数名
- 语言选项 lang: 可选，缺省值是
zh_CN，可选项目包括简体中文（zh_CN，默认）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）、日语（ja） - 单位制选项 unit: 可选，缺省值是
metric， 可选项目包括公制metric，英制imperial，和科学单位制SI
API 返回值
返回结构说明
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:
minutely:
status: ok
datasource: radar # 预报依据的数据源
description: 附近正在下雨，出门还是带把伞吧~ # 预报的自然语言描述
probability: # 降雨概率
- 0.0 # 0.0~0.5 小时间的降雨概率
- 0.0 # 0.5~1.0 小时间的降雨概率
- 0.0 # 1.0~1.5 小时间的降雨概率
- 0.0 # 1.5~2.0 小时间的降雨概率
precipitation: # 预报的分钟级别的降雨强度 00~60 分钟
- 0.0 # 第 0 分钟的预报值
- ... # 共 60 个数据项
precipitation_2h: # 预报的分钟级别的降雨强度 000~120 分钟
- 0.0 # 第 0 分钟的预报值
- ... # 共 120 个数据项
返回错误
天气变量
| 名称 | 健值路径（jsonpath） | 量 | 取值范围 | 时间粒度 | 更新频次 | 地理范围 | 注释 |
|---|---|---|---|---|---|---|---|
| 降水概率 | $.result.minutely.probability | 降水概率 | 0.0~1.0 | 未来两小时 | 实时更新 | 数据覆盖范围 | 本地未来1小时逐分钟短临降水强度预报 |
| 一小时降水强度 | $.result.minutely.precipitation | 雷达降水强度 | 0.0~1.0 | 未来一小时 | 实时更新 | 数据覆盖范围 | 本地未来1小时逐分钟短临降水强度预报 |
| 两小时降水强度 | $.result.minutely.precipitation_2h | 雷达降水强度 | 0.0~1.0 | 未来两小时 | 实时更新 | 数据覆盖范围 | 本地未来2小时逐分钟短临降水强度预报 |
变量详细说明
降水概率
雷达降水强度
分钟级降雨预报数据覆盖
彩云天气是全球首家且唯一的可以提供全球分钟级预报图和预报数据的天气 API 。彩云天气已接入全球 95% 以上的天气雷达资料，在以下地区提供分钟级预报：
| 洲 | 国家 |
|---|---|
| 欧洲 | 意大利、立陶宛、马耳他、法国、斯洛伐克、挪威、白俄罗斯、冰岛、 捷克、斯洛文尼亚、德国、西班牙、乌克兰、丹麦、波兰、芬兰、瑞典、克罗地亚、俄罗斯、罗马尼亚、葡萄牙、爱沙尼亚、塞尔维亚、英国、奥地利、希腊、匈牙利 |
| 大洋洲 | 澳大利亚、斐济，关岛，澳大利亚，马绍尔群岛，新喀里多尼亚 |
| 亚洲 | 中国大陆及港澳台，钓鱼岛，南沙群岛，土耳其，巴林，沙特阿拉伯，印度尼西亚，伊朗，新加坡，阿曼，菲律宾，日本，印度，柬埔寨，塞浦路斯，马来西亚，越南，科威特，泰国，韩国，朝鲜 |
| 北美 | 加拿大，巴哈马，开曼群岛，墨西哥，巴拿马，马提尼克，古巴，美国，百慕大，波多黎各，库拉岛，瓜德罗普，尼加拉瓜 |
| 南美 | 巴西，法属圭亚那，哥伦比亚，圭亚那，巴拉圭，阿根廷 |
