REST Resource: floodStatus

แหล่งข้อมูล: FloodStatus

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

การแสดง JSON 
{
  "gaugeId": string,
  "qualityVerified": boolean,
  "gaugeLocation": {
    object (LatLng)
  },
  "issuedTime": string,
  "forecastTimeRange": {
    object (TimeRange)
  },
  "forecastChange": {
    object (ForecastChange)
  },
  "forecastTrend": enum (ForecastTrend),
  "mapInferenceType": enum (MapInferenceType),
  "severity": enum (Severity),
  "inundationMapSet": {
    object (InundationMapSet)
  },
  "source": string,
  "serializedNotificationPolygonId": string
}
ช่อง
gaugeId

string

รหัสของมาตรวัดที่สถานะนี้ออก
qualityVerified

boolean

เป็นจริงหากการวัดสถานะพื้นที่น้ำท่วมนี้ไม่ใช่โมเดล หรือมีโมเดลและโมเดลได้รับการยืนยันคุณภาพแล้ว โปรดใช้ความระมัดระวังเมื่อตั้งค่านี้เป็น "เท็จ"
gaugeLocation

object (LatLng)

ตำแหน่งของมาตรวัดที่แสดงสถานะนี้
issuedTime

string

เวลาที่มีการระบุสถานะนี้เป็นสตริง (ISO 8601) เช่น "2023-06-17T10:34:00Z".
forecastTimeRange

object (TimeRange)

ช่วงเวลาที่คาดการณ์การคาดการณ์
forecastChange

object (ForecastChange)

ค่าการคาดการณ์จะเปลี่ยนจากสถานะที่ทราบล่าสุดเป็นการคาดการณ์ ปัจจุบันใช้ได้กับรุ่นระดับน้ำเท่านั้น
forecastTrend

enum (ForecastTrend)

แนวโน้มของการคาดการณ์
mapInferenceType

enum (MapInferenceType)

ประเภทของการอนุมานที่แผนที่นี้สร้างขึ้น
severity

enum (Severity)

ความรุนแรงของสถานะ
inundationMapSet

object (InundationMapSet)

ชุดแผนที่อนุมานที่อนุมาน
source

string

องค์กรที่รับผิดชอบข้อมูลของมาตรวัดนี้ เช่น GRDC, CWC ฯลฯ
serializedNotificationPolygonId

string

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

TimeRange

ช่วงเวลา

การแสดง JSON 
{
  "start": string,
  "end": string
}
ช่อง
start

string

จุดเริ่มต้นของช่วงเวลา แสดงเป็น ISO 8601 เช่น "2023-06-17T10:34:00Z".
end

string

จุดสิ้นสุดของช่วงเวลา แสดงเป็น ISO 8601 เช่น "2023-06-17T10:34:00Z".

ForecastChange

ค่าที่คาดการณ์ไว้เปลี่ยนจากสถานะที่ทราบล่าสุดเป็นการคาดการณ์ ปัจจุบันใช้ได้กับรุ่นระดับน้ำเท่านั้น

การแสดง JSON 
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
ช่อง
valueChange

object (ValueChange)

การเปลี่ยนแปลงค่าที่คาดการณ์ไว้
referenceTimeRange

object (TimeRange)

ช่วงเวลาของสถานะที่ทราบล่าสุด ซึ่งเราคาดการณ์การเปลี่ยนแปลงของค่า เช่น เราอาจตั้งค่าช่วงเวลาอ้างอิงเป็นเมื่อวาน และมีการเปลี่ยนแปลงค่าเป็น 25-30 ซม. ซึ่งหมายความว่าระดับน้ำจะสูงขึ้น 25-30 ซม. เมื่อเทียบกับค่าเมื่อวาน ไม่ใช่จากค่าตอนนี้

ValueChange

การเปลี่ยนแปลงของค่าที่คาดการณ์ไว้ - ขอบเขตบนและล่าง

การแสดง JSON 
{
  "lowerBound": number,
  "upperBound": number
}
ช่อง
lowerBound

number

ขอบเขตล่างของการเปลี่ยนแปลงการคาดการณ์ หน่วยเป็นเมตร หากการเปลี่ยนแปลงอยู่ระหว่าง 20 ถึง 30 ค่านี้จะเป็น 20 หากการเปลี่ยนแปลงอยู่ระหว่าง -30 ถึง -20 ค่านี้จะเป็น -30
upperBound

number

ขอบเขตบนของการเปลี่ยนแปลงการคาดการณ์ หน่วยเป็นเมตร หากการเปลี่ยนแปลงอยู่ระหว่าง 20 ถึง 30 ค่านี้จะเป็น 30 หากการเปลี่ยนแปลงอยู่ระหว่าง -30 ถึง -20 ค่านี้จะเป็น -20

ForecastTrend

Enum ที่แสดงแนวโน้มของการคาดการณ์

Enum
FORECAST_TREND_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
RISE ซึ่งเป็นการบ่งชี้ว่าค่าที่คาดการณ์ไว้เพิ่มขึ้น
FALL ซึ่งเป็นการบ่งชี้ว่าค่าที่คาดการณ์ไว้ลดลง
NO_CHANGE ซึ่งเป็นการบ่งชี้ว่าไม่มีการเปลี่ยนแปลงค่าที่คาดการณ์

MapInferenceType

Enum ที่แสดงการอนุมานแผนที่ประเภทต่างๆ

Enum
MAP_INFERENCE_TYPE_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
MODEL ค่านี้ระบุว่าการอนุมานนี้สร้างขึ้นโดยใช้โมเดล
IMAGE_CLASSIFICATION ค่านี้ระบุว่าการอนุมานนี้สร้างขึ้นโดยใช้การจัดประเภทรูปภาพ

ความรุนแรง

Enum ที่แทนความร้ายแรงของสถานะ

Enum
SEVERITY_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
EXTREME ซึ่งเป็นการบ่งชี้สถานะสุดโต่งที่คาดการณ์ไว้
SEVERE ซึ่งระบุสถานะความรุนแรงที่คาดการณ์ไว้
ABOVE_NORMAL ซึ่งเป็นตัวบ่งชี้สถานะที่คาดการณ์ว่าจะมีการคาดการณ์ไว้สูงกว่าปกติ
NO_FLOODING ข้อมูลนี้บ่งชี้ว่าไม่มีน้ำท่วม
UNKNOWN ซึ่งแสดงให้เห็นว่าเรามีข้อมูลไม่เพียงพอที่จะระบุความรุนแรง

InundationMapSet

ชุดแผนที่น้ำท่วม

การแสดง JSON 
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
ช่อง
inundationMaps[]

object (InundationMap)

แผนที่น้ำท่วม สำหรับแต่ละระดับน้ำท่วม
inundationMapsTimeRange

object (TimeRange)

ช่วงเวลาของรัฐที่แผนที่น้ำท่วมหมายถึง
inundationMapType

enum (InundationMapType)

ประเภทของแผนที่น้ำท่วม

InundationMap

แผนที่น้ำท่วม 1 รายการ

การแสดง JSON 
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
ช่อง
level

enum (InundationLevel)

ระดับของแผนที่น้ำท่วม - ดูเอกสารประกอบตาม InundationMapType
serializedPolygonId

string

รหัสของรูปหลายเหลี่ยมแบบอนุกรมซึ่งแสดงแผนที่ความเสี่ยงจากน้ำท่วมนี้ ใช้ serializedPolygons.get เพื่อหารูปหลายเหลี่ยมที่เรียงต่อกัน

InundationLevel

Enum ที่แทนระดับความท่วม

Enum
INUNDATION_LEVEL_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
HIGH ดูเอกสารประกอบเกี่ยวกับ InundationMapType
MEDIUM ดูเอกสารประกอบเกี่ยวกับ InundationMapType
LOW ดูเอกสารประกอบเกี่ยวกับ InundationMapType

InundationMapType

Enum ที่แทนประเภทของแผนที่น้ำท่วม

Enum
INUNDATION_MAP_TYPE_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
PROBABILITY แผนที่แสดงความน่าจะเป็นประเภท InundationLevel แสดงความน่าจะเป็นบนแผนที่ - มีโอกาสเกิดน้ำท่วมสูง/ปานกลาง/ต่ำ รูปหลายเหลี่ยมความน่าจะเป็นสูงจะอยู่ในรูปหลายเหลี่ยมความน่าจะเป็นปานกลาง ส่วนรูปหลายเหลี่ยมของความน่าจะเป็นปานกลางก็อยู่ในรูปหลายเหลี่ยมความน่าจะเป็นต่ำ
DEPTH แผนที่ประเภทความลึก InundationLevel แสดงถึงความลึกของแผนที่ - ความลึกสูง/ปานกลาง/ต่ำต่อตำแหน่ง รูปหลายเหลี่ยมที่มีความลึกสูงอยู่ภายในรูปหลายเหลี่ยมที่มีความลึกปานกลาง ส่วนรูปหลายเหลี่ยมที่มีความลึกปานกลางจะอยู่ในรูปหลายเหลี่ยมที่มีความลึกต่ำ

เมธอด

queryLatestFloodStatusByGaugeIds

 ค้นหาสถานะน้ำท่วมล่าสุดตามรหัสของมาตรวัด

searchLatestFloodStatusByArea

 ค้นหาสถานะน้ำท่วมล่าสุดตามพื้นที่ทางภูมิศาสตร์