
这是什么
和风天气(QWeather)是国内团队做的气象数据服务,覆盖天气预报、分钟级降水、灾害预警、天气指数、空气质量、时光机历史数据、GeoAPI 地理信息、天文、台风与海洋、太阳辐射。它采用按量计费、自然月结账,按小时结算,阶梯价累进:天气和基础服务每月前 50,000 次请求 0 元,往后的 950,000 次每次 0.0007 元,官方举例 100 万次/月的账单是 665 元。台风与海洋数据从 0.003 元/次起,太阳辐照从 0.3 元/次起。
它的条款比多数国内 API 直白:数据更新频率是公开的(实时天气 5–10 分钟、预警 3 分钟、逐天预报 60 分钟),缓存建议也写进了文档。同时限制也明确:必须在使用它的产品里注明来源;空气质量接口返回的 refer.sources 必须完整显示、不能修改;GeoAPI 的地理数据不允许批量缓存、下载或建索引。
我怎么用它
- 注册后在控制台建项目、拿 Key,用 JWT 方式鉴权(比把 Key 摆在 URL 里安全);
- 请求走 devapi.qweather.com,服务端调用,Key 不进前端;
- 按官方推荐设缓存:实时天气 10–30 分钟、预警 5–20 分钟、逐天预报 1–6 小时;
- 页面底部固定放一句「天气数据由和风天气提供」,空气质量区块把 refer.sources 原样输出;
- 控制台里给 Key 开应用限制(网址或 IP 白名单),限定它只能被自己的域名调用。
一个城市页面的成本我可以算得很清楚:如果按 10 分钟缓存刷新实时天气,一天是 144 次,一个月 4,320 次,还不到免费额度的 9%。真正吃额度的是分钟级降水和预警轮询——分钟降水我设 5 分钟,一天 288 次;预警 5 分钟一次,一天也是 288 次。三个接口叠起来,一个城市一天约 720 次,一个月 2.16 万次,两个城市就把 5 万次免费额度用掉大半。
上手截图

图:和风天气首页,北京当天实况 -1℃ 晴、空气质量 61 良,数据来自自家接口

图:按量计费定价文档,天气与基础服务前 5 万次请求为 0 元,100 万次/月的算例是 665 元
优点
- 每月 5 万次免费,折合每天 1,666 次,个人站和小工具基本零成本;
- 缓存策略、更新频率、错误码全写在文档里,不用猜;
- 支持 Gzip 压缩,返回体积小;
- 国内城市列表、多语言、单位换算这些边角料都给了现成的;
- 价格阶梯透明,量大了单价往下走,不是一口价。
缺点
- 必须注明来源,空气质量还要完整显示 refer.sources,做白标产品要提前评估;
- GeoAPI 的地理数据不允许批量缓存或建索引,想落库做本地检索这条路走不通;
- 只支持 HTTPS(2016 年底就关掉了非 HTTPS 访问),老系统要确认能走 TLS;
- 免费额度用完后 0.0007 元/次,看着便宜,百万级日调用就是每月几千块;
- 错误请求超过合理范围会被当成攻击,可能冻结账号。
什么时候别用它
要把全国 POI 或行政区边界批量落到自己库里做检索的项目,别用它——GeoAPI 明确禁止批量缓存和建索引。日均请求上百万次的也别自己硬扛阶梯价,官方建议直接联系商务谈方案。纯粹展示气候常识、不需要实时数据的场景,用公开气象数据集更省事。
网友评论