Method: gauges.queryGaugeForecasts

Kueri perkiraan pengukur.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
gaugeIds[]

string

Wajib. Daftar ID pengukur. Ukuran daftar yang didukung dibatasi hingga 500. Jika daftar yang diberikan lebih besar dari 500, permintaan akan gagal dengan error INVALID_REQUEST.
issuedTimeStart

string

Opsional. Waktu penerbitan perkiraan paling awal sebagai string (ISO 8601), misalnya "2023-06-17T10:34:00Z" atau string tanggal, misalnya "2023-10-13". Waktu mulai tidak boleh lebih awal dari "2023-10-01". Defaultnya adalah satu minggu yang lalu.
issuedTimeEnd

string

Opsional. Waktu penerbitan perkiraan terbaru sebagai string (ISO 8601), misalnya "2023-06-17T10:34:00Z" atau string tanggal, misalnya "2023-10-13". Default-nya adalah sekarang.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons gauges.queryGaugeForecasts.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "forecasts": {
    string: {
      object (ForecastSet)
    },
    ...
  }
}
Kolom
forecasts

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

Peta dari ID pengukur ke set perkiraan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ForecastSet

Kumpulan perkiraan untuk alat pengukur.

Representasi JSON 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
Kolom
forecasts[]

object (Forecast)

Perkiraan.

Perkiraan

Prakiraan satu pengukur untuk beberapa waktu tunggu. Misalnya, perkiraan cuaca dapat memiliki waktu penerbitan pukul 17.00, dan mencakup perkiraan cuaca untuk pukul 18.00, 19.00, 20.00, dll.

Catatan: Beberapa rentang perkiraan berpotensi lebih awal dari waktu penerbitan. Hal ini dapat terjadi karena, misalnya, keterlambatan dalam data input untuk model. Dengan contoh di atas, masalahnya mungkin terjadi pada pukul 17.00, dan rentang perkiraan adalah untuk pukul 16.00, 17.00, 18.00, dll.

Catatan: Rentang bervariasi dalam panjang, dan dalam jarak di antara keduanya. Beberapa contoh kemungkinan rentang adalah:

  1. [17.00 - 17.00], [18.00 - 18.00], [19.00 - 19.00]

  2. [1 Mar 00.00 - 2 Mar 00.00], [2 Mar 00.00 - 3 Mar 00.00], [3 Mar 00.00 - 4 Mar 00.00]

Representasi JSON 
{
  "forecastRanges": [
    {
      object (ForecastTimedValue)
    }
  ],
  "gaugeId": string,
  "issuedTime": string
}
Kolom
forecastRanges[]

object (ForecastTimedValue)

Perkiraan terdiri dari beberapa "rentang perkiraan", yang merupakan nilai perkiraan berbeda yang berkaitan dengan rentang waktu yang berbeda. Jika awal dan akhir rentang sama, berarti itu adalah waktu instan.
gaugeId

string

ID alat pengukur yang digunakan untuk perkiraan ini.
issuedTime

string

Waktu penerbitan perkiraan cuaca (ISO 8601), misalnya "2023-06-17T10:34:00Z". Waktu penerbitan adalah waktu saat perkiraan dibuat.

ForecastTimedValue

Nilai perkiraan yang berkaitan dengan rentang waktu. Unitnya ditentukan oleh GaugeModel yang terkait dengannya. Jika awal dan akhir sama, berarti ini adalah waktu instan.

Representasi JSON 
{
  "value": number,
  "forecastStartTime": string,
  "forecastEndTime": string
}
Kolom
value

number

Nilai perkiraan.
forecastStartTime

string

Awal interval.
forecastEndTime

string

Akhir interval.