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 हीटमैप को दो ज़ूम लेवल
के साथ दिखाया गया है:
ज़्यादा जानकारी के लिए, मैप और टाइल के निर्देशांक देखें.
हीटमैप एंडपॉइंट के बारे में जानकारी
हीटमैप टाइल को बाइट कलेक्शन के तौर पर दिखाया जाता है. इसमें टाइल का डेटा, 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- आपके ऐप्लिकेशन का एपीआई पासकोड. यह कुंजी, कोटा मैनेजमेंट के लिए आपके ऐप्लिकेशन की पहचान करती है. ज़्यादा जानकारी के लिए, कुंजी पाना लेख पढ़ें.
हीटमैप अनुरोध का उदाहरण
ऊपर दी गई इमेज में, US_AQI हीटमैप को ज़ूम लेवल 2 पर दिखाया गया है. साथ ही, हर टाइल के कोऑर्डिनेट भी दिखाए गए हैं. नीचे दिए गए उदाहरण में, heatmapTiles एंडपॉइंट का इस्तेमाल करके, हीटमैप से निर्देशांक 0,1 पर टाइल का अनुरोध किया गया है:
https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY
टाइल इस तरह दिखती है:
डिफ़ॉल्ट मैप के ऊपर, टाइल को ओवरले करने के बारे में ज़्यादा जानकारी के लिए, ओवरले मैप टाइप देखें.