हीटमैप

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 हीटमैप दिखाया गया है. साथ ही, हर टाइल के कोऑर्डिनेट भी दिखाए गए हैं:

चार-बाय-चार ग्रिड के तौर पर पूरी दुनिया का हीटमैप.

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

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

हीटमैप टाइल को बाइट कलेक्शन से दिखाया जाता है. इसमें टाइल का डेटा, पीएनजी इमेज के तौर पर होता है. 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 है. साथ ही, हर टाइल के कोऑर्डिनेट दिखाए गए हैं. इस उदाहरण में, हीटमैप से निर्देशांक 0,1 पर मौजूद टाइल का अनुरोध करने के लिए, heatmapTiles एंडपॉइंट का इस्तेमाल किया गया है:

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

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

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

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