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 時間。その後、顧客はキャッシュされた Google マップ コンテンツを削除する必要がある

1 分単位の予測リクエストについて

分単位の予測をリクエストするには、次の宛先に 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"
    },
    ...
  ]
}