天气预报国际版指南总目录：从快速开始到 AI 集成的 12 篇实战指南

# 天气预报国际版指南总目录：从快速开始到 AI 集成的 12 篇实战指南 > 接口：天气预报国际版（apiCode=3540）· 免费接口 · 3 个接入点 · POST/GET · JSON · 适用人群：所有接入全球天气数据的开发者 · 阅读时间：约 5 分钟（本页为导航页） ## 核心要点 - 天气预报国际版通过多个全球天气服务商与高分辨率本地天气模型，覆盖全球数百万个地点，提供**当前天气、24 小时预报、14 天预报**三个接入点，注册后默认可免费调用。 - 定位方式二选一：城市名 `name`（支持英文、中文较少）或经纬度 `lon`/`lat`；本系列所有技术点均经真实接口实测验证。 - 全系列 12 篇覆盖：入门 3 篇 → 场景实战 5 篇 → 技术深挖 2 篇 → 生态集成 2 篇，从第一次调用一路讲到 AI 客户端集成与团队接口治理。 ## 接口一句话速览 通过与多个全球天气服务商及高分辨率本地天气模型合作，提供覆盖全球数百万个地点的天气信息访问，助力各类应用场景的天气数据需求。官方自营（昆明秀派科技有限公司），免费接口，为防滥用设有使用档次限制。 ## 全系列文章（按阅读顺序） ### 【入门层】降低首次调用成本 1. [天气预报国际版：5 分钟快速开始（注册到第一次全球天气查询）](https://www.showapi.com/guides/global-weather-quickstart-3540) —— 注册、拿 AppKey、跑通第一次调用，可复制即用的多语言代码。 2. [天气预报国际版：定位参数怎么传（城市名 name 与经纬度 lon/lat 的选择）](https://www.showapi.com/guides/global-weather-location-params-3540) —— 三参数规则、实测错误行为（不传参数返回什么）、中英文城市名实测。 3. [天气预报国际版：返回字段全解（cityInfo / now / hourList / dayList 一文读懂）](https://www.showapi.com/guides/global-weather-response-fields-3540) —— 三个接入点完整返回结构 + 字段速查表，收藏当字典用。 ### 【场景实战层】解决具体业务问题 4. [天气预报国际版：当前天气接入实战（气温、体感、风、降水概率全字段）](https://www.showapi.com/guides/global-weather-current-weather-3540) —— `now` 对象逐字段讲解，做首页天气卡片段落。 5. [天气预报国际版：空气质量数据接入实战（AQI 与六项污染物指标）](https://www.showapi.com/guides/global-weather-air-quality-3540) —— `air_quality` 对象七项指标速查与健康提醒逻辑。 6. [天气预报国际版：24 小时预报接入实战（逐小时天气卡片与出行提醒）](https://www.showapi.com/guides/global-weather-hourly-forecast-3540) —— `hourList` 逐时数据、当地时区处理、降雨概率提醒。 7. [天气预报国际版：14 天预报接入实战（行程规划与日出日落、月相字段）](https://www.showapi.com/guides/global-weather-14day-forecast-3540) —— `dayList` 温幅/降水/风与日出日落、月相字段（含实测容错点）。 8. [天气预报国际版：太阳辐射与紫外线字段解读（short_rad / dni / gti / uv）](https://www.showapi.com/guides/global-weather-radiation-uv-3540) —— 四类辐射字段 + UV 的单位、含义与实测观察。 ### 【技术深挖层】建立专业壁垒 9. [天气预报国际版：免费档位下的缓存策略设计（用 Redis 省调用量）](https://www.showapi.com/guides/global-weather-cache-cost-3540) —— TTL 设计、Redis 结构、失败调用不扣次的实测事实。 10. [天气预报国际版：多城市天气批量管理（无批量接口下的循环与并发控制）](https://www.showapi.com/guides/global-weather-multicity-3540) —— 接口无批量能力的如实说明 + 限速并发生产级写法。 ### 【生态集成层】扩大使用场景 11. [天气预报国际版：通过 MCP 在 AI 客户端中直接查天气](https://www.showapi.com/guides/global-weather-mcp-integration-3540) —— 一段 MCP JSON 让 Cherry Studio / ChatBox 等 AI 客户端直接用上全球天气。 12. [天气预报国际版：导入 Postman / Swagger UI，用 OpenAPI 文档管理接口](https://www.showapi.com/guides/global-weather-openapi-postman-3540) —— 官方 OpenAPI 3.0 文档导入 Postman / Swagger UI，建立团队接口资产。 ## 相关资源 | 资源 | 链接 | |------|------| | 接口详情页（apiCode=3540） | https://www.showapi.com/apiGateway/view/3540 | | 接入点 1：查询当前天气 | https://www.showapi.com/apiGateway/view/3540/1 | | 接入点 2：查询24小时预报 | https://www.showapi.com/apiGateway/view/3540/2 | | 接入点 3：查询14天预报 | https://www.showapi.com/apiGateway/view/3540/3 | | OpenAPI 文档（YAML） | https://www.showapi.com/openapi/market/3540.yaml | | OpenAPI 文档（JSON） | https://www.showapi.com/openapi/market/3540.json | | AppKey 管理（控制台） | https://www.showapi.com/console#/myApp | | 免费接口档位说明 | https://www.showapi.com/free-api | | 调用帮助 | https://www.showapi.com/helpcenter/view#/3960/1 | ## 阅读建议 - **第一次接触**：按编号 1 → 2 → 3 读完入门层，即可独立完成接入。 - **有明确场景**：直接跳到对应场景篇（4~8），再按需回看字段全解。 - **已上线运行**：读技术深挖层（9~10）优化成本与稳定性；AI / 团队协作需求看（11~12）。