Method: gauges.queryGaugeForecasts

Sorgu göstergesi tahminleri.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
gaugeIds[]

string

Zorunlu. Ölçüm cihazı kimliklerinin listesi. Desteklenen liste boyutu 500 ile sınırlıdır. 500'den büyük bir liste sağlanırsa INVALID_REQUEST hatasıyla başarısız olur.
issuedTimeStart

string

İsteğe bağlı. Dize olarak verilen en erken tahmin yayınlanma zamanı (ISO 8601), ör. "2023-06-17T10:34:00Z" veya tarih dizesi, ör. "2023-10-13". Başlangıç zamanı "2023-10-01" tarihinden önce olamaz. Varsayılan değer bir hafta öncesidir.
issuedTimeEnd

string

İsteğe bağlı. Dize olarak verilen en son tahmin yayınlanma zamanı (ISO 8601), ör. "2023-06-17T10:34:00Z" veya tarih dizesi, ör. "2023-10-13". Varsayılan değer "şimdi"dir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

gauges.queryGaugeForecasts'in yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "forecasts": {
    string: {
      object (ForecastSet)
    },
    ...
  }
}
Alanlar
forecasts

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

Ölçüm cihazı kimliğinden tahmin kümesine giden bir harita.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ForecastSet

Bir ölçüm için tahmin grubu.

JSON gösterimi 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
Alanlar
forecasts[]

object (Forecast)

Tahminler

Tahmin

Tek bir göstergenin birkaç teslim süresi için tahmini. Örneğin, bir tahminde yayınlanma saati 17:00 olabilir ve 18:00, 19:00, 20:00 vb. saatlere ait tahminler yer alabilir.

Not: Tahmin aralıklarından bazıları, yayınlanma zamanından daha erken olabilir. Bu durum, örneğin modelin giriş verilerindeki gecikmelerden kaynaklanabilir. Yukarıdaki örnekte, yayınlanma saati 17:00 olabilir ve tahmin aralıkları 16:00, 17:00, 18:00 vb. için olabilir.

Not: Aralıklar uzunluk ve aralarındaki mesafe bakımından farklılık gösterir. Olası aralıklara ilişkin bazı örnekler:

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

  2. [1 Mart 12:00 - 2 Mart 12:00], [2 Mart 12:00 - 3 Mart 12:00], [3 Mart 12:00 - 4 Mart 12:00]

JSON gösterimi 
{
  "forecastRanges": [
    {
      object (ForecastTimedValue)
    }
  ],
  "gaugeId": string,
  "issuedTime": string
}
Alanlar
forecastRanges[]

object (ForecastTimedValue)

Tahmin, farklı zaman aralıklarına ait farklı tahmin değerleri olan çeşitli "tahmin aralıklarından" oluşur. Bir aralığın başlangıcı ve bitişi eşit olduğunda bu, anlık bir zaman olduğu anlamına gelir.
gaugeId

string

Bu tahminin yapıldığı göstergenin kimliği.
issuedTime

string

Hava durumu tahmininin yayınlanma zamanı (ISO 8601), ör. "2023-06-17T10:34:00Z". Verilme zamanı, tahminin oluşturulduğu zamandır.

ForecastTimedValue

Bir zaman aralığıyla ilgili tahmin değeri. Birimleri, ilişkilendirildiği GaugeModel ile tanımlanır. Başlangıç ve bitiş eşitse bu, anlık bir zaman olduğu anlamına gelir.

JSON gösterimi 
{
  "value": number,
  "forecastStartTime": string,
  "forecastEndTime": string
}
Alanlar
value

number

Tahminin değeri.
forecastStartTime

string

Aralığın başlangıcı.
forecastEndTime

string

Aralığın sonu.