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

यह प्रॉडक्ट या सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है (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 के कॉन्टेंट का इस्तेमाल, 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"
    },
    ...
  ]
}