Description

提供全球当前天气、预报与历史天气等数据查询，适合地图、出行与物联网应用。

Features

  • Current Weather
  • Forecast
  • Historical
  • Geocoding

适用场景

OpenWeatherMap 适合出行、户外、IoT 设备、地图叠加层与轻量天气展示。需要全球覆盖与多种预报粒度时，它是常见候选之一；国内精细场景可能还需与本地气象源对比。

接入要点

HTTP GET + API Key，支持 JSON / XML。功能含 Current Weather、Forecast、Historical、Geocoding。注意坐标系与 city id：地理编码与实况/预报接口组合使用，避免重复计费。

  • 免费档有调用频率与功能限制，读文档中的 subscription 表
  • 缓存同一坐标结果，遵守官方缓存政策
  • 历史与预报接口字段不同，前端映射表要分版本维护

选型注意

对比数据更新频率、预报天数、商业授权条款与国内城市精度。若仅服务中国用户，可同时评估国内地图/天气 API 的合规与延迟。

常见坑

未做单位换算（开尔文/摄氏）；时区与「日级预报」对齐错误；Key 暴露在客户端被刷量。建议服务端代理天气请求并做 IP 级限流。

官方文档提醒

套餐与端点列表以 https://openweathermap.org/api 为准。One Call API 等聚合接口可能替代多次调用，有助于降本。

信息用于导航与了解；功能与价格可能变更，请以官方文档为准。