heatmapTiles एंडपॉइंट, टाइल ओवरले के ज़रिए पराग से जुड़े हीटमैप उपलब्ध कराता है. टाइल ओवरले, इमेज टाइल का कलेक्शन होता है. इसे Google Maps पर दिखाया जा सकता है. हर इमेज टाइल का साइज़ 256 x 256 पिक्सल होता है.
टाइल ओवरले, टाइल के कलेक्शन से बनी ग्रिड होती है. हर टाइल को (X,Y) निर्देशांक असाइन किए जाते हैं. निर्देशांक (0,0) वाली टाइल, मैप के उत्तर-पश्चिम कोने पर हमेशा दिखती है. X की वैल्यू, पश्चिम से पूर्व की ओर बढ़ने पर बढ़ती हैं. वहीं, Y की वैल्यू, उत्तर से दक्षिण की ओर बढ़ने पर बढ़ती हैं.
zoom level से तय होता है कि मैप व्यू में, मैप का कॉन्टेंट कितना बड़ा या छोटा दिखेगा. टाइल ग्रिड का साइज़, ज़ूम करने के लेवल के हिसाब से X और Y निर्देशांकों को एक्स्पोनेंशियल तरीके से स्केल करके तय किया जाता है.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
उदाहरण के लिए, ज़ूम करने के लेवल 2 पर, दुनिया के मैप को 4 x 4 मैट्रिक्स का इस्तेमाल करके दिखाया जाता है. इसमें कुल 16 टाइल होती हैं.
यहां दी गई इमेज में, पूरी दुनिया का TREE_UPI हीटमैप दिखाया गया है. इसे टाइल में बांटा गया है. इन टाइल को ज़ूम करने के लेवल 2 पर ऐक्सेस किया जा सकता है.
ज़्यादा जानकारी के लिए, मैप और टाइल के निर्देशांक देखें.
heatmapTiles एंडपॉइंट का इस्तेमाल करके, पराग के मौजूदा हीटमैप टाइल का अनुरोध किया जा सकता है. इसके लिए, यहां एचटीटीपी जीईटी अनुरोध भेजें:
https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
हीटमैप एंडपॉइंट के बारे में जानकारी
अनुरोध पूरा करने के लिए, यहां दिए गए सभी पैरामीटर ज़रूरी हैं:
KEY: आपके ऐप्लिकेशन का एपीआई पासकोड. यह पासकोड, कोटा मैनेजमेंट के लिए आपके ऐप्लिकेशन की पहचान करता है. पासकोड पाने का तरीका जानें.TYPE: वापस पाने के लिए हीटमैप का टाइप. स्वीकार की जाने वाली वैल्यू देखें.Z: ज़ूम करने का लेवल. इससे तय होता है कि मैप व्यू में, मैप का कॉन्टेंट कितना बड़ा या छोटा दिखेगा. स्वीकार की जाने वाली वैल्यू 0 से 16 के बीच होनी चाहिए. वैल्यू 0 होने पर, पूरी दुनिया एक टाइल में दिखती है.X,Y: उत्तर-पूर्व कोने (0,0) के मुकाबले टाइल कोऑर्डिनेट.Xकी वैल्यू, पश्चिम से पूर्व की ओर बढ़ने पर बढ़ती हैं. वहीं,Yकी वैल्यू, उत्तर से दक्षिण की ओर बढ़ने पर बढ़ती हैं. निर्देशांक, तय किए गए ज़ूम करने के लेवल के हिसाब से मान्य होने चाहिए. उदाहरण के लिए, अगर आपने ज़ूम लेवल को 2 पर सेट किया है और निर्देशांक (10,10) वाली टाइल का अनुरोध किया है, तो एपीआई गड़बड़ी का मैसेज दिखाता है.
हीटमैप के अनुरोध का उदाहरण
ऊपर दी गई इमेज में, TREE_UPI हीटमैप दिखाया गया है. इसका ज़ूम करने का लेवल 2 है. साथ ही, इसमें हर टाइल के निर्देशांक भी दिखाए गए हैं. यहां दिए गए उदाहरण में, निर्देशांक (2,1) वाली टाइल का अनुरोध करने के लिए, heatmapTiles एंडपॉइंट का इस्तेमाल किया गया है:
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
यह टाइल, एक इमेज के तौर पर दिखती है. इसे मैप पर ओवरले किया जा सकता है:
डिफ़ॉल्ट मैप पर टाइल ओवरले करने के बारे में ज़्यादा जानने के लिए, मैप टाइप ओवरले करना लेख पढ़ें.