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