हीटमैप

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 पर ऐक्सेस किया जा सकता है.

पूरी दुनिया का हीटमैप, जिसे 4x4 ग्रिड के तौर पर दिखाया गया है.

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

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) पर मौजूद टाइल का अनुरोध किया है, तो एपीआई गड़बड़ी का मैसेज दिखाएगा.

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

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

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

यह टाइल, मैप पर ओवरले की जा सकने वाली इमेज के तौर पर दिखती है:

TREE_UPI मैप का इस्तेमाल करने वाली हीटमैप टाइल का उदाहरण.

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