取得每分鐘天氣預報 (實驗功能)

forecast:minutes 端點會提供特定地點的每分鐘高解析度降水預報 (也稱為即時天氣預報)。

API 會傳回 6 小時時間範圍內的下列資訊：

  • 預測時間範圍的開始和結束時間
  • 要求地點的時區
  • 每個預測區段的開始和結束時間
  • 每個時段預測的降水類型、可能性、數量和強度

條款

本條款依據《Google 地圖平台服務專屬條款》第 6 節 (正式發布前產品條款) 制定，由 Google 與您共同議定。

1.1 作者資訊相關規定。如果客戶使用 Weather API 中的 Google 地圖內容，必須按照說明文件向 Google 提供出處資訊。

1.2 限制。客戶不得使用從 Weather API 擷取的 Google 地圖內容，重新建立 Google 服務或產品 (例如在天氣應用程式或天氣模型中使用從 Weather API 擷取的資料，而這些應用程式/模型的主要用途是提供天氣資訊)。

1.3 快取。如表 1.3.1 (快取權限) 所述，客戶可在適用的快取期間，暫時快取 Weather API 適用的 Google 地圖內容。

表 1.3.1 (快取權限)

除了《Google 地圖平台服務專屬條款》表 17.2.1 所述的權限外，您還須取得這些權限。

Google 地圖內容 快取週期
每分鐘預測值 一小時，之後「客戶」必須刪除快取的 Google 地圖內容

關於分鐘預測要求

如要要求分鐘預報，請向下列網址傳送 HTTP GET 要求：

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

在要求參數中加入地點的經緯度座標。

要求參數

forecast.minutes 端點接受下列要求參數：

參數 說明 必填或選填
location.latitude 所要求位置的緯度座標。 必填
location.longitude 要求地點的經度座標。 必填
unitsSystem 要求的單位系統。相關的值包括：
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

如未指定單位系統，回應會預設為 METRIC。

 選用
pageSize 指定要傳回的結果數上限。 選用
pageToken 先前要求傳回的頁面符記。如要擷取下一頁資料，請在下一個要求中傳遞 pageToken 做為輸入參數。 選用

關於每分鐘預報的回覆

Weather API 會在回應主體中傳回下列欄位：

欄位 說明
overallPredictionTimeframe 預測的整體時間範圍。
overallPredictionTimeframe.startTime 預測時間範圍的開始時間。這反映了初始參考點。
overallPredictionTimeframe.endTime 預測時間範圍的結束時間。系統會在開始時間六小時後設定此時間。
timeZone 要求地點的時區。
segments 以分鐘為單位的預測區隔，以 timeFrame 表示。
segments.timeFrame 與區隔相關的時間範圍。
segments.timeFrame.startTime 區隔的開始時間。
segments.timeFrame.endTime 區段的結束時間。
segments.type 該時段預測的降水類型。相關的值包括：
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability 該時段的預測降水機率。值為百分比，範圍介於 0 到 100。
segments.qpf 降水量預報。
segments.qpf.quantity 該時段的預測降水量。
segments.qpf.unit 用來測量累積降雨量的單位 (例如 MILLIMETERS、INCHES)。
segments.snowfallAmount 該時段的預估降雪量。
segments.snowfallAmount.quantity 該時段的預測降雪量 (以液態水當量表示)。
segments.snowfallAmount.unit 用來測量積雪量的單位 (例如 MILLIMETERS、INCHES)。
segments.intensity 該區段的降雨強度。相關的值包括：
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken 可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

分鐘預測範例

以下範例要求西維吉尼亞州某個地點的每分鐘預報資訊：

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

在回應中，segments 物件會指出整體預測時間範圍的每個區隔：

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}