टाइल ओवरले

सार्वजनिक फ़ाइनल क्लास TileOverlay, ऑब्जेक्ट को बढ़ाता है

टाइल ओवरले, इमेज का एक सेट होता है, जो बेस मैप टाइल के सबसे ऊपर दिखता है. ये टाइल पारदर्शी हो सकती हैं. इससे आप मौजूदा मैप में सुविधाएं जोड़ पाएंगे. टाइल ओवरले में ये प्रॉपर्टी होती हैं:

टाइल कंपनी
TileProvider, टाइल ओवरले में इस्तेमाल की जाने वाली इमेज उपलब्ध कराता है. मैप में जोड़ने से पहले, आपको टाइल की सेवा देने वाली कंपनी का नाम बताना होगा. टाइल कंपनी जुड़ने के बाद, इसे बदला नहीं जा सकता. हालांकि, खास निर्देशांकों के लिए अलग-अलग इमेज दिखाने के लिए, टाइल की सेवा देने वाली कंपनी के व्यवहार में बदलाव किया जा सकता है. अगर टाइल उपलब्ध कराने वाली कंपनी ने जो टाइल दी हैं वे बदल जाती हैं, तो आपको clearTileCache() को कॉल करना होगा. इससे, यह पक्का किया जा सकेगा कि पिछली टाइल को रेंडर न किया जाए.
Z-इंडेक्स
वह क्रम जिसमें यह टाइल ओवरले दूसरे ओवरले के हिसाब से बनाया गया है (इसमें GroundOverlay, Circle, Polyline, और Polygon शामिल हैं, लेकिन Marker नहीं). बड़े z-इंडेक्स वाला ओवरले, छोटे z-इंडेक्स वाले ओवरले पर बनाया जाता है. एक ही z-इंडेक्स के साथ ओवरले का क्रम, आर्बिट्रेरी है. डिफ़ॉल्ट zindex 0 है.
पारदर्शिता
[0..1] की रेंज में टाइल ओवरले की पारदर्शिता, जहां 0 का मतलब है कि ओवरले साफ़ नहीं है और 1 का मतलब है कि ओवरले पूरी तरह पारदर्शी है. अगर बताया गया बिटमैप पहले से ही कुछ पारदर्शी है, तो हर पिक्सल की पारदर्शिता को उसके मुताबिक स्केल किया जाएगा. उदाहरण के लिए, अगर बिट मैप में मौजूद पिक्सल की ऐल्फ़ा वैल्यू 200 है, तो पारदर्शिता के लिए टाइल के ओवरले को 0.25 के तौर पर तय किया जाता है. इसके बाद, पिक्सल 150 के ऐल्फ़ा मान के साथ स्क्रीन पर रेंडर हो जाएगा. इस प्रॉपर्टी की जानकारी देना ज़रूरी नहीं है और इसकी डिफ़ॉल्ट पारदर्शिता 0 (अपारदर्शिता) है.
किसको दिखे
यह बताता है कि क्या टाइल ओवरले दिख रहा है या नहीं दिख रहा है, जैसे कि इसे मैप पर बनाया गया है या नहीं. एक छिपाई गई टाइल ओवरले नहीं बनाई गई है. हालांकि, यह अपनी सभी दूसरी प्रॉपर्टी को बनाए रखती है. true डिफ़ॉल्ट है, जैसे कि दिखता है.

आपको मुख्य थ्रेड पर, इस क्लास में सिर्फ़ मैथड को कॉल करना होगा. ऐसा न करने पर IllegalStateException.

टाइल निर्देशांक

ध्यान दें कि दुनिया को प्रोजेक्ट के देशांतर के 180 डिग्री और देशांतर के 180 डिग्री (दाईं ओर) के आगे मैप के बाईं ओर (पश्चिम में) मेर्काटर प्रोजेक्शन (Wikipedia देखें) का इस्तेमाल करके प्रोजेक्ट किया गया है. मैप को स्क्वेयर बनाने के लिए, मैप के ऊपरी और उत्तरी हिस्से को 85.0511 डिग्री में बदला जाता है. साथ ही, मैप के निचले और ऊपरी हिस्से को अक्षांश की -85.0511 डिग्री से देखा जाता है. इस अक्षांश रेंज के बाहर के क्षेत्र रेंडर नहीं किए जाते हैं.

ज़ूम के हर लेवल पर, मैप को टाइल में बांटा जाता है. इसके अलावा, स्क्रीन को ओवरलैप करने वाली टाइल ही डाउनलोड और रेंडर की जाती हैं. हर टाइल वर्गाकार होती है और मैप नीचे बताए गए तरीके से टाइल में बंटा होता है:

  • ज़ूम लेवल 0 पर, एक टाइल पूरी दुनिया को दिखाती है. उस टाइल के निर्देशांक (x, y) = (0, 0) हैं.
  • ज़ूम लेवल एक पर, दुनिया को 2 x 2 ग्रिड में व्यवस्थित चार टाइलों में बांटा जाता है.
  • ...
  • ज़ूम लेवल N पर, दुनिया को 2N x 2N ग्रिड में व्यवस्थित 4N टाइल में बांटा गया है.
ध्यान दें कि ज़ूम करने के लिए, कैमरे का लेवल कम से कम GoogleMap.getMinZoomLevel होना चाहिए. साथ ही, कम से कम ज़ूम लेवल के लिए, कम से कम GoogleMap.getMaxZoomLevel लेवल इस्तेमाल किए जा सकते हैं.

टाइल के निर्देशांकों को मैप के सबसे ऊपर बाएं (उत्तरी-पश्चिम) कोने से मापा जाता है. ज़ूम लेवल N पर, टाइल के निर्देशांक की x वैल्यू 0 से 2N - 1 तक होती हैं. साथ ही, y वैल्यू 0 से 2N - 1 तक और उत्तर से दक्षिण तक बढ़ती हैं.

उदाहरण

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));
 

सार्वजनिक मेथड की खास जानकारी

शून्य
ClearTileCache()
इससे टाइल की कैश मेमोरी मिट जाती है, ताकि TileProvider से सभी टाइल के लिए फिर से अनुरोध किया जाए.
बूलियन
बराबर है(ऑब्जेक्ट का अन्य ऑब्जेक्ट)
यह टेस्ट करता है कि यह TileOverlay किसी अन्य कार्ड के बराबर है या नहीं.
बूलियन
getFadeIn()
यह नीति तय करती है कि ओवरले टाइलें फ़ेड होनी चाहिए या नहीं.
स्ट्रिंग
getId()
इस टाइल ओवरले की आईडी मिलती है.
फ़्लोट
getTransparency()
इस टाइल ओवरले की पारदर्शिता का पता लगाता है.
फ़्लोट
getZindex()
इस टाइल ओवरले का zindex मिलता है.
int
बूलियन
isvisible()
इस टाइल ओवरले की दृश्यता प्राप्त करता है.
शून्य
हटाएं()
मैप से यह टाइल ओवरले हटा देता है.
शून्य
setFadeIn(बूलियन फ़ेडइन)
इस नीति से यह सेट किया जाता है कि ओवरले टाइलें फ़ेड होनी चाहिए या नहीं.
शून्य
setTransparency(फ़्लो ट्रांसपेरंसी)
इस टाइल ओवरले की पारदर्शिता सेट करता है.
शून्य
setvisible(बूलियन दिख रहा है)
इस टाइल ओवरले की दृश्यता सेट करता है.
शून्य
setZindex(फ़्लो zindex)
इस टाइल ओवरले का zindex सेट करता है.

इनहेरिट किए गए तरीके की खास जानकारी

सार्वजनिक तरीके

Public प्रॉडक्ट clearTileCache ()

इससे टाइल की कैश मेमोरी मिट जाती है, ताकि TileProvider से सभी टाइल के लिए फिर से अनुरोध किया जाए. इस तरीके से कॉल करने के बाद, इस टाइल ओवरले से मौजूदा टाइल भी मैप से मिटा दी जाएंगी. एपीआई, टाइल की कैश मेमोरी को सेव रखता है. अगर आप टाइल को ज़्यादा समय के लिए कैश मेमोरी में रखना चाहते हैं, तो आपको डिस्क की कैश मेमोरी का इस्तेमाल करना चाहिए.

पब्लिक बूलियन इसके बराबर है (ऑब्जेक्ट अन्य)

यह टेस्ट करता है कि यह TileOverlay किसी अन्य कार्ड के बराबर है या नहीं.

पैरामीटर
अन्य एक Object.
लौटाए गए आइटम
  • अगर दोनों ऑब्जेक्ट एक ही ऑब्जेक्ट हैं, तो यह 'सही' है.

Public बूलियन getFadeIn ()

यह नीति तय करती है कि ओवरले टाइलें फ़ेड होनी चाहिए या नहीं.

लौटाए गए आइटम
  • अगर टाइल नहीं दिख रही हैं, तो true; अगर नहीं हैं, तो false.

public string getId ()

इस टाइल ओवरले की आईडी मिलती है.

public फ़्लोट getTransparency ()

इस टाइल ओवरले की पारदर्शिता का पता लगाता है.

लौटाए गए आइटम
  • इस टाइल ओवरले की पारदर्शिता.

फ़ैमिली फ़्लोट getZindex ()

इस टाइल ओवरले का zindex मिलता है.

लौटाए गए आइटम
  • टाइल ओवरले का zindex.

Public int hashCode ()

सार्वजनिक बूलियन isvisible ()

इस टाइल ओवरले की दृश्यता प्राप्त करता है. ध्यान दें कि इससे यह पता नहीं चलता कि टाइल ओवरले वाकई स्क्रीन के व्यूपोर्ट में है या नहीं, लेकिन अगर यह स्क्रीन के व्यूपोर्ट में है, तो इसे ड्रॉ किया जाएगा या नहीं.

लौटाए गए आइटम
  • यह टाइल ओवरले की दृश्यता.

Public प्रॉडक्ट हटाएं ()

मैप से यह टाइल ओवरले हटा देता है.

Public प्रॉडक्ट setFadeIn (बूलियन फ़ेडइन)

इस नीति से यह सेट किया जाता है कि ओवरले टाइलें फ़ेड होनी चाहिए या नहीं.

पैरामीटर
फ़ेड इन टाइल को फ़ेड करने के लिए true; उन्हें तुरंत रेंडर करने के लिए false.

सार्वजनिक शून्य setTransparency (फ़्लोट ट्रांसपेरंसी)

इस टाइल ओवरले की पारदर्शिता सेट करता है. ज़्यादा जानकारी के लिए, इस कक्षा में सबसे ऊपर दिए गए दस्तावेज़ देखें.

पैरामीटर
पारदर्शिता [0..1] रेंज में फ़्लोट, जहां 0 का मतलब है कि टाइल ओवरले अपारदर्शिता है और 1 का मतलब है कि टाइल ओवरले पारदर्शी है.

Public प्रॉडक्ट setvisible (बूलियन दिख रहे)

इस टाइल ओवरले की दृश्यता सेट करता है. जब टाइल नहीं दिखती, तब यह ड्रॉइंग नहीं होती है. हालांकि, यह अपनी सभी अन्य प्रॉपर्टी को बनाए रखती है. टाइल ओवरले डिफ़ॉल्ट रूप से दिखाई देते हैं.

पैरामीटर
दिख रहा है इस ओवरले को देखने के लिए true; इसे न दिखने लायक बनाने के लिए false.

Public प्रॉडक्ट setZindex (फ़्लोट zindex)

इस टाइल ओवरले का zindex सेट करता है. ज़्यादा जानकारी के लिए, इस कक्षा में सबसे ऊपर दिए गए दस्तावेज़ देखें.

पैरामीटर
zइंडेक्स इस टाइल ओवरले की zindex.