बारिश की संभावना के बारे में हर मिनट अपडेट पाने की सुविधा (एक्सपेरिमेंट के तौर पर उपलब्ध है)

यह प्रॉडक्ट या सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है (pre-GA). हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको पूरी सहायता न मिले. साथ ही, ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA ऑफ़र पर, Google Maps Platform की सेवा से जुड़ी खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

forecast:minutes एंडपॉइंट, किसी जगह के लिए हर मिनट के हिसाब से, हाई रिज़ॉल्यूशन में बारिश और बर्फ़बारी का पूर्वानुमान (इसे नाउकास्टिंग भी कहा जाता है) दिखाता है.

एपीआई, छह घंटे की समयावधि के लिए यह जानकारी दिखाता है:

• पूर्वानुमान की समयसीमा के शुरू और खत्म होने का समय
• अनुरोध की गई जगह का टाइम ज़ोन
• पूर्वानुमान के हर सेगमेंट के शुरू और खत्म होने का समय
• हर सेगमेंट के दौरान बारिश का अनुमानित टाइप, संभावना, मात्रा, और तीव्रता

ध्यान दें: ऐसा हो सकता है कि कुछ ही समय में होने वाली बारिश, ओले या बर्फ़बारी वगैरह का पूर्वानुमान लगाने की सुविधा, मौसम की जानकारी देने वाले मैप की टाइल के साथ सिंक न हो या उसके मुताबिक न हो.

शर्तें

ये शर्तें, Google Maps Platform की सेवा से जुड़ी खास शर्तों के सेक्शन 6 (Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं से जुड़ी शर्तें) के तहत जारी की गई हैं. Google और आपने इन शर्तों पर सहमति जताई है.

1.1 एट्रिब्यूशन से जुड़ी ज़रूरी शर्तें. अगर ग्राहक, Weather API से Google Maps Content का इस्तेमाल करता है, तो उसे Google को दस्तावेज़ के मुताबिक एट्रिब्यूशन देना होगा.

1.2 पाबंदियां. ग्राहक, Weather API से हासिल किए गए Google Maps Content का इस्तेमाल, Google की किसी सेवा या प्रॉडक्ट को फिर से बनाने के लिए नहीं कर सकते. उदाहरण के लिए, Weather API से हासिल किए गए डेटा का इस्तेमाल किसी ऐसे मौसम ऐप्लिकेशन या मौसम मॉडल में नहीं किया जा सकता जिसका मुख्य मकसद मौसम की जानकारी देना हो.

1.3 कैश मेमोरी में सेव होना. ग्राहक, Weather API से मिले Google Maps के कॉन्टेंट को कुछ समय के लिए कैश मेमोरी में सेव कर सकते हैं. ऐसा, कैश मेमोरी में सेव करने की अवधि के लिए किया जा सकता है. इसके बारे में टेबल 1.3.1 (कैश मेमोरी में सेव करने की अनुमतियां) में बताया गया है.

टेबल 1.3.1 (कैशिंग की अनुमतियां)

ये अनुमतियां, Google Maps Platform की सेवा से जुड़ी खास शर्तों की टेबल 17.2.1 में बताई गई अनुमतियों के अलावा हैं.

Google Maps का कॉन्टेंट	कैश मेमोरी में सेव करने की अवधि
हर मिनट के हिसाब से अनुमानित वैल्यू	एक घंटे के बाद, ग्राहक को Google Maps का कैश मेमोरी में सेव किया गया कॉन्टेंट मिटाना होगा

मिनट के हिसाब से अनुमान लगाने के अनुरोधों के बारे में जानकारी

हर मिनट के हिसाब से अनुमान का अनुरोध करने के लिए, इस यूआरएल पर एचटीटीपी GET अनुरोध भेजें:

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

अपने अनुरोध के पैरामीटर में, जगह के अक्षांश और देशांतर निर्देशांक शामिल करें.

अनुरोध के पैरामीटर

forecast.minutes एंडपॉइंट, अनुरोध के लिए इन पैरामीटर को स्वीकार करता है:

पैरामीटर	ब्यौरा	ज़रूरी है या ज़रूरी नहीं है
location.latitude	अनुरोध की गई जगह के अक्षांश निर्देशांक.	ज़रूरी है
location.longitude	अनुरोध की गई जगह के देशांतर निर्देशांक.	ज़रूरी है
unitsSystem	अनुरोध किया गया यूनिट सिस्टम. वैल्यू में ये शामिल हैं: UNITS_SYSTEM_UNSPECIFIED IMPERIAL METRIC अगर कोई यूनिट सिस्टम नहीं बताया गया है, तो जवाब में डिफ़ॉल्ट रूप से METRIC का इस्तेमाल किया जाता है.	वैकल्पिक
pageSize	इससे यह तय किया जाता है कि ज़्यादा से ज़्यादा कितने नतीजे दिखाए जाएं.	वैकल्पिक
pageToken	यह पिछले अनुरोध से मिला पेज टोकन है. डेटा का अगला पेज पाने के लिए, अगले अनुरोध में pageToken को इनपुट पैरामीटर के तौर पर पास करें.	वैकल्पिक

हर मिनट के हिसाब से मौसम के पूर्वानुमान के बारे में जानकारी

Weather API, रिस्पॉन्स बॉडी में ये फ़ील्ड दिखाता है:

फ़ील्ड	ब्यौरा
overallPredictionTimeframe	पूर्वानुमान के लिए कुल समयावधि.
overallPredictionTimeframe.startTime	अनुमान लगाने की समयसीमा शुरू होने का समय. इससे शुरुआती रेफ़रंस पॉइंट का पता चलता है.
overallPredictionTimeframe.endTime	अनुमान की समयसीमा के खत्म होने का समय. यह समय, शुरू होने के समय के छह घंटे बाद सेट होता है.
timeZone	अनुरोध की गई जगह का टाइम ज़ोन.
segments	मिनट के हिसाब से अनुमानित सेगमेंट, जिन्हें timeFrame से दिखाया जाता है.
segments.timeFrame	सेगमेंट से जुड़ा टाइमफ़्रेम.
segments.timeFrame.startTime	सेगमेंट के शुरू होने का समय.
segments.timeFrame.endTime	सेगमेंट खत्म होने का समय.
segments.type	उस सेगमेंट के दौरान बारिश या बर्फ़बारी का अनुमानित टाइप. वैल्यू में ये शामिल हैं: DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED NONE RAIN SNOW HAIL
segments.probability	उस सेगमेंट के दौरान बारिश होने की अनुमानित संभावना. वैल्यू, 0 से 100 के बीच प्रतिशत में होती हैं.
segments.qpf	बारिश की मात्रा का पूर्वानुमान.
segments.qpf.quantity	उस सेगमेंट के दौरान बारिश या बर्फ़बारी की अनुमानित मात्रा.
segments.qpf.unit	बारिश या बर्फ़बारी की कुल मात्रा को मापने के लिए इस्तेमाल की जाने वाली इकाई (उदाहरण के लिए, MILLIMETERS, INCHES).
segments.snowfallAmount	उस सेगमेंट के दौरान बर्फ़बारी की अनुमानित मात्रा.
segments.snowfallAmount.quantity	उस सेगमेंट के दौरान बर्फ़बारी की अनुमानित मात्रा (तरल पानी के बराबर).
segments.snowfallAmount.unit	यह बर्फ़ की मात्रा को मापने के लिए इस्तेमाल की जाने वाली इकाई है. उदाहरण के लिए, MILLIMETERS, INCHES.
segments.intensity	सेगमेंट में बारिश की इंटेंसिटी. वैल्यू में ये शामिल हैं: PRECIPITATION_INTENSITY_UNSPECIFIED NO_INTENSITY LIGHT MODERATE HEAVY
nextPageToken	यह एक ऐसा टोकन है जिसे pageToken के तौर पर भेजा जा सकता है, ताकि अगला पेज वापस पाया जा सके. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होता.

मिनट के हिसाब से मौसम के पूर्वानुमान का उदाहरण

यहां दिए गए उदाहरण में, वेस्ट वर्जीनिया में किसी जगह के लिए, हर मिनट के हिसाब से मौसम के अनुमान की जानकारी का अनुरोध किया गया है:

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

जवाब में, segments ऑब्जेक्ट से, अनुमान की पूरी समयावधि के हर सेगमेंट के बारे में पता चलता है:

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}