हीटमैप

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

पूरी दुनिया का हीटमैप, जिसे 4x4 ग्रिड के तौर पर दिखाया गया है.

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

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

हीटमैप टाइल को बाइट के कलेक्शन के तौर पर दिखाया जाता है. इसमें टाइल का डेटा, पीएनजी इमेज के तौर पर होता है. 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 - आपके ऐप्लिकेशन का एपीआई पासकोड. यह कुंजी, कोटा मैनेजमेंट के लिए आपके ऐप्लिकेशन की पहचान करती है. ज़्यादा जानकारी के लिए, कुंजी पाना लेख पढ़ें.

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

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

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

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

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

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