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] لاسترداد مضلّع منطقة الحدود الخاصة بالحدث.