一般信息
Google 的 Weather API 与专业天气数据供应商有何不同？
Google 正在将我们收购的知名天气公司的技术与 Google DeepMind 的 MetNet 和 WeatherNext AI 模型 (2025) 的先进技术相结合。这充分利用了 Google Maps Platform 经过验证的可靠性。
Earth Engine 和 BigQuery 中提供的天气数据与 Google 的 Weather API 有何区别？
Google 的天气产品套件提供了一系列全面的解决方案，可满足各种需求。WeatherNext 模型（即 GraphCast 和 GenCast）提供基于 AI 的原始模型预测输出，包括非常适合研究、建模和分析的参数，这些参数可通过开源代码以及使用 Earth Engine 和 BigQuery API 的历史或当前天气数据集获取。
相反，Google Maps Platform Weather API 结合 AI 和传统预报系统，以方便开发者使用的格式提供当前天气实况、每小时预报及每日预报数据，可无缝集成到应用和 Web 服务中。这种双重方法既能满足专业研究需求，又能让广大开发者轻松上手。
为什么 Google 不仅依赖气象站的测量数据？
Google 的天气模型会使用各种输入来源，包括气象站的观测数据、数值天气预测模型和天气 AI 模型。之所以使用这些不同的输入来源，是因为气象站的观测数据仅提供测量时气象站所在位置的天气信息。气象站观测数据对于特定地点可能非常准确，但降水等天气现象（尤其是阵雨或雷暴）通常具有局部性，并且在短距离内可能会有很大差异。
例如，气象站所在的位置可能正在下大雨，而几英里外可能只是毛毛雨或根本没有下雨。由于单个监测站的读数可能无法代表更广泛的区域，因此需要使用模型来提供监测站之间的额外信息。
此外，气象站通常会提供每小时或每半小时的读数。 即使这些数据是近乎实时提供的，实际降水事件与其报告之间仍可能存在轻微延迟。模型还有助于使当前空气状况尽可能接近查询位置的实际情况。
API 用量
Weather API 的覆盖范围是什么？
Weather API 支持全球所有国家/地区，但禁止的地区除外。对于日本和韩国，天气数据由获得官方许可的气象服务运营商 Weathernews Inc. 提供。
Google Weather API 的空间粒度是多少？
数据分辨率很高，可以为全球任何地点创建几公里范围内的预测。
Weather API 的更新频率如何？
| 端点 | 当前天气状况 | 每小时天气预报 | 每日天气预报 | 每小时历史记录 |
|---|---|---|---|---|
| 刷新率 | 实时计算。 | 每小时刷新一次。 | 每小时刷新一次。 | 每天两次（太平洋标准时间上午 7 点和晚上 7 点）。 |
- 短期降水（预报的前 12 小时）：使用雷达和高分辨率临近预报模型，每 2 到 15 分钟刷新一次。
- 非降水和降水时间范围延长（最长 10 天）：每小时刷新一次，确保提供最新的预测指导。
Weather API 是否提供临近降水预报？
Google 不会在 API 中提供临近预报（分钟级预报），但会提供当前天气实况、每小时预报和每日预报。
Weather API 是否提供单独的 UVA 和 UVB 值？
紫外线指数是结合了 UVA 和 UVB 的单一指数。我们不提供按组件细分的费用。
Weather API 如何生成预测输出？
如下图所示，Weather API 预报是在一个内部预测系统的基础上构建而成的，该系统采用来自全球气象机构的天气模型和观测数据作为输入。来自公共标准答案天气传感器的数据用于改进预测模型。
与领先的政府气象机构的预报相比，Google 天气预报在不同地区和不同预报时段的准确性如何？
表 1 中的数据比较了 Google 天气数据与政府机构的全球和区域天气模型在 11 个月（2024 年 8 月 15 日至 2025 年 7 月 1 日）内 240 小时（10 天）预测范围内的温度和风速均方根误差 (RMSE)。
在全球范围内，Google 天气预报的表现优于领先政府机构的天气预报。对于欧洲和北美，Google 天气数据的误差低于最准确的区域政府模型，至少在预测范围的后期部分是如此。Google 天气数据在较长预测期内的出色表现尤为引人注目，因为较长预测期往往最难准确预测。
表 1 列出了每个区域模型组合的相关整个预测范围的平均 RMSE 值。RMSE 值越低，表示性能越好。对于几乎所有参数、区域和预测范围，Google 天气预报的平均 RMSE 值都是最低或接近最低。
点击图片即可查看放大的版本。
| 温度 | 风速 | |
|---|---|---|
| 全球 |  |
 |
| 北美洲 |  |
 |
| 欧洲 |  |
 |
表 1. 每个区域模型组合的相关平均 RMSE 值
表 2 列出了每个模型在相关预测范围内的平均 RMSE 值（Google 值以粗体显示）。Google 独家拥有最低平均 RMSE 的参数（温度、风速）和预测范围以深绿色突出显示。Google 与其他模型具有最低平均 RMSE 的参数和预测范围以浅绿色突出显示。
表 2. 每个模型的相关预测范围的平均 RMSE 值
历史数据端点是否反映了实际天气数据（即通过本地测量验证的数据）？
历史天气数据主要是模型输出。虽然它整合了全球气象机构的观测数据和数值天气预报 (NWP) 模型，但这些数据会被同化到 Google 天气模型中，以创建完整且一致的历史记录。实际站点测量值被视为其特定位置的“标准答案”，但由于其全球分布有限，因此不足以提供完整的全球情况。
weatherCondition、precipitation.probability.percent、precipitation.qpf.quantity 字段分别代表什么？它们之间有何关系？
这些字段提供了关于降水和整体天气的不同但相关的分析。
weatherCondition：此字段提供对所查询区域整体天气状况的一般性、直观描述，并考虑了各种参数，以便于理解。precipitation.probability.percent(PoP)：这表示降水概率。在指定时间段内（通常为每小时），预报位置发生降水的可能性。precipitation.qpf.quantity(QPF)：这代表定量降水预报，表示预期降水量，以深度（例如毫米或英寸）衡量。此值表示如果降水确实在指定时间和地点发生，预计会有多少降水量。
如何确定某个地点是否在下雨？
我们建议您使用 weatherCondition 字段来了解某个位置是否在下雨。多个条件可以表示正在下雨（RAIN、LIGHT RAIN、RAIN SHOWERS、HEAVY RAIN、WIND AND RAIN、THUNDERSTORM、HEAVY THUNDERSTORM、THUNDERSHOWER、SCATTERED SHOWERS、LIGHT THUNDERSTORM RAIN、SCATTERED THUNDERSTORMS、RAIN AND SNOW）。这些条件旨在捕获所有小雨、大雨、持续降雨或分散降雨的情况，并区分雨和雪。根据您的具体应用场景（例如，如果您的应用场景仅考虑强降雨），您可以选择仅使用这些条件的相关子集。
“当前状况”是否等同于气象站位置的观测结果？在没有气象站的地点，如何确定“当前天气状况”？
我们的“当前天气状况”通过整合各种数据源来提供最新的天气信息，但在所有情况下，这些信息并不完全等同于气象站的直接观测数据。
对于 precipitation.probability.percent 和 precipitation.qpf.quantity（过去一小时内累积），currentConditions 响应中显示的值始终来自最新预测。概率本身是模型估算出的数量，而不是直接观测到的数量。
这种方法使我们即使在没有直接传感器覆盖的区域也能提供全面的“当前状况”，确保始终提供最准确的信息。
API 限制和访问权限
API 是否有速率限制？
Weather API 的默认速率限制为每分钟 6,000 次查询。
我可以批量访问数据吗？
无法提供批量数据。您可以在配额（6,000 QPM）内查询 Weather API，并遵守服务条款中概述的缓存条款。
我必须启用结算功能吗？
您必须拥有有效的结算账号才能使用 Weather API。请参阅启用结算功能，为您的项目设置结算账号。
如果我查询不受支持的位置，会发生什么情况？
如果纬度和经度不在支持的国家/地区列表中，响应将返回 404 错误代码，并显示消息“此位置的信息不可用。请换个地点试试。”