Method: floodStatus.searchLatestFloodStatusByArea

भौगोलिक क्षेत्र के हिसाब से, बाढ़ की मौजूदा स्थिति के बारे में खोजें. ध्यान दें: यह उन जगहों पर बाढ़ की स्थिति दिखाता है जहां गेज, दिए गए इलाके में है. जैसे, दिए गए इलाके में बाढ़ से प्रभावित जगह. आने वाले समय में, इसमें बदलाव हो सकता है.

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

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "cutoffTime": string,
  "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
}
फ़ील्ड
cutoffTime

string

ज़रूरी नहीं. ज़रूरी नहीं. बाढ़ की स्थिति के लिए कटऑफ़ समय. यह जानकारी देने पर, कट-ऑफ़ टाइम तक की बाढ़ की मौजूदा (आखिरी बार पब्लिश की गई) स्थितियां दिखाई जाएंगी. यह जानकारी न देने पर, फ़िलहाल पब्लिश किए गए बाढ़ के स्टेटस दिखाए जाएंगे. कटऑफ़ का समय कम से कम 2025-08-01T00:00:00Z होना चाहिए. अगर कटऑफ़ का समय इससे पहले का है, तो INVALID_ARGUMENT गड़बड़ी दिखेगी. इसे ISO 8601 के तौर पर दिखाया जाता है. उदाहरण के लिए, "2025-10-17T10:34:00Z".

pageToken

string

ज़रूरी नहीं. यह एक पेज टोकन है, जो पिछले floodStatus.searchLatestFloodStatusByArea कॉल से मिला था. अगला पेज पाने के लिए, यह जानकारी दें. पेज नंबर के हिसाब से डेटा दिखाने के दौरान, floodStatus.searchLatestFloodStatusByArea को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए.

pageSize

integer

ज़रूरी नहीं. फ़्लड की ज़्यादा से ज़्यादा कितनी स्थितियां दिखानी हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 20,000 फ़्लड स्टेटस दिखाए जाएंगे. इसकी ज़्यादा से ज़्यादा वैल्यू 20,000 हो सकती है. इससे ज़्यादा वैल्यू को 20,000 पर सेट कर दिया जाएगा.

यूनियन फ़ील्ड area_type.

area_type इनमें से सिर्फ़ एक हो सकता है:

regionCode

string

वह इलाका जिसके लिए बाढ़ की स्थिति के बारे में क्वेरी करनी है. सीएलडीआर का इस्तेमाल करके, जैसे कि 'US'.

loop

object (Loop)

वह लूप जिससे बाढ़ की स्थिति के बारे में क्वेरी की जाती है.

includeNonQualityVerified

boolean

ज़रूरी नहीं. उन गेज को नतीजे में शामिल करें जिनकी क्वालिटी की पुष्टि नहीं हुई है. कृपया इसका इस्तेमाल सावधानी से करें. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होती है.

जवाब का मुख्य भाग

floodStatus.searchLatestFloodStatusByArea का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
floodStatuses[]

object (FloodStatus)

अनुरोध किए गए इलाके में बाढ़ की मौजूदा स्थिति. फ़िलहाल, यह गेज की जगह के हिसाब से तय होता है. हालांकि, आने वाले समय में इसमें बदलाव हो सकता है.

nextPageToken

string

ज़रूरी नहीं. यह एक ऐसा टोकन है जिसे pageToken के तौर पर भेजा जा सकता है, ताकि अगला पेज वापस पाया जा सके. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होता.