Method: gauges.queryGaugeForecasts

Thông tin dự đoán về chỉ số truy vấn.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
gaugeIds[]

string

Bắt buộc. Danh sách mã nhận dạng đồng hồ đo. Danh sách được hỗ trợ có tối đa 500 mục. Nếu bạn cung cấp một danh sách có hơn 500 mục, thì yêu cầu sẽ không thành công và trả về lỗi INVALID_REQUEST.
issuedTimeStart

string

Không bắt buộc. Thời gian phát hành dự báo sớm nhất dưới dạng chuỗi (ISO 8601), ví dụ: "2023-06-17T10:34:00Z" hoặc chuỗi ngày, ví dụ: "2023-10-13". Thời gian bắt đầu không được sớm hơn "2023-10-01". Giá trị mặc định là một tuần trước.
issuedTimeEnd

string

Không bắt buộc. Thời gian phát hành dự báo mới nhất dưới dạng chuỗi (ISO 8601), ví dụ: "2023-06-17T10:34:00Z" hoặc chuỗi ngày, ví dụ: "2023-10-13". Giá trị mặc định là now.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi của gauges.queryGaugeForecasts.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "forecasts": {
    string: {
      object (ForecastSet)
    },
    ...
  }
}
Trường
forecasts

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

Bản đồ từ mã nhận dạng đồng hồ đo đến tập hợp dự báo.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ForecastSet

Một tập hợp các dự báo cho một chỉ số.

Biểu diễn dưới dạng JSON 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
Trường
forecasts[]

object (Forecast)

Thông tin dự báo.

Dự báo

Thông tin dự báo của một đồng hồ đo cho nhiều khoảng thời gian dự báo. Ví dụ: một bản dự báo có thể có thời gian phát hành là 5 giờ chiều và bao gồm dự báo cho 6 giờ chiều, 7 giờ chiều, 8 giờ chiều, v.v.

Lưu ý: Một số phạm vi dự báo có thể sớm hơn thời gian phát hành. Điều này có thể xảy ra do ví dụ: dữ liệu đầu vào cho mô hình bị trễ. Với ví dụ trên, có thể thời gian xảy ra vấn đề là 5 giờ chiều và phạm vi dự đoán là 4 giờ chiều, 5 giờ chiều, 6 giờ chiều, v.v.

Lưu ý: Các dải có độ dài và khoảng cách khác nhau. Sau đây là một số ví dụ về các phạm vi có thể có:

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

  2. [00:00 ngày 1 tháng 3 – 00:00 ngày 2 tháng 3], [00:00 ngày 2 tháng 3 – 00:00 ngày 3 tháng 3], [00:00 ngày 3 tháng 3 – 00:00 ngày 4 tháng 3]

Biểu diễn dưới dạng JSON 
{
  "forecastRanges": [
    {
      object (ForecastTimedValue)
    }
  ],
  "gaugeId": string,
  "issuedTime": string
}
Trường
forecastRanges[]

object (ForecastTimedValue)

Thông tin dự báo bao gồm một số "phạm vi dự báo", là các giá trị dự báo khác nhau liên quan đến các phạm vi thời gian khác nhau. Khi điểm bắt đầu và điểm kết thúc của một phạm vi bằng nhau, tức là đó là một thời điểm.
gaugeId

string

Mã nhận dạng của đồng hồ đo mà dự báo này dành cho.
issuedTime

string

Thời gian phát hành dự báo (ISO 8601), ví dụ: "2023-06-17T10:34:00Z". Thời gian phát hành là thời gian tạo thông tin dự báo.

ForecastTimedValue

Giá trị dự đoán liên quan đến một khoảng thời gian. Các đơn vị của chỉ số này được xác định bằng GaugeModel mà chỉ số đó được liên kết. Nếu thời gian bắt đầu và kết thúc bằng nhau, tức là đó là một thời điểm.

Biểu diễn dưới dạng JSON 
{
  "value": number,
  "forecastStartTime": string,
  "forecastEndTime": string
}
Trường
value

number

Giá trị của thông tin dự đoán.
forecastStartTime

string

Điểm bắt đầu của khoảng thời gian.
forecastEndTime

string

Kết thúc khoảng thời gian.