forecast:minutes エンドポイントは、特定の場所の高解像度で 1 分ごとの降水量予測(ナウキャストとも呼ばれます)を提供します。
API は、6 時間の期間について次の情報を返します。
- 予測期間の開始時刻と終了時刻
- リクエストされた場所のタイムゾーン
- 各予測セグメントの開始時間と終了時間
- 各セグメントにおける降水量の予測タイプ、可能性、量、強度
利用規約
これらの規約は、Google とお客様が合意した Google Maps Platform サービス固有の規約のセクション 6(一般提供前サービス規約)に基づいて発行されます。
1.1 帰属表示の要件。お客様が Weather API の Google マップ コンテンツを使用する場合、お客様はドキュメントに従って Google に帰属表示を提供する必要があります。
1.2 制限。お客様は、Weather API から取得した Google Maps コンテンツを使用して、Google サービスまたはプロダクトを再作成することはできません(例: Weather API から取得したデータを、天気情報の提供を主な目的とする天気アプリまたは天気モデルで使用する)。
1.3 キャッシュ保存。お客様は、表 1.3.1(キャッシュ保存の許可)に記載されているとおり、該当するキャッシュ保存期間中、Weather API から該当する Google マップ コンテンツを一時的にキャッシュに保存できます。
表 1.3.1(キャッシュ保存の権限)
これらの権限は、Google Maps Platform サービス固有の規約の表 17.2.1 に記載されている権限に追加されるものです。
| Google マップのコンテンツ | キャッシュ期間 |
|---|---|
| 分単位の予測値 | 1 時間。その後、お客様はキャッシュされた Google Maps コンテンツを削除する必要があります。 |
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 |
リクエストされた単位系。次の値があります。
単位系が指定されていない場合、レスポンスはデフォルトで |
省略可 |
pageSize |
返される結果の最大数を指定します。 | 省略可 |
pageToken |
前回の呼び出しから受け取ったページトークン。次のページのデータを取得するには、次のリクエストで pageToken を入力パラメータとして渡します。 |
省略可 |
分単位の予測の回答について
Weather API は、レスポンス本文で次のフィールドを返します。
| フィールド | 説明 |
|---|---|
overallPredictionTimeframe |
予測の全体的な期間。 |
overallPredictionTimeframe.startTime |
予測期間の開始時間。これは最初の基準点を反映しています。 |
overallPredictionTimeframe.endTime |
予測期間の終了時刻。これは開始時刻の 6 時間後に設定されます。 |
timeZone |
リクエストされた場所のタイムゾーン。 |
segments |
分単位の予測セグメント(timeFrame で表されます)。 |
segments.timeFrame |
セグメントに関連する期間。 |
segments.timeFrame.startTime |
セグメントの開始時間。 |
segments.timeFrame.endTime |
セグメントの終了時刻。 |
segments.type |
そのセグメント中の予測される降水の種類。次の値があります。
|
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 |
セグメントの降水強度(PrecipitationIntensity)。次の値があります。
注: クライアントが不明な値を処理できることを確認してください。 |
nextPageToken |
次のページを取得するために pageToken として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。 |
分単位の予測の例
次の例では、ウェストバージニア州の場所の 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" }, ... ] }