Method: floodStatus.searchLatestFloodStatusByArea

البحث عن آخر حالة للفيضانات حسب المنطقة الجغرافية ملاحظة: تعرض هذه السمة حالات الفيضان التي يقع مقياسها ضمن المنطقة المحدّدة، بدلاً من المنطقة المتأثرة التي تتقاطع مع المنطقة المحدّدة مثلاً. ويخضع هذا العرض إلى التغيير لاحقًا.

طلب HTTP

POST https://floodforecasting.googleapis.com/v1/floodStatus:searchLatestFloodStatusByArea

يستخدِم عنوان URL بنية تحويل الترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "pageToken": string,
  "pageSize": integer,

  // Union field area_type can be only one of the following:
  "regionCode": string,
  "loop": {
    object (Loop)
  }
  // End of list of possible types for union field area_type.
  "includeNonQualityVerified": boolean
}
الحقول
pageToken

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب floodStatus.searchLatestFloodStatusByArea سابق. قدِّم هذه السلسلة لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى floodStatus.searchLatestFloodStatusByArea مع الطلب الذي قدّم رمز الصفحة المميز.
pageSize

integer

اختياريّ. الحدّ الأقصى لعدد حالات الفيضانات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 20,000 حالة فيضان على الأكثر. الحد الأقصى للقيمة هو 20,000، وسيتم فرض القيمة 20,000 على القيم التي تزيد عن 20,000.

حقل الدمج area_type

يمكن أن تكون area_type إحدى القيم التالية فقط:
regionCode

string

المنطقة التي سيتم الاستعلام عن حالات الفيضان فيها باستخدام CLDR، على سبيل المثال: ‫'US'.
loop

object (Loop)

الحلقة التي سيتم من خلالها طلب حالات الفيضانات.
includeNonQualityVerified

boolean

اختياريّ. تضمين مقاييس النتائج التي لم يتم التحقّق من جودتها يُرجى استخدامه بحذر. القيمة التلقائية هي "خطأ".

نص الاستجابة

استجابة floodStatus.searchLatestFloodStatusByArea

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
الحقول
floodStatuses[]

object (FloodStatus)

أحدث حالات الفيضان في المنطقة المطلوبة يتم تحديد ذلك حاليًا حسب موقع المؤشرات، ولكن قد يتغيّر ذلك في المستقبل.
nextPageToken

string

اختياريّ. رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.