Weather API 常见问题解答

一般信息

您认为 Google 的天气 API 与专业天气数据供应商有何不同?

Google 正在将收购的知名天气公司的技术与 Google DeepMind 的 MetNetWeatherNext AI 模型(2025 年)的最新进展相整合。这利用了 Google Maps Platform 经过验证的可靠性。

Earth Engine 和 BigQuery 中提供的天气数据与 Google 的 Weather API 之间有何区别?

Google 的天气产品套件提供了一系列全面的解决方案,可满足各种需求。WeatherNext 模型(即 GraphCastGenCast)提供基于 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 预报是在内部预测系统的基础上构建而成,该系统采用来自全球气象机构的天气模型和观测数据作为输入。利用来自公共地面实况天气传感器的数据来改进预报模型。

天气 API 预报模型图

准确率是多少?Google 如何评估和衡量 Weather API 的准确性表现?

数据分辨率非常高,可针对全球任何位置生成精确到几公里的天气预报,在美国和欧洲则可生成分辨率更高的天气预报。通过持续内部监控预报质量(与最高质量气象站的观测结果进行比较),可确保数据质量始终如一。

根据内部报告,在美国本土 1-2 天预报中,我们的温度均方根误差 (RMSE)(以摄氏度为单位)与标准答案相比小于 2.2°C;在 5 天预报中,我们的温度均方根误差 (RMSE)(以摄氏度为单位)与标准答案相比小于 2.9°C。

此外:

  • 我们会针对数千万个地点生成实时预报,以便为全球几乎所有地区提供超本地化天气预报。
  • 通过与标准答案进行比较,我们发现与现有的基于数值的天气预报模型相比,我们的模型可以生成更高质量的温度、等变量的预报。
  • 我们会不断验证和改进模型,以确保提供最先进的预测。

历史数据端点是否反映实际天气数据(即经过本地测量验证的数据)?

历史天气数据主要是模型输出。虽然它纳入了全球气象机构的观测数据和数值天气预报 (NWP) 模型,但这些数据会整合到 Google 天气模型中,以创建完整且一致的历史记录。实际气象站测量数据在其特定位置被视为“实况”,但其全球分布有限,不足以提供完整的全球天气图。

这些字段可提供有关降水和整体天气的不同但相关的数据分析。

  • 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.percentprecipitation.qpf.quantity(过去一小时内累积),currentConditions 响应中呈现的值始终源自最新的天气预报。概率本身是一种模型估算量,而不是直接观测量。

这种方法使我们即使在没有直接传感器覆盖的区域也能提供全面的“当前状况”,确保随时提供最佳可用信息。

API 限制和访问权限

API 是否有速率限制?

对于 Weather API,默认速率限制为每分钟 6,000 次查询。

我可以批量访问数据吗?

批量数据不可用。您可以在配额范围内(每分钟 6,000 次查询)查询 Weather API,并遵守服务条款中规定的缓存条款。

我是否必须启用结算功能?

您必须拥有有效的结算账号才能使用 Weather API。如需为项目设置结算账号,请参阅启用结算功能

如果我查询不支持的位置,会发生什么情况?

如果纬度和经度不在支持的国家/地区列表中,响应将返回 404 错误代码,并显示以下消息:“此位置的信息不可用。请尝试其他位置。”