一般信息
您如何区分 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 支持全球所有国家/地区，但日本、韩国和 受禁 地区除外。 在首次发布时，我们支持人口稠密地区（不包括偏远地区，例如海洋中部、沙漠和山顶）。我们计划在 2025 年之前不断改进分辨率和质量。
Google 天气 API 的空间粒度是什么？
数据分辨率是指，对于全球任何位置，预测都是在几公里范围内创建的。
Weather API 的更新频率是多少？
| 端点 | 当前天气状况 | 每小时天气预报 | 每日天气预报 | 每小时历史天气数据 |
|---|---|---|---|---|
| 刷新频率 | 15 分钟（每小时内定期刷新） | 30 分钟（每小时内定期刷新） | 30 分钟（与每小时天气预报同时更新） | 每天两次（太平洋标准时间上午 7 点和晚上 7 点）。 |
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 次查询）内查询 Weather API，并遵守服务条款中概述的缓存条款。
我是否必须启用结算功能？
您需要有效的结算账号才能使用 Weather API。如需为项目设置结算账号，请参阅启用 结算功能。
如果我查询不支持的位置，会发生什么情况？
如果纬度和经度不在受支持的国家/地区列表中，响应将返回 404 错误代码，并显示消息“Information is unavailable for this location. Please try a different location.”（此位置的信息不可用。请尝试其他位置）。