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

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

शर्तें

ये शर्तें, Google Maps Platform की सेवा से जुड़ी खास शर्तों के सेक्शन 6 (Pre-GA ऑफ़र की शर्तें) के तहत जारी की गई हैं. 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/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.