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" ค่าเริ่มต้นคือ 1 สัปดาห์ที่ผ่านมา
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

จุดสิ้นสุดของช่วงเวลา