1 分単位の天気予報を取得する（試験運用版）

forecast:minutes エンドポイントは、特定の場所について、高解像度の 1 分ごとの降水予報（ナウキャストとも呼ばれます）を提供します。

API は、6 時間の期間について次の情報を返します。

  • 予測期間の開始時間と終了時間
  • リクエストされた場所のタイムゾーン
  • 各予測セグメントの開始時間と終了時間
  • 各セグメントの降水の種類、可能性、量、強度の予測

利用規約

これらの規約は、Google とお客様が合意した Google Maps Platform サービス固有の規約の第 6 項（一般提供前サービス規約）に基づいて発行されます。

1.1 帰属表示の要件。お客様が Weather API の Google マップ コンテンツを使用する場合、ドキュメントに従って Google に帰属表示を提供する必要があります。

1.2 制限。お客様は、Weather API から取得した Google マップ コンテンツを使用して、Google のサービスやプロダクトを再作成することはできません（たとえば、Weather API から取得したデータを、天気予報アプリや天気予報モデルで使用することはできません。これらのアプリやモデルの主な目的は、天気情報を提供することです）。

1.3 キャッシュ保存。お客様は、表 1.3.1（キャッシュ保存の権限）に記載されているとおり、該当するキャッシュ保存期間の間、該当する Google マップ コンテンツを Weather API から一時的にキャッシュ保存できます。

表 1.3.1（権限のキャッシュ保存）

これらの権限は、Google Maps Platform サービス固有の規約の表 17.2.1 に記載されている権限に追加されるものです。

Google マップのコンテンツ キャッシュ保存期間
1 分単位の予測値 1 時間。その後、顧客はキャッシュされた Google マップ コンテンツを削除する必要がある

1 分あたりの予測リクエストについて

1 分単位の予測をリクエストするには、次の URL に 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 を入力パラメータとして渡します。 省略可

1 分単位の予測レスポンスについて

Weather API は、レスポンスの本文で次のフィールドを返します。

フィールド 説明
overallPredictionTimeframe 予測の全体的な期間。
overallPredictionTimeframe.startTime 予測期間の開始時刻。これは最初の基準点を反映しています。
overallPredictionTimeframe.endTime 予測期間の終了時刻。これは開始時間の 6 時間後に設定されます。
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 として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

1 分単位の天気予報の例

次の例では、ウェストバージニア州の場所の 1 分単位の天気予報情報をリクエストしています。

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