Method: floodStatus.searchLatestFloodStatusByArea

ค้นหาสถานะน้ำท่วมล่าสุดตามพื้นที่ทางภูมิศาสตร์ หมายเหตุ: แสดงสถานะน้ำท่วมที่เกจอยู่ในพื้นที่ที่กำหนด ไม่ใช่พื้นที่ที่ได้รับผลกระทบซึ่งตัดกับพื้นที่ที่กำหนด อาจมีการเปลี่ยนแปลงในอนาคต

คำขอ HTTP

POST https://floodforecasting.googleapis.com/v1/floodStatus:searchLatestFloodStatusByArea

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "cutoffTime": string,
  "pageToken": string,
  "pageSize": integer,

  // Union field area_type can be only one of the following:
  "regionCode": string,
  "loop": {
    object (Loop)
  }
  // End of list of possible types for union field area_type.
  "includeNonQualityVerified": boolean
}
ฟิลด์
cutoffTime

string

ไม่บังคับ ไม่บังคับ เวลาปิดรับรายงานสถานะน้ำท่วม หากระบุไว้ ระบบจะแสดงสถานะอุทกภัยล่าสุด (เผยแพร่ล่าสุด) ณ เวลาสิ้นสุด หากไม่ได้ระบุ ระบบจะแสดงสถานะอุทกภัยที่เผยแพร่ล่าสุด ณ ตอนนี้ เวลาตัดรอบขั้นต่ำที่อนุญาตคือ 2025-08-01T00:00:00Z หากเวลาสิ้นสุดก่อนเวลานี้ ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT แสดงเป็น ISO 8601 เช่น "2025-10-17T10:34:00Z".
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ floodStatus.searchLatestFloodStatusByArea ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ floodStatus.searchLatestFloodStatusByArea ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ
pageSize

integer

ไม่บังคับ จำนวนสถานะการบล็อกสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ได้ระบุ ระบบจะแสดงผลสถานะน้ำท่วมอย่างมาก 20,000 รายการ ค่าสูงสุดคือ 20,000 ค่าที่สูงกว่า 20,000 จะถูกบังคับให้เป็น 20,000

ฟิลด์ Union area_type

area_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
regionCode

string

ภูมิภาคที่จะใช้ค้นหาสถานะน้ำท่วม การใช้ CLDR เช่น "สหรัฐอเมริกา"
loop

object (Loop)

ลูปที่ใช้ในการค้นหาสถานะอุทกภัย
includeNonQualityVerified

boolean

ไม่บังคับ รวมเกจในผลลัพธ์ที่ไม่ได้ผ่านการยืนยันคุณภาพ โปรดใช้ด้วยความระมัดระวัง ค่าเริ่มต้นคือ False

เนื้อหาการตอบกลับ

การตอบกลับของ floodStatus.searchLatestFloodStatusByArea

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
ช่อง
floodStatuses[]

object (FloodStatus)

สถานะน้ำท่วมล่าสุดในพื้นที่ที่ขอ ปัจจุบันระบบจะกำหนดโดยตำแหน่งของเกจ ซึ่งอาจมีการเปลี่ยนแปลงในอนาคต
nextPageToken

string

ไม่บังคับ โทเค็นที่ส่งเป็น pageToken เพื่อดึงข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป