天气 API 接入:从 Key 到缓存策略的成本账

更新时间:2026-11-22 07:45:53

访问次数:3

详细介绍
一句话结论:天气 API 的成本几乎全由轮询频率决定:同样的免费额度,10 分钟刷和 30 分钟刷差了 3 倍。先把缓存表定下来,再接代码。

一次请求怎么算钱

和风天气是自然月结账、按小时结算的阶梯累进计价。天气与基础服务这一组,每月前 50,000 次请求 0 元,往后的 950,000 次每次 0.0007 元,再往上是 0.0005、0.00035、0.00015、0.0001 元五档。官方给的算例是 100 万次/月,账单 665 元。

每月请求量区间单价说明
0 – 50,000CNY 0免费额度
之后的 950,000CNY 0.0007到 100 万次/月
之后的 4,000,000CNY 0.0005到 500 万次/月
之后的 5,000,000CNY 0.00035到 1,000 万次/月
之后的 40,000,000CNY 0.00015到 5,000 万次/月

注意台风与海洋数据是另一套价:从 0.003 元/次起,是天气服务的四倍多;太阳辐照从 0.3 元/次起,按次算比按量算更贵。做台风路径这类功能前先算清楚,别默认它和天气同价。

天气 API 接入:从 Key 到缓存策略的成本账

图:按量计费定价文档,天气与基础服务首档 0 元,100 万次/月的算例是 665 元

官方推荐的缓存时间,直接抄

和风天气在最佳实践里给了一张推荐表,我把最常用的几行抄在下面。左边是建议缓存时长,右边是它的数据更新频率——缓存时间不该超过更新频率太多,否则用户看到的是过期数据。

数据类型推荐缓存官方更新频率
实时天气10–30 分钟5–10 分钟
分钟降水5–10 分钟5 分钟
天气预警5–20 分钟3 分钟
逐小时预报30–60 分钟60 分钟
逐天预报1–6 小时60 分钟
实时空气质量30–60 分钟30–60 分钟
台风(活跃期)20 分钟10–60 分钟

天气 API 接入:从 Key 到缓存策略的成本账(2)

图:和风天气「缓存你的数据」文档,正文给了弹性缓存与清除缓存的注意事项

我的接入顺序

把天气接进页面,顺序比代码重要:

  • 服务端拿 Key,走 JWT 鉴权,前端只调自己的接口;
  • 给每个「城市 × 接口」建一条缓存,键名带城市 ID 和接口名;
  • 定时任务统一刷新,而不是用户来了才去请求——这样 100 个用户来访只消耗 1 次额度;
  • 缓存里带「数据发布时间」,页面显示「更新于 xx:xx」,比假装实时诚实;
  • 留一个手动清除缓存的入口,官方明确建议要有这个能力,出问题时不用发版。

还有两个跨小时的坑是我自己踩的:逐天预报在 23:00 缓存,过了 00:00 不刷新,用户看到的第一天就变成昨天;跨夏令时切换的地区,如果按固定小时偏移做刷新,会在切换那天错一小时。所以缓存必须带日期边界,不能只按「多少分钟」算。

额度算例:一个城市页要花多少

按我上面的配置算一遍,一个城市页面的日调用量是这样的:实时天气 10 分钟一刷 = 144 次;分钟降水 5 分钟 = 288 次;预警 5 分钟 = 288 次;逐天预报 1 小时 = 24 次;空气质量 30 分钟 = 48 次。合计约 792 次/日,一个月 2.4 万次。

5 万次的免费额度能撑两个城市。想撑到 10 个城市,只有三条路:把分钟降水改成按需触发(用户点开才查)、把预警轮询降到 15 分钟、或者干脆接受每月多出几十块。我选的是第二条加第三条组合——预警 15 分钟一次完全够用,灾害预警的官方更新周期是 3 分钟,但不代表用户需要 3 分钟就看到。

不能碰的几条线

  • GeoAPI 的地理数据禁止批量缓存、下载或建索引,这条写在使用限制里,违反会涉及数据源版权;
  • 必须注明来源,空气质量接口返回的 refer.sources 要完整显示、不能修改;
  • 只支持 HTTPS,2016 年底起非 HTTPS 访问已关闭;
  • 错误请求超过合理范围会被当作攻击,可能冻结账号,别拿 404 请求刷接口。

网友评论