Method: flashFloods.search

अचानक आई बाढ़ के बारे में खोजें. फ़िलहाल, चालू या अनुमानित फ़्लैश फ़्लड इवेंट की नई जानकारी दिखाता है. ज़्यादा जानकारी के लिए, https://support.google.com/flood-hub/answer/16811681 पर जाएं.

एचटीटीपी अनुरोध

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

यह यूआरएल, 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

आईएसओ 3166 ऐल्फ़ा-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] पर भेजा जा सकता है, ताकि इवेंट की सीमा वाले इलाके का पॉलीगॉन वापस पाया जा सके.