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