Method: flashFloods.search

Поиск внезапных наводнений. Возвращает последние активные или прогнозируемые случаи внезапных наводнений. Подробнее см. https://support.google.com/flood-hub/answer/16811681 .

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Текст запроса

Тело запроса содержит данные следующей структуры:

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 для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

Внезапное наводнение

Событие, представляющее собой внезапное наводнение. Оно обозначает временной интервал, начинающийся с 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, например, "США".

likelyAffectedPolygonId

string

Полигон области, которая, вероятно, пострадает от внезапного наводнения. Идентификатор полигона можно отправить в [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon], чтобы получить полигон области, где произойдет событие.

highlyLikelyAffectedPolygonId

string

Полигон области, которая с высокой вероятностью может пострадать от внезапного наводнения. Идентификатор полигона можно отправить в [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon], чтобы получить полигон области, где произойдет событие.

eventPolygonId

string

Идентификатор полигона пограничной зоны события. Это объединение вероятных и высоковероятных полигонов. Идентификатор полигона можно отправить в [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon], чтобы получить полигон пограничной зоны события.