yibudo

天气预报

查询指定坐标的实时天气、分钟级降水、逐小时预报、未来 7 日预报及气象预警。

  • 稳定可用
  • 会员额度
  • 实时
  • 分钟降水
  • 24 小时
  • 7 天

500 次/月

每月免费额度

用完后按次计费。

  • 开通人数0
  • 累计调用次数0
  • 成功率0%
  • 平均响应439 ms

接口概述

基于彩云天气数据服务,提供指定地理位置的实时天气、分钟级降水预报、逐小时天气趋势、未来 7 日天气预报及气象预警信息。接口采用统一 JSON 数据格式,支持通过经纬度查询,适用于天气应用、智能设备、自动化任务、出行服务及其他需要气象数据的业务场景。

接口概览

接口名称天气预报
请求地址https://api.yibudo.com/v1/weather
请求方式GET
响应格式JSON
身份认证请求头 Bearer,或查询参数 key
查询方式经纬度坐标
默认位置经度 118.946778,纬度 25.850346
调用限制见计费说明
数据更新以实际更新频率为准

功能说明

功能模块数据内容
实时天气当前气温、体感温度、天气状况、相对湿度、风速、风向、空气质量
分钟级降水未来 2 小时逐分钟雷达降水强度及降水趋势描述
逐小时预报未来 24 小时逐小时气温、天气状况及趋势信息
未来 7 日预报每日天气状况、最高气温、最低气温、日出日落、降水量与降水概率
气象预警当前有效的气象预警。无预警时返回空数组

不同地理位置及数据源状态可能影响部分气象数据的可用性,具体以接口实际响应为准。

调用规则

身份认证

请求头 Authorization: Bearer <API_KEY>,或查询参数 key。公开调用时,key 填控制台签发的 ybdo_pub_ 值,并附带 bind。

数据时效

天气数据由彩云天气提供。更新时间受地区覆盖、数据周期和网络状态影响。

使用声明

结果仅供参考,不作为专业判断依据。请自行核实后再使用。 预报结果不应单独用于灾害应急、航空航海或其他专业安全决策。数据异常请发到 complaint@yibudo.com,并附上当次 request_id。

计费说明

买断套餐

档位次数单价合计
基础套餐10,000 次¥0.00080/次¥8.00
进阶套餐50,000 次¥0.00060/次¥30.00
大额套餐200,000 次¥0.00045/次¥90.00

一次买断。基础套餐 ¥8.00。超额按次 ¥0.00150。

请求频率

项目额度
登录用户每月 500 次
黄金会员每天 10,000 次,每秒 5 次
铂金会员每天 36,000 次,每秒 20 次
钻石会员每天 80,000 次,每秒 40 次

预报、语音、台风、雷达、闪电、空气共用。与已购套餐分别计算。

请求参数

参数与线上接口一致。

参数名类型必填示例值说明
longitudenumber否118.946778东经,十进制度,范围 -180~180。不填则使用默认位置
latitudenumber否25.850346北纬,十进制度,范围 -90~90。不填则使用默认位置
langstring否zh_CN语言代码。不填为 zh_CN
dailystartnumber否0从第几天开始,0 是今天,最大 6。不填为 0
hourlystepsnumber否24逐小时条数,1~24。不填为 24
dailystepsnumber否7逐日条数,1~7。不填为 7
alertstring否true是否带预警。true 或 false,不填为 true
keystring否<API_KEY>密钥,或 ybdo_pub_ 公开值。与请求头二选一,同时携带时必须相同
bindstring否开源示例key 为公开值时必填,须与控制台绑定说明中的一条一致

参数规则

  • 经纬度采用十进制度。
  • 未传入经纬度时,使用默认位置:经度 118.946778,纬度 25.850346。
  • 建议同时传入 longitude 和 latitude。
  • 经度超出 -180~180,或纬度超出 -90~90,返回 400,error 为 bad_coordinates。
  • 查询位置使用经纬度。返回里的省、市、县是结果中的行政区,不能用城市名代替坐标。
  • 语言、日起点、小时数、天数和预警不填时,按默认值:zh_CN、0、24、7、true。
  • 请求头 Authorization: Bearer <API_KEY>,或查询参数 key。公开调用时 key 填 ybdo_pub_,并附带 bind。

请求示例

GEThttps://api.yibudo.com/v1/weather?longitude=118.946778&latitude=25.850346&lang=zh_CN&dailystart=0&hourlysteps=24&dailysteps=7&alert=true&key=<API_KEY>

响应字段

完整字段见下表,对象和数组可以展开。分钟降水数组是雷达降水强度,不是毫米降水量。7 日预报包含每日降水、空气质量和生活指数。

字段类型说明
request_id
string请求标识。每次请求单独生成的十六进制串,互不重复,用于问题排查
notice
string数据使用声明
contact
string服务投诉及问题反馈邮箱
name
string接口名称,固定为「天气预报」
source
string气象数据来源,当前为彩云天气
headline
string天气趋势摘要
issued_at
number数据生成时间,Unix 时间戳,单位秒
object查询位置及所属时区
lng
number东经
lat
number北纬
zone
string时区
object实时天气
temp_c
number气温,摄氏度
feels_c
number体感温度,摄氏度
moisture
number湿度,0 到 1
cloud
number云量,0 到 1
code
string天气现象代码
text
string天气现象
sight_km
number能见度,公里
shortwave
number短波辐射
gust_kph
number阵风,公里每小时
dew_c
number露点,摄氏度
sea_pa
number海平面气压,帕
ground_pa
number地面气压,帕
object风
kph
number风速,公里每小时
deg
number风向角度
object附近降水
source
string降水数据来源
rate
number本地降水强度
nearest_km
number最近降水距离,公里
nearest_rate
number最近降水强度
object空气
fine
number细颗粒物
coarse
number粗颗粒物
ozone
number臭氧
sulfur
number二氧化硫
nitrogen
number二氧化氮
monoxide
number一氧化碳
index_cn
number空气质量指数,中国
index_us
number空气质量指数,美国
grade_cn
string空气质量等级,中国
grade_us
string空气质量等级,美国
object生活指数
object紫外线
rank
number等级
note
string说明
object舒适度
rank
number等级
note
string说明
object分钟级降水预报
origin
string降水数据来源
note
string两小时降水说明
next_hour
array未来 60 分钟逐分钟雷达降水强度。按时间先后排列,0 表示该分钟无降水。不是毫米降水量
next_two_hours
array未来 120 分钟逐分钟雷达降水强度。按时间先后排列,不是毫米降水量
hour_totals
array逐小时累计降水强度,与分钟数组同一套数值
chance
array逐分钟降水概率,0 到 1
object未来 24 小时逐小时预报
note
string24 小时说明
array逐小时,最多 24 条
at
string时间
temp_c
number气温,摄氏度
feels_c
number体感温度,摄氏度
code
string天气现象代码
text
string天气现象
rain_mm
number降水量,毫米
rain_chance
number降水概率
moisture
number湿度,0 到 1
cloud
number云量,0 到 1
breeze_kph
number风速,公里每小时
breeze_deg
number风向角度
gust_kph
number阵风,公里每小时
dew_c
number露点,摄氏度
sea_pa
number海平面气压,帕
ground_pa
number地面气压,帕
sight_km
number能见度,公里
shortwave
number短波辐射
index_cn
number空气质量指数,中国
index_us
number空气质量指数,美国
fine
number细颗粒物
uv_rank
number紫外线等级
uv_note
string紫外线说明
array未来 7 日预报。含每日天气、气温、降水、空气质量和生活指数
on
string日期
rise
string日出
set
string日落
code
string全天天气现象代码
text
string全天天气现象
day_code
string白天天气现象代码
day_text
string白天天气现象
night_code
string夜间天气现象代码
night_text
string夜间天气现象
object全天气温,摄氏度
high
number最高
low
number最低
mean
number平均
object白天气温,摄氏度
high
number最高
low
number最低
mean
number平均
object夜间气温,摄氏度
high
number最高
low
number最低
mean
number平均
object全天体感,摄氏度
high
number最高
low
number最低
mean
number平均
object白天体感,摄氏度
high
number最高
low
number最低
mean
number平均
object夜间体感,摄氏度
high
number最高
low
number最低
mean
number平均
object湿度,0 到 1
high
number最高
low
number最低
mean
number平均
object云量,0 到 1
high
number最高
low
number最低
mean
number平均
object地面气压,帕
high
number最高
low
number最低
mean
number平均
object能见度,公里
high
number最高
low
number最低
mean
number平均
object短波辐射
high
number最高
low
number最低
mean
number平均
object阵风,公里每小时
high
number最高
low
number最低
mean
number平均
object露点,摄氏度
high
number最高
low
number最低
mean
number平均
object海平面气压,帕
high
number最高
low
number最低
mean
number平均
object全天降水量,毫米,含降水概率
high
number最高降水量,毫米
low
number最低降水量,毫米
mean
number平均降水量,毫米
chance
number降水概率,0 到 1
object白天降水量,毫米,含降水概率
high
number最高降水量,毫米
low
number最低降水量,毫米
mean
number平均降水量,毫米
chance
number降水概率,0 到 1
object夜间降水量,毫米,含降水概率
high
number最高降水量,毫米
low
number最低降水量,毫米
mean
number平均降水量,毫米
chance
number降水概率,0 到 1
object全天的风
object最大
kph
number风速,公里每小时
deg
number风向角度
object最小
kph
number风速,公里每小时
deg
number风向角度
object平均
kph
number风速,公里每小时
deg
number风向角度
object白天的风
object最大
kph
number风速,公里每小时
deg
number风向角度
object最小
kph
number风速,公里每小时
deg
number风向角度
object平均
kph
number风速,公里每小时
deg
number风向角度
object夜间的风
object最大
kph
number风速,公里每小时
deg
number风向角度
object最小
kph
number风速,公里每小时
deg
number风向角度
object平均
kph
number风速,公里每小时
deg
number风向角度
object当天空气
high_cn
number空气质量指数最高,中国
mean_cn
number空气质量指数平均,中国
low_cn
number空气质量指数最低,中国
fine_high
number细颗粒物最高
fine_mean
number细颗粒物平均
fine_low
number细颗粒物最低
object生活指数
object紫外线
rank
number等级
note
string说明
object洗车
rank
number等级
note
string说明
object穿衣
rank
number等级
note
string说明
object舒适度
rank
number等级
note
string说明
object感冒
rank
number等级
note
string说明
array当前有效的气象预警。无预警时为空数组
heading
string预警标题
detail
string预警正文
state
string预警状态
signal
string预警信号代码

响应示例

一次成功调用返回 JSON,同时包含实时天气、分钟降水、逐小时预报、未来 7 日预报和气象预警。request_id 为当次生成的十六进制标识。

响应示例
{
  "request_id": "104a8c2e01a1c84a4cf81",
  "notice": "结果仅供参考,不作为专业判断依据。请自行核实后再使用。",
  "contact": "complaint@yibudo.com",
  "name": "天气预报",
  "headline": "未来两小时不会下雨,放心出门吧",
  "issued_at": 1794361675,
  "place": {
    "lng": 118.946778,
    "lat": 25.850346,
    "zone": "Asia/Shanghai"
  },
  "now": {
    "temp_c": 18.34,
    "feels_c": 18.4,
    "moisture": 0.73,
    "cloud": 0.91,
    "code": "CLOUDY",
    "text": "阴",
    "sight_km": 16.2,
    "shortwave": 42.1,
    "gust_kph": 9.4,
    "dew_c": 13.2,
    "sea_pa": 101820,
    "ground_pa": 100640,
    "breeze": { "kph": 5.65, "deg": 37.23 },
    "rain": { "source": "radar", "rate": 0, "nearest_km": 28.4, "nearest_rate": 0.2 },
    "air": {
      "fine": 10,
      "coarse": 18,
      "ozone": 41,
      "sulfur": 4,
      "nitrogen": 12,
      "monoxide": 0.4,
      "index_cn": 30,
      "index_us": 42,
      "grade_cn": "优",
      "grade_us": "Good"
    },
    "living": { "uv": { "rank": 2, "note": "弱" }, "ease": { "rank": 3, "note": "舒适" } }
  },
  "soon": {
    "origin": "radar",
    "note": "未来两小时不会下雨,放心出门吧",
    "next_hour": [0, 0, 0, 0],
    "next_two_hours": [0, 0, 0, 0],
    "hour_totals": [0, 0],
    "chance": [0, 0, 0.05, 0.05]
  },
  "hours": {
    "note": "未来24小时阴",
    "rows": [
      {
        "at": "2026-11-11T09:00+08:00",
        "temp_c": 18.34,
        "feels_c": 18.4,
        "code": "CLOUDY",
        "text": "阴",
        "rain_mm": 0,
        "rain_chance": 0,
        "moisture": 0.73,
        "cloud": 0.91,
        "breeze_kph": 5.65,
        "breeze_deg": 37.23,
        "gust_kph": 9.4,
        "dew_c": 13.2,
        "sea_pa": 101820,
        "ground_pa": 100640,
        "sight_km": 16.2,
        "shortwave": 42.1,
        "index_cn": 30,
        "index_us": 42,
        "fine": 10,
        "uv_rank": 2,
        "uv_note": "弱"
      },
      {
        "at": "2026-11-11T10:00+08:00",
        "temp_c": 18.8,
        "feels_c": 18.9,
        "code": "CLOUDY",
        "text": "阴",
        "rain_mm": 0,
        "rain_chance": 0.05,
        "moisture": 0.71,
        "cloud": 0.88,
        "breeze_kph": 6.1,
        "breeze_deg": 40,
        "gust_kph": 10.2,
        "dew_c": 13.1,
        "sea_pa": 101790,
        "ground_pa": 100610,
        "sight_km": 16.4,
        "shortwave": 86.5,
        "index_cn": 31,
        "index_us": 43,
        "fine": 11,
        "uv_rank": 3,
        "uv_note": "弱"
      }
    ]
  },
  "days": [
    {
      "on": "2026-11-11T00:00+08:00",
      "rise": "06:19",
      "set": "17:17",
      "code": "CLOUDY",
      "text": "阴",
      "day_text": "阴",
      "night_text": "多云",
      "temp": { "high": 21.14, "low": 13.89 },
      "rain": { "mm": 0, "chance": 0.1 },
      "air": { "high_cn": 42, "mean_cn": 30, "low_cn": 18, "fine_high": 16, "fine_mean": 10, "fine_low": 6 },
      "living": { "uv": { "rank": 3, "note": "弱" }, "wash": { "rank": 2, "note": "较适宜" }, "clothes": { "rank": 4, "note": "舒适" }, "ease": { "rank": 3, "note": "舒适" }, "chill": { "rank": 2, "note": "低" } }
    },
    {
      "on": "2026-11-12T00:00+08:00",
      "rise": "06:20",
      "set": "17:16",
      "code": "PARTLY_CLOUDY_DAY",
      "text": "多云",
      "day_text": "多云",
      "night_text": "阴",
      "temp": { "high": 22.4, "low": 14.2 },
      "rain": { "mm": 0.2, "chance": 0.2 },
      "air": { "high_cn": 48, "mean_cn": 34, "low_cn": 20, "fine_high": 18, "fine_mean": 12, "fine_low": 7 },
      "living": { "uv": { "rank": 4, "note": "中等" }, "wash": { "rank": 2, "note": "较适宜" }, "clothes": { "rank": 4, "note": "舒适" }, "ease": { "rank": 3, "note": "舒适" }, "chill": { "rank": 2, "note": "低" } }
    }
  ],
  "warnings": []
}

错误码

状态码说明
400经纬度超出范围。error 为 bad_coordinates。
400语言、日起点、小时数、天数或预警不在可填范围内。error 为 bad_query。
401未提供密钥,密钥无效或已吊销,或请求头与 key 不一致。error 为 unauthorized。
403未开通、不在白名单,或余额与额度不足。error 为 forbidden。
429超过当前密钥的每秒请求次数。error 为 slow_down。
429超过接口频率策略。error 为 rate_limited。
502服务没有返回可用结果。error 为 upstream。
503天气服务未配置。error 为 weather_unconfigured。

代码示例

curl -G "https://api.yibudo.com/v1/weather" \
  -H "Authorization: Bearer <token>" \
  --data-urlencode "longitude=118.946778&latitude=25.850346&lang=zh_CN&dailystart=0&hourlysteps=24&dailysteps=7&alert=true"

SDK 下载

安装包按下面的说明获取。没有包时,先用代码示例里的 HTTP 调用。

  • Pythonpip 包未发布
  • JavaScriptnpm 包未发布
  • JavaMaven 包未发布
  • Go模块未发布

在线调试

开通后点运行,返回的是实时天气。还没开通时,运行不会去查。

GEThttps://api.yibudo.com/v1/weather
longitude东经,十进制度,范围 -180~180。不填则使用默认位置
latitude北纬,十进制度,范围 -90~90。不填则使用默认位置
lang语言代码。不填为 zh_CN
dailystart从第几天开始,0 是今天,最大 6。不填为 0
hourlysteps逐小时条数,1~24。不填为 24
dailysteps逐日条数,1~7。不填为 7
alerttrue - 带预警 / false - 不带

登录后选择已有密钥才能运行。 去登录

返回内容
选择密钥并运行后,返回内容显示在这里。

常见问题

密钥怎么传?

请求头 Authorization: Bearer,或查询参数 key。只传一个即可,两个都传时必须相同。没有后端又不想暴露密钥时,在控制台生成公开值,key 传 ybdo_pub_ 开头的那一串,并带上 bind。

不填经纬度会怎样?

用服务里保存的默认位置。经度超出 -180 到 180,或纬度超出 -90 到 90,返回 400。

会员和按次怎么一起算?

登录用户每月 500 次,可以开通,开通后直接调用。黄金、铂金、钻石每天另有 1 万、3.6 万、8 万次,预报、语音、台风、雷达、闪电、空气共用,当天作废。用完之后按 0.0015 元一次。一次买断走套餐,单价更低。

扣费按什么顺序?

按会员赠送、指定 API 套餐、点数、余额。只在已允许的来源里扣,用第一个够付的,不会改用未授权的来源。

这个页面点运行会查天气吗?

开通之后会。点运行查询的是实时天气。还没开通时,运行只说明不能调用。