Method: flashFloods.search

جستجوی سیل‌های ناگهانی. آخرین رویدادهای سیل ناگهانی فعال یا پیش‌بینی‌شده را برمی‌گرداند. برای جزئیات بیشتر به https://support.google.com/flood-hub/answer/16811681 مراجعه کنید.

درخواست HTTP

POST https://floodforecasting.googleapis.com/v1/flashFloods:search

این URL از سینتکس Transcoding در 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 برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

رویداد سیل ناگهانی

یک رویداد سیل ناگهانی. این رویداد نشان‌دهنده یک بازه زمانی است که از 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] ارسال کرد تا چندضلعی ناحیه مرزی رویداد بازیابی شود.