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

forecast:minutes 端點提供特定地點的高解析度降水預報 (也稱為即時預報)，以分鐘為單位。

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

  • 預測時間範圍的開始和結束時間
  • 要求地點的時區
  • 每個預測區隔的開始和結束時間
  • 各個時段的預測降水類型、降水機率、降水量和降水強度

條款

這些條款是依據 Google 與您同意的《Google 地圖平台服務專屬條款》第 6 節 (正式發布前產品條款) 發布。

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"
    },
    ...
  ]
}