हीटमैप

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 हीटमैप को दो ज़ूम लेवल के साथ दिखाया गया है:

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

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

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

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

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

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

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

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

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

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