一次请求怎么算钱
和风天气是自然月结账、按小时结算的阶梯累进计价。天气与基础服务这一组,每月前 50,000 次请求 0 元,往后的 950,000 次每次 0.0007 元,再往上是 0.0005、0.00035、0.00015、0.0001 元五档。官方给的算例是 100 万次/月,账单 665 元。
| 每月请求量区间 | 单价 | 说明 |
|---|---|---|
| 0 – 50,000 | CNY 0 | 免费额度 |
| 之后的 950,000 | CNY 0.0007 | 到 100 万次/月 |
| 之后的 4,000,000 | CNY 0.0005 | 到 500 万次/月 |
| 之后的 5,000,000 | CNY 0.00035 | 到 1,000 万次/月 |
| 之后的 40,000,000 | CNY 0.00015 | 到 5,000 万次/月 |
注意台风与海洋数据是另一套价:从 0.003 元/次起,是天气服务的四倍多;太阳辐照从 0.3 元/次起,按次算比按量算更贵。做台风路径这类功能前先算清楚,别默认它和天气同价。

图:按量计费定价文档,天气与基础服务首档 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 分钟 |

图:和风天气「缓存你的数据」文档,正文给了弹性缓存与清除缓存的注意事项
我的接入顺序
把天气接进页面,顺序比代码重要:
- 服务端拿 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 请求刷接口。
网友评论