हीटमैप

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

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

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

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

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

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

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

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

किसी अनुरोध में सभी अनुरोध पैरामीटर आवश्यक हैं:

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

  • Z - ज़ूम लेवल, जिससे यह तय होता है कि मैप व्यू में, मैप का कॉन्टेंट कितना बड़ा या छोटा दिखेगा. वैल्यू के तौर पर 0 से 16 को चुना जा सकता है. यहां 0 की वैल्यू 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 पर हीटमैप टाइल.

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