Method: floodStatus.searchLatestFloodStatusByArea

Поиск актуальной информации о наводнении по географическому району. Примечание: Возвращает информацию о наводнении, уровень которого находится в пределах заданной области, в отличие, например, от зоны, пересекающей заданную область. Это может измениться в будущем.

HTTP-запрос

POST https://floodforecasting.googleapis.com/v1/floodStatus:searchLatestFloodStatusByArea

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

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

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

JSON-представление 
{
  "cutoffTime": string,
  "pageToken": string,
  "pageSize": integer,

  // Union field area_type can be only one of the following:
  "regionCode": string,
  "loop": {
    object (Loop)
  }
  // End of list of possible types for union field area_type.
  "includeNonQualityVerified": boolean
}
Поля
cutoffTime

string

Необязательный параметр. Время окончания сбора информации о состоянии наводнения. Если указано, будут возвращены последние (последние опубликованные) данные о состоянии наводнения на момент окончания сбора. Если не указано, будут возвращены последние опубликованные данные о состоянии наводнения на текущий момент. Минимально допустимое время окончания сбора — 2025-08-01T00:00:00Z. Если время окончания сбора раньше этого, будет возвращена ошибка INVALID_ARGUMENT. Представлено в формате ISO 8601, например, "2025-10-17T10:34:00Z".

pageToken

string

Необязательный параметр. Токен страницы, полученный из предыдущего вызова floodStatus.searchLatestFloodStatusByArea . Укажите его, чтобы получить следующую страницу. При постраничной навигации все остальные параметры, предоставленные в floodStatus.searchLatestFloodStatusByArea должны соответствовать вызову, который предоставил токен страницы.

pageSize

integer

Необязательный параметр. Максимальное количество возвращаемых статусов затопления. Сервис может вернуть меньше этого значения. Если параметр не указан, будет возвращено не более 20 000 статусов затопления. Максимальное значение — 20 000; значения выше 20 000 будут преобразованы в 20 000.

Объединенное поле area_type .

area_type может принимать только одно из следующих значений:

regionCode

string

Регион, по которому следует запрашивать информацию о состоянии паводков. Используется CLDR, например, 'US'.

loop

object ( Loop )

Цикл для запроса информации о состоянии наводнений.

includeNonQualityVerified

boolean

Необязательно. Включите в результаты показатели, не прошедшие проверку качества. Используйте с осторожностью. Значение по умолчанию — false.

Ответный текст

Ответ функции floodStatus.searchLatestFloodStatusByArea.

В случае успеха тело ответа будет содержать данные следующей структуры:

JSON-представление 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
Поля
floodStatuses[]

object ( FloodStatus )

Актуальная информация о состоянии паводка в запрашиваемом районе. В настоящее время она определяется местоположением измерительных станций и может измениться в будущем.

nextPageToken

string

Необязательный параметр. Токен, который можно отправить в качестве pageToken для получения следующей страницы. Если это поле опущено, последующих страниц не будет.