Method: flashFloods.search

Nach Sturzfluten suchen Gibt die neuesten aktuell aktiven oder prognostizierten Sturzflutereignisse zurück. Weitere Informationen finden Sie unter https://support.google.com/flood-hub/answer/16811681.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
Felder
countryCodes[]

string

Optional. Die Ländercodes, nach denen nach Sturzfluten gesucht werden soll. Im Alpha-2-Format nach ISO 3166, z.B. „US“. Wenn nicht angegeben, werden Sturzfluten für alle Länder zurückgegeben.

pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Ereignisse. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 10.000 Ereignisse zurückgegeben. Der Höchstwert ist 10.000. Werte über 10.000 werden implizit auf 10.000 umgewandelt.

pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen flashFloods.search-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen für flashFloods.search bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Antworttext

Die Antwort von [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods].

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "flashFloodEvents": [
    {
      object (FlashFloodEvent)
    }
  ],
  "nextPageToken": string
}
Felder
flashFloodEvents[]

object (FlashFloodEvent)

Die auf Grundlage der Anfragekriterien gefundenen Sturzflutereignisse.

nextPageToken

string

Optional. Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

FlashFloodEvent

Eine Sturzflut. Er steht für einen Zeitraum, der bei forecastIssueTime beginnt und forecastPeriodHours dauert und in dem wir mit einer Sturzflut rechnen.

JSON-Darstellung
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
Felder
forecastIssueTime

string

Der Zeitpunkt, zu dem diese Prognose erstellt wurde. Dargestellt als ISO 8601, z.B. „2025-10-17T10:34:00Z“.

forecastPeriodHours

integer

Wie lange die Vorhersage gültig ist (in Stunden).

affectedCountryCodes[]

string

Die Länder, die voraussichtlich von dem Ereignis betroffen sein werden, im ISO 3166-Alpha-2-Format, z.B. „US“.

likelyAffectedPolygonId

string

Das Polygon des Gebiets, das wahrscheinlich von einer Sturzflut betroffen sein wird. Die Polygon-ID kann an [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] gesendet werden, um das Polygon des Ereignisbereichs abzurufen.

highlyLikelyAffectedPolygonId

string

Das Polygon des Gebiets, das mit hoher Wahrscheinlichkeit von einer Sturzflut betroffen ist. Die Polygon-ID kann an [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] gesendet werden, um das Polygon des Ereignisbereichs abzurufen.

eventPolygonId

string

Die Polygon-ID des Grenzbereichs des Ereignisses. Dies ist die Vereinigung der wahrscheinlichen und sehr wahrscheinlichen Polygone. Die Polygon-ID kann an [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] gesendet werden, um das Polygon des Grenzbereichs des Ereignisses abzurufen.