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

הערך הוא True אם למדד של סטטוס השיטפון הזה אין מודל, או אם יש לו מודל והמודל מאומת באיכות. יש להפעיל שיקול דעת כאשר ערך זה מוגדר כ-False.
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

מפת הצפות אחת.

ייצוג 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

 חיפוש של סטטוס השיטפון האחרון לפי אזור גיאוגרפי.