Weather API 常見問題

一般資訊

您認為 Google 的 Weather API 與專業氣象資料供應商有何不同?

Google 正在整合收購的知名氣象公司技術,以及 Google DeepMind 的 MetNet 和 WeatherNext AI 模型 (2025 年)。這項功能運用了 Google 地圖平台,可靠性有目共睹。

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. 提供,該公司是官方授權的氣象服務營運商。

印尼境內的地點僅限內部使用 Weather API。

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 預報是由內部預報系統建立,該系統會使用天氣模型,並採用來自全球氣象機構的觀測資料。公開的基準真相天氣感應器資料,可用於改善預測模型。

Weather API 預測模型圖表

與主要政府氣象機構的預報相比,Google 天氣預報在不同地區和預測時間範圍的準確度如何?

表 1 中的數據比較了 240 小時 (10 天) 預測範圍內,Google 天氣資料與政府機關全球和區域天氣模型的溫度和風速均方根誤差 (RMSE),時間跨度為 11 個月 (2024 年 8 月 15 日至 2025 年 7 月 1 日)。

在全球範圍內,Google 天氣預報的準確度超越領先政府機構的天氣預報。在歐洲和北美地區,Google 天氣資料的誤差值,低於最準確的區域政府模型,至少在預測範圍的後半段是如此。Google 氣象資料在長期預測方面的表現特別出色,而這正是最難準確預測的部分。

表 1 列出各區域模型組合相關的整個預測期平均 RMSE 值。RMSE 值越低,表示成效越好。在幾乎所有參數、區域和預測範圍中,Google 天氣預報的平均 RMSE 值都是最低或接近最低。

按一下圖片即可放大檢視。

溫度 風速
全球
北美洲
歐洲

表 1. 各區域模型組合的相關平均 RMSE 值

表 2 列出各模型相關預測時間範圍的平均 RMSE 值 (Google 值以粗體顯示)。Google 獨家擁有最低平均 RMSE 的參數 (溫度、風) 和預測範圍,會以深綠色醒目顯示。如果 Google 和其他模型在特定參數和預測範圍的平均 RMSE 最低,則會以淺綠色醒目顯示。

相關預測時間範圍的平均 RMSE 值 表 2. 每個模型相關預測時間範圍的平均 RMSE 值

歷來資料端點是否反映實際天氣資料 (即經當地測量驗證)?

歷來天氣資料主要是模型輸出內容。雖然這項服務會納入全球氣象機構的觀測資料和數值天氣預報 (NWP) 模型,但這些資料會整合至 Google 天氣模型,建立完整且一致的歷來記錄。實際觀測站的測量結果可視為特定位置的「基準真相」,但由於全球分布有限,不足以呈現完整的全球情況。

這些欄位可提供不同但相關的降水和整體天氣洞察資訊。

  • 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. 請改用其他位置。」