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

mapTypes एंडपॉइंट, रास्टर मैप टाइल उपलब्ध कराता है. ये टाइल, मौसम की अलग-अलग स्थितियों के बारे में बताती हैं. जैसे, बारिश का पूर्वानुमान. इन मैप टाइल को स्टैंडर्ड Google Maps पर ओवरले किया जा सकता है.

शर्तें

ये शर्तें, 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 का कैश मेमोरी में सेव किया गया कॉन्टेंट मिटाना होगा

मौसम के मैप के अनुरोधों के बारे में जानकारी

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

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

मैप टाइप

Weather API, मौसम के अलग-अलग तरह के मैप के साथ काम करता है. ये मैप, मौसम के अलग-अलग मॉडल और भौगोलिक क्षेत्रों के हिसाब से होते हैं:

  • US_PRECIPITATION_CURRENT: अमेरिका में बारिश की मौजूदा स्थिति का अनुमान लगाने वाली हाई-रिज़ॉल्यूशन इमेज.
  • EU_PRECIPITATION_CURRENT: यूरोप में बारिश की मौजूदा स्थिति के बारे में ज़्यादा रिज़ॉल्यूशन वाली जानकारी.

नीचे दिए गए कवरेज मैप में, उन देशों/इलाकों को दिखाया गया है जहां मौसम के मैप की टाइलें उपलब्ध हैं:

मैप पर मौसम की जानकारी दिखाने वाली टाइल का कवरेज

टाइल कोऑर्डिनेट सिस्टम

यह एपीआई, स्टैंडर्ड वेब मर्कटर टाइल कोऑर्डिनेट सिस्टम का इस्तेमाल करता है. मैप और टाइल कोऑर्डिनेट के बारे में पूरी जानकारी पाने के लिए, रोडमैप टाइल और मैप और टाइल कोऑर्डिनेट लेख पढ़ें.

इस सिस्टम में:

  • zoom: ज़ूम लेवल (0 से 16). ज़ूम लेवल 0, पूरी दुनिया को एक ही टाइल में दिखाता है (20 x 20 = 1 टाइल). ज़ूम लेवल z, दुनिया को 2z x 2z टाइलों की ग्रिड में बांटता है.
  • x: यह टाइल का X कोऑर्डिनेट (कॉलम) होता है. इसकी वैल्यू 0 (सबसे पश्चिमी) से लेकर 2ज़ूम - 1 (सबसे पूर्वी) तक होती है.
  • y: यह टाइल का Y कोऑर्डिनेट (लाइन) है. इसकी वैल्यू 0 (सबसे उत्तर में) से लेकर 2ज़ूम - 1 (सबसे दक्षिण में) तक होती है.

मौसम का मैप दिखाओ

Google Maps JavaScript API का इस्तेमाल करके, इन टाइलों को वेब ऐप्लिकेशन में दिखाने के लिए, कस्टम google.maps.ImageMapType बनाया जा सकता है:

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

मैप पर मौसम की जानकारी दिखाने का अनुरोध करने का उदाहरण

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

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

जवाब बाइनरी फ़ॉर्मैट में होता है. JSON रैपर सिर्फ़ कुछ खास सीरियलाइज़ेशन सेटिंग में दिखता है. जैसे, ?alt=json.