Method: flashFloods.search

鉄砲水を検索します。現在アクティブな最新の鉄砲水イベントまたは予測された鉄砲水イベントを返します。詳しくは、https://support.google.com/flood-hub/answer/16811681 をご覧ください。

HTTP リクエスト

POST https://floodforecasting.googleapis.com/v1/flashFloods:search

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
フィールド
countryCodes[]

string

省略可。鉄砲水を検索する国コード。ISO 3166 alpha-2 形式（「US」など）。指定しない場合、すべての国の鉄砲水が返されます。
pageSize

integer

省略可。返すイベントの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 10,000 件のイベントが返されます。最大値は 10,000 です。10,000 を超える値は 10,000 に強制変換されます。
pageToken

string

省略可。前回の flashFloods.search 呼び出しから受け取ったページトークン。後続のページを取得するには、これを指定します。ページ分割を行う場合、flashFloods.search に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。

レスポンスの本文

[flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods] のレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "flashFloodEvents": [
    {
      object (FlashFloodEvent)
    }
  ],
  "nextPageToken": string
}
フィールド
flashFloodEvents[]

object (FlashFloodEvent)

リクエスト条件に基づいて検出された鉄砲水イベント。
nextPageToken

string

省略可。次のページを取得するために pageToken として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

FlashFloodEvent

鉄砲水。forecastIssueTime から forecastPeriodHours までの期間を表します。この期間内に鉄砲水が発生すると予想されます。

JSON 表現 
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
フィールド
forecastIssueTime

string

この予測が発行された時刻。ISO 8601 形式で表されます（例: 「2025-10-17T10:34:00Z」）。
forecastPeriodHours

integer

予報の有効期間（時間単位）。
affectedCountryCodes[]

string

イベントの影響を受けると予測される国。ISO 3166 alpha-2 形式（例: 「US」）。
likelyAffectedPolygonId

string

鉄砲水の影響を受ける可能性のある地域のポリゴン。ポリゴン ID を [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] に送信して、イベントのエリアのポリゴンを取得できます。
highlyLikelyAffectedPolygonId

string

鉄砲水の影響を受ける可能性が高いエリアのポリゴン。ポリゴン ID を [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] に送信して、イベントのエリアのポリゴンを取得できます。
eventPolygonId

string

イベントの境界領域のポリゴン ID。これは、可能性が高いポリゴンと可能性が非常に高いポリゴンの和集合です。ポリゴン ID を [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] に送信して、イベントの境界領域のポリゴンを取得できます。