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 एंडपॉइंट का इस्तेमाल करके, मौजूदा पराग हॉटमैप टाइल का अनुरोध किया जा सकता है. इसके लिए, एचटीटीपी GET अनुरोध यहां भेजें:
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
टाइल, इमेज के तौर पर दिखती है. इसे मैप पर ओवरले किया जा सकता है:
डिफ़ॉल्ट मैप पर टाइल ओवरले करने के बारे में ज़्यादा जानने के लिए, ओवरले मैप टाइप देखें.