हीटमैप

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 टाइल होती हैं. ज़ूम से यह भी तय होता है कि निर्देशांक के लिए ज़्यादा से ज़्यादा कौनसी वैल्यू इस्तेमाल की जा सकती है.

इस इमेज में, ज़ूम लेवल 2 वाला US_AQI हीटमैप दिखाया गया है. साथ ही, हर टाइल के कोऑर्डिनेट भी दिखाए गए हैं:

चार पंक्तियों और चार कॉलम वाले ग्रिड के तौर पर, पूरी दुनिया का हीटमैप.

ज़्यादा जानकारी के लिए, मैप और टाइल के निर्देशांक देखें.

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

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

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

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

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

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