Method: flashFloods.search

ค้นหาน้ำท่วมฉับพลัน แสดงเหตุการณ์น้ำท่วมฉับพลันที่ใช้งานอยู่หรือที่คาดการณ์ไว้ล่าสุด ดูรายละเอียดเพิ่มเติมได้ที่ https://support.google.com/flood-hub/answer/16811681

คำขอ HTTP

POST https://floodforecasting.googleapis.com/v1/flashFloods:search

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

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

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

การแสดง JSON 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
ฟิลด์
countryCodes[]

string

ไม่บังคับ รหัสประเทศที่จะใช้ค้นหาน้ำท่วมฉับพลัน ในรูปแบบ ISO 3166 alpha-2 เช่น "US" หากไม่ได้ระบุ ระบบจะแสดงน้ำท่วมฉับพลันสำหรับทุกประเทศ
pageSize

integer

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

string

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

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

การตอบกลับของ [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods]

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

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

object (FlashFloodEvent)

เหตุการณ์น้ำท่วมฉับพลันที่พบตามเกณฑ์คำขอ
nextPageToken

string

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

FlashFloodEvent

เหตุการณ์น้ำท่วมฉับพลัน ซึ่งแสดงถึงกรอบเวลาที่เริ่มตั้งแต่ forecastIssueTime และยาวนาน forecastPeriodHours โดยเราคาดว่าน้ำท่วมฉับพลันจะเกิดขึ้นภายในกรอบเวลานี้

การแสดง JSON 
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
ช่อง
forecastIssueTime

string

เวลาที่ออกการพยากรณ์นี้ แสดงเป็น ISO 8601 เช่น "2025-10-17T10:34:00Z"
forecastPeriodHours

integer

ระยะเวลาที่การพยากรณ์มีผล (เป็นชั่วโมง)
affectedCountryCodes[]

string

ประเทศที่คาดว่าจะได้รับผลกระทบจากเหตุการณ์ในรูปแบบ ISO 3166 alpha-2 เช่น "US"
likelyAffectedPolygonId

string

รูปหลายเหลี่ยมของพื้นที่ที่อาจได้รับผลกระทบจากน้ำท่วมฉับพลัน คุณสามารถส่งรหัสรูปหลายเหลี่ยมไปยัง [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] เพื่อดึงรูปหลายเหลี่ยมของพื้นที่ที่เกิดเหตุการณ์
highlyLikelyAffectedPolygonId

string

รูปหลายเหลี่ยมของพื้นที่ที่มีแนวโน้มสูงที่จะได้รับผลกระทบจากน้ำท่วมฉับพลัน คุณสามารถส่งรหัสรูปหลายเหลี่ยมไปยัง [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] เพื่อดึงรูปหลายเหลี่ยมของพื้นที่ที่เกิดเหตุการณ์
eventPolygonId

string

รหัสรูปหลายเหลี่ยมของพื้นที่ขอบเขตของเหตุการณ์ นี่คือการรวมกันของรูปหลายเหลี่ยมที่มีแนวโน้มและมีแนวโน้มสูง คุณสามารถส่งรหัสรูปหลายเหลี่ยมไปยัง [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] เพื่อดึงรูปหลายเหลี่ยมของพื้นที่ชายแดนของเหตุการณ์ได้