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

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

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

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

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

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

शर्तें

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

1.1 एट्रिब्यूशन से जुड़ी ज़रूरी शर्तें. अगर ग्राहक, Weather API से Google Maps का कॉन्टेंट इस्तेमाल करता है, तो उसे दस्तावेज़ के मुताबिक 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 का कॉन्टेंट मिटाना होगा

हर मिनट के हिसाब से बारिश या बर्फ़बारी की संभावना के अनुमान के अनुरोधों के बारे में जानकारी

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

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"
    },
    ...
  ]
}