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

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

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

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

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.