हीटमैप

heatmapTiles एंडपॉइंट, टाइल ओवरले की मदद से एयर क्वालिटी से जुड़े हीटमैप दिखाता है. टाइल ओवरले, PNG इमेज टाइल का कलेक्शन होता है. इन्हें Google Maps के सबसे ऊपर दिखाया जा सकता है. हर इमेज टाइल (256 x 256 पिक्सल) की होती है.

हीटमैप टाइल के बारे में जानकारी

टाइल ओवरले एक ग्रिड है जिसे कई टाइलों के कलेक्शन से मिलाकर बनाया गया है. इसमें, हर टाइल को असाइन किया गया (X,Y) कोऑर्डिनेट किया जाता है. निर्देशांक (0,0) वाली टाइल, मैप के उत्तर-पश्चिम कोने में होती है. X की वैल्यू पश्चिम से पूर्व की ओर बढ़ती है. वहीं, Y की वैल्यू उत्तर से दक्षिण की ओर बढ़ती है.

zoom level से तय होता है कि मैप व्यू में, मैप का कॉन्टेंट कितना बड़ा या छोटा दिखेगा. टाइल ग्रिड का साइज़, X और Y निर्देशांक को ज़ूम लेवल पर तेज़ी से स्केल करके तय किया जाता है.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

उदाहरण के लिए, 2 के ज़ूम लेवल पर, दुनिया के मैप को 4 x 4 मैट्रिक्स का इस्तेमाल करके दिखाया गया है. इसमें कुल 16 टाइल हैं. ज़ूम यह भी तय करता है कि निर्देशांकों के लिए अधिकतम कितना मान है.

नीचे दी गई इमेज में, हर टाइल के निर्देशांक के साथ US_AQI हीटमैप दिखाया गया है. इसका ज़ूम लेवल दो है:

चार x 4 ग्रिड में पूरी दुनिया का हीटमैप.

अतिरिक्त विवरण के लिए मैप और टाइल कोऑर्डिनेट देखें.

हीटमैप एंडपॉइंट के बारे में जानकारी

हीटमैप टाइल को बाइट कलेक्शन के ज़रिए दिखाया जाता है, जिसमें PNG इमेज के तौर पर टाइल डेटा होता है. आपने heatmapTiles एंडपॉइंट का इस्तेमाल करके, मौजूदा एयर क्वालिटी की हीटमैप टाइल का अनुरोध किया है. इसके लिए, आपको एचटीटीपी जीईटी अनुरोध भेजना होगा:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

किसी अनुरोध में सभी अनुरोध पैरामीटर होने ज़रूरी हैं:

  • TYPE - वापस जाने के लिए हीटमैप का टाइप. मान्य वैल्यू देखें.

  • Z - ज़ूम लेवल से तय होता है कि मैप व्यू में, मैप का कॉन्टेंट कितना बड़ा या छोटा दिखेगा. वैल्यू, 0 से 16 तक की हो सकती हैं, जहां 0 की वैल्यू पूरी दुनिया को एक टाइल में दिखाती है.

  • X,Y - उत्तर-पश्चिम कोने (0, 0) के संबंध में,फिर से हासिल किए जाने वाले टाइल के निर्देशांक. X की वैल्यू पश्चिम से पूर्व की ओर बढ़ रही है. साथ ही, Y वैल्यू उत्तर से दक्षिण तक बढ़ रही है.

    टाइल निर्देशांक, दिए गए ज़ूम लेवल के लिए मान्य होने चाहिए. उदाहरण के लिए, अगर ज़ूम लेवल 2 पर सेट किया जाता है और 10,10 के निर्देशांक पर टाइल के लिए अनुरोध किया जाता है, तो एपीआई गड़बड़ी दिखाता है.

  • YOUR_API_KEY - आपके ऐप्लिकेशन की API कुंजी. यह कुंजी कोटा मैनेजमेंट के लिए आपके ऐप्लिकेशन की पहचान करती है. ज़्यादा जानकारी के लिए, कुंजी पाएं देखें.

हीटमैप के अनुरोध का उदाहरण

ऊपर दी गई इमेज में US_AQI हीटमैप दिखाया गया है. ज़ूम लेवल 2 के साथ दिखाया गया है. साथ ही, हर टाइल के निर्देशांक भी दिखाए गए हैं. इस उदाहरण में, हीटमैप से निर्देशांक 0,1 पर टाइल का अनुरोध करने के लिए, heatmapTiles एंडपॉइंट का इस्तेमाल किया गया है:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

टाइल इस तरह दिखती है:

निर्देशांक 0,1 पर एक हीटमैप टाइल.

डिफ़ॉल्ट मैप के ऊपर टाइल को ओवरले करने के बारे में ज़्यादा जानकारी के लिए, ओवरले मैप टाइप देखें.