一般信息
您认为 Google 的天气 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 的覆盖范围是什么？
天气 API 支持全球所有国家/地区，但日本、韩国和禁止的地区除外。 在初始发布阶段，我们支持人口稠密地区（不包括偏远地区，例如海洋中部、沙漠和山顶）。我们计划在 2025 年之前持续改进分辨率和质量。
Google Weather API 的空间粒度是多少？
数据分辨率非常高，可针对全球任何位置创建精确到几公里范围内的天气预报。
Weather API 的更新频率是多少？
| 端点 | 当前天气状况 | 每小时天气预报 | 每日天气预报 | 每小时历史记录 |
|---|---|---|---|---|
| 刷新频率 | 15 分钟（每小时内定期） | 30 分钟（每小时内定期） | 30 分钟（与每小时预报同时更新） | 每天两次（太平洋标准时间上午 7 点和下午 7 点）。 |
天气 API 是否提供临近降水预报？
Google 不会在 API 中提供临近预报（分钟级预报），但会提供当前天气状况、每小时天气预报和每日天气预报。
天气 API 是否提供单独的 UVA 和 UVB 值？
紫外线指数是一个综合了 UVA 和 UVB 的单一指数。我们不提供按组件细分的报告。
Weather API 如何生成天气预报输出？
如下图所示，天气 API 预报是在内部预测系统的基础上构建而成，该系统采用来自全球气象机构的天气模型和观测数据作为输入。利用来自公共地面实况天气传感器的数据来改进预报模型。
与主要政府天气机构的预报相比，Google 天气预报在不同地区和预测时限内的准确性如何？
表 1 中的数据比较了 Google 天气数据与政府机构提供的全球和区域天气模型在 240 小时（10 天）预测时限内，11 个月（2024 年 8 月 15 日至 2025 年 7 月 1 日）的温度和风速均方根误差 (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（降水概率）：表示降水概率。在预报位置的定义时间段内（通常为每小时）出现降水的可能性。precipitation.qpf.quantity（定量降水预报）：表示预期降水量，以深度（例如毫米或英寸）为单位。此值表示在指定时间和地点发生降水时的预期降水量。
如何确定某个位置是否在下雨？
我们建议使用 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 错误代码，并显示以下消息：“此位置的信息不可用。请尝试其他地点。”