Method: gauges.queryGaugeForecasts

Прогнозы датчиков запросов.

HTTP-запрос

GET https://floodforecasting.googleapis.com/v1/gauges:queryGaugeForecasts

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

Параметры запроса

Параметры
gaugeIds[]

string

Обязательно. Список идентификаторов датчиков. Поддерживаемый размер списка ограничен 500. Если список больше 500, возникает ошибка INVALID_REQUEST.

issuedTimeStart

string

Необязательно. Самое раннее время выпуска прогноза в виде строки (ISO 8601), например, «2023-06-17T10:34:00Z», или строки даты, например, «2023-10-13». Время начала не может быть раньше «2023-10-01». Значение по умолчанию — неделя назад.

issuedTimeEnd

string

Необязательно. Время выпуска последнего прогноза в виде строки (ISO 8601), например, «2023-06-17T10:34:00Z», или строка даты, например, «2023-10-13». Значение по умолчанию — «сейчас».

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

Тело запроса должно быть пустым.

Тело ответа

Ответ gauges.queryGaugeForecasts.

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

JSON-представление 
{
  "forecasts": {
    string: {
      object (ForecastSet)
    },
    ...
  }
}
Поля
forecasts

map (key: string, value: object ( ForecastSet ))

Карта от идентификатора датчика до набора прогнозов.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

ForecastSet

Набор прогнозов для датчика.

JSON-представление 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
Поля
forecasts[]

object ( Forecast )

Прогнозы.

Прогноз

Прогноз одного датчика на несколько сроков. Например, прогноз может быть выпущен в 17:00 и включать прогнозы на 18:00, 19:00, 20:00 и т. д.

Примечание: Некоторые диапазоны прогноза могут быть более ранними, чем время выпуска. Это может произойти, например, из-за задержек во входных данных модели. В приведенном выше примере время выпуска может быть 17:00, а диапазоны прогноза — 16:00, 17:00, 18:00 и т. д.

Примечание: Хребты различаются по длине и расстоянию между ними. Вот несколько примеров возможных хребтов:

  1. [17:00–17:00], [18:00–18:00], [19:00–19:00]

  2. [1 марта 00:00 - 2 марта 00:00], [2 марта 00:00 - 3 марта 00:00], [3 марта 00:00 - 4 марта 00:00]

JSON-представление 
{
  "forecastRanges": [
    {
      object (ForecastTimedValue)
    }
  ],
  "gaugeId": string,
  "issuedTime": string
}
Поля
forecastRanges[]

object ( ForecastTimedValue )

Прогноз состоит из нескольких «диапазонов прогноза» — различных значений прогноза, относящихся к разным временным диапазонам. Когда начало и конец диапазона совпадают, это означает, что это один момент времени.

gaugeId

string

Идентификатор датчика, для которого предназначен этот прогноз.

issuedTime

string

Время выпуска прогноза (ISO 8601), например, «2023-06-17T10:34:00Z». Время выпуска — это время создания прогноза.

ForecastTimedValue

Прогнозируемое значение, относящееся к определённому временному диапазону. Единицы измерения определяются связанной с ним моделью GaugeModel. Если начальное и конечное значения совпадают, это означает, что это момент времени.

JSON-представление 
{
  "value": number,
  "forecastStartTime": string,
  "forecastEndTime": string
}
Поля
value

number

Ценность прогноза.

forecastStartTime

string

Начало интервала.

forecastEndTime

string

Конец интервала.