Method: gauges.queryGaugeForecasts

क्वेरी के आधार पर अनुमान लगाने की सुविधा.

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

GET https://floodforecasting.googleapis.com/v1/gauges:queryGaugeForecasts

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

क्वेरी पैरामीटर

पैरामीटर
gaugeIds[]

string

ज़रूरी है. गेज आईडी की सूची. इस्तेमाल की जा सकने वाली सूची में ज़्यादा से ज़्यादा 500 आइटम हो सकते हैं. अगर 500 से ज़्यादा आइटम वाली सूची दी जाती है, तो INVALID_REQUEST गड़बड़ी की वजह से अनुरोध पूरा नहीं हो पाता.
issuedTimeStart

string

ज़रूरी नहीं. पूर्वानुमान जारी किए जाने का सबसे पहला समय, स्ट्रिंग (आईएसओ 8601) के तौर पर. उदाहरण के लिए, "2023-06-17T10:34:00Z" या तारीख की स्ट्रिंग, जैसे कि "2023-10-13". शुरू होने का समय "2023-10-01" से पहले का नहीं हो सकता. डिफ़ॉल्ट रूप से, यह एक हफ़्ते पहले की तारीख पर सेट होता है.
issuedTimeEnd

string

ज़रूरी नहीं. पूर्वानुमान जारी किए जाने का सबसे हालिया समय, स्ट्रिंग (ISO 8601) के तौर पर. उदाहरण के लिए, "2023-06-17T10:34:00Z" या तारीख की स्ट्रिंग, जैसे कि "2023-10-13". डिफ़ॉल्ट वैल्यू now है.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

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

gauges.queryGaugeForecasts का जवाब.

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

JSON के काेड में दिखाना 
{
  "forecasts": {
    string: {
      object (ForecastSet)
    },
    ...
  }
}
फ़ील्ड
forecasts

map (key: string, value: object (ForecastSet))

यह गेज आईडी से लेकर अनुमान के सेट तक का मैप होता है.

यह एक ऐसा ऑब्जेक्ट है जिसमें "key": value जोड़े की सूची होती है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ForecastSet

किसी गेज के लिए अनुमानों का सेट.

JSON के काेड में दिखाना 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
फ़ील्ड
forecasts[]

object (Forecast)

पूर्वानुमान.

पूर्वानुमान

एक ही गेज के लिए, कई लीड टाइम का पूर्वानुमान. उदाहरण के लिए, किसी अनुमान में समस्या होने का समय शाम 5 बजे हो सकता है. इसमें शाम 6 बजे, 7 बजे, 8 बजे वगैरह के अनुमान शामिल हो सकते हैं.

ध्यान दें: पूर्वानुमान की कुछ रेंज, जारी किए गए समय से पहले की हो सकती हैं. ऐसा मॉडल के लिए इनपुट डेटा में देरी होने की वजह से हो सकता है. ऊपर दिए गए उदाहरण के हिसाब से, ऐसा हो सकता है कि समस्या का समय शाम 5 बजे हो और अनुमानित समय शाम 4 बजे, शाम 5 बजे, शाम 6 बजे वगैरह हो.

ध्यान दें: रेंज की लंबाई और उनके बीच की दूरी अलग-अलग होती है. संभावित रेंज के कुछ उदाहरण यहां दिए गए हैं:

  1. [शाम 5 बजे से शाम 5 बजे तक], [शाम 6 बजे से शाम 6 बजे तक], [शाम 7 बजे से शाम 7 बजे तक]

  2. [1 मार्च, रात 12 बजे से 2 मार्च, रात 12 बजे तक], [2 मार्च, रात 12 बजे से 3 मार्च, रात 12 बजे तक], [3 मार्च, रात 12 बजे से 4 मार्च, रात 12 बजे तक]

JSON के काेड में दिखाना 
{
  "forecastRanges": [
    {
      object (ForecastTimedValue)
    }
  ],
  "gaugeId": string,
  "issuedTime": string
}
फ़ील्ड
forecastRanges[]

object (ForecastTimedValue)

पूर्वानुमान में कई "पूर्वानुमान रेंज" होती हैं. ये अलग-अलग समयसीमाओं से जुड़ी अलग-अलग पूर्वानुमान वैल्यू होती हैं. जब किसी रेंज की शुरुआत और खत्म होने का समय एक जैसा होता है, तो इसका मतलब है कि यह एक इंस्टैंट है.
gaugeId

string

यह अनुमान जिस गेज के लिए है उसका आईडी.
issuedTime

string

पूर्वानुमान जारी करने का समय (ISO 8601), जैसे कि "2023-06-17T10:34:00Z". पूर्वानुमान जारी करने का समय, वह समय होता है जब पूर्वानुमान जनरेट किया गया था.

ForecastTimedValue

समयसीमा के हिसाब से अनुमानित वैल्यू. इसकी इकाइयां, इससे जुड़े GaugeModel से तय होती हैं. अगर शुरू और खत्म होने का समय एक जैसा है, तो इसका मतलब है कि यह एक इंस्टैंट है.

JSON के काेड में दिखाना 
{
  "value": number,
  "forecastStartTime": string,
  "forecastEndTime": string
}
फ़ील्ड
value

number

अनुमानित वैल्यू.
forecastStartTime

string

इंटरवल की शुरुआत.
forecastEndTime

string

इंटरवल खत्म होने का समय.