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

تعداد يمثّل اتجاه التوقّعات.

عمليات التعداد
FORECAST_TREND_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
RISE ويشير ذلك إلى ارتفاع في القيمة المتوقّعة.
FALL ويشير ذلك إلى انخفاض في القيمة المتوقَّعة.
NO_CHANGE ويشير ذلك إلى عدم حدوث تغيير في القيمة المتوقّعة.

MapInferenceType

تعداد يمثل أنواعًا من استنتاجات الخريطة.

عمليات التعداد
MAP_INFERENCE_TYPE_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
MODEL وهذا يشير إلى أن هذا الاستنتاج تم إنشاؤه باستخدام نموذج.
IMAGE_CLASSIFICATION ويشير ذلك إلى أنّ هذا الاستنتاج تم إنشاؤه باستخدام تصنيف الصور.

درجة الخطورة

تعداد يمثّل درجة خطورة الحالة

عمليات التعداد
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

تعداد يمثل مستويات الفيضان.

عمليات التعداد
INUNDATION_LEVEL_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
HIGH اطّلِع على المستندات استنادًا إلى InundationMapType.
MEDIUM اطّلِع على المستندات استنادًا إلى InundationMapType.
LOW اطّلِع على المستندات استنادًا إلى InundationMapType.

InundationMapType

تعداد يمثل نوع خريطة الفيضان.

عمليات التعداد
INUNDATION_MAP_TYPE_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
PROBABILITY خريطة لنوع الاحتمالية. يمثل InundationLevel احتمالية على الخريطة - احتمالية عالية/متوسطة/منخفضة لحدوث فيضان. يتم تضمين مضلّع الاحتمال المرتفع داخل مضلّع الاحتمال المتوسط ، كما يتم تضمين مضلّع الاحتمال المتوسط في مضلّع الاحتمال المنخفض.
DEPTH خريطة نوع العمق. يمثل InundationLevel عمق الخريطة - عمق مرتفع/متوسط/منخفض لكل موقع جغرافي. يتم تضمين المضلع عالي العمق داخل مضلّع متوسط العمق، ويتم تضمين المضلع في العمق المتوسط داخل المضلّع منخفض العمق.

الطُرق

queryLatestFloodStatusByGaugeIds

 البحث عن أحدث حالة الفيضان حسب أرقام تعريف المقياس

searchLatestFloodStatusByArea

 البحث عن آخر حالة الفيضان حسب المنطقة الجغرافية