टाइल ओवरले

पब्लिक फ़ाइनल क्लास 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.

टाइल कोऑर्डिनेट

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

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

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

ध्यान दें कि कैमरे में कम से कम ज़ूम लेवल कितना होता है (यह कई चीज़ों पर निर्भर कर सकता है) GoogleMap.getMinZoomLevel है और ज़ूम का ज़्यादा से ज़्यादा लेवल GoogleMap.getMaxZoomLevel है.

टाइल के निर्देशांक, मैप के ऊपरी बाएं (उत्तर-पश्चिम) कोने से मापे जाते हैं. पर ज़ूम स्तर N, टाइल निर्देशांक के x मान 0 से 2^N - 1 तक होते हैं और पश्चिम से पूर्व तक बढ़ाएं और y के मान की सीमा 0 से 2^N - 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	hashCode()
बूलियन	isVisible() इस टाइल ओवरले के दिखने की सुविधा चालू करता है.
अमान्य	remove() मैप से यह टाइल ओवरले हटाता है.
अमान्य	setFadeIn(boolean fadeIn) सेट करता है कि ओवरले टाइल फ़ेड इन हों या नहीं.
अमान्य	setTransparency(फ़्लोट पारदर्शिता) इस टाइल ओवरले की पारदर्शिता सेट करता है.
अमान्य	setVisible(boolean visible) यह सेट करता है कि टाइल ओवरले किसको दिखे.
अमान्य	setZIndex(फ़्लोट zIndex) इस टाइल ओवरले का zIndex सेट करता है.

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

क्लास से java.lang.Object

बूलियन	इसके बराबर है(ऑब्जेक्ट org0)
फ़ाइनल क्लास<?>	getClass()
int	hashCode()
फ़ाइनल अमान्य	notify()
फ़ाइनल अमान्य	notifyAll()
स्ट्रिंग	toString()
फ़ाइनल अमान्य	wait(long rc0, int org1)
फ़ाइनल अमान्य	wait(long rc0)
फ़ाइनल अमान्य	wait()

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

सार्वजनिक अमान्य clearTileCache ()

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

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

जांच करता है कि यह TileOverlay, दूसरे के बराबर है या नहीं.

पैरामीटर

अन्य	Object.

रिटर्न

• सही है अगर दोनों ऑब्जेक्ट एक ही ऑब्जेक्ट हैं, यानी, यह == अन्य.

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

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

रिटर्न

• true अगर टाइल धुंधली हो जाएं; अगर वे नहीं हैं, तो false.

सार्वजनिक स्ट्रिंग getId ()

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

सार्वजनिक फ़्लोट getTransparency ()

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

रिटर्न

• पारदर्शिता के बारे में बताता है.

सार्वजनिक फ़्लोट getZIndex ()

इस टाइल ओवरले का zIndex देता है.

रिटर्न

• टाइल ओवरले का zIndex.

सार्वजनिक आईएनटी hashCode ()

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

इस टाइल ओवरले के दिखने की सुविधा चालू करता है. ध्यान दें कि इससे यह पता नहीं चलता कि टाइल ओवरले असल में स्क्रीन के व्यूपोर्ट के अंदर है, लेकिन अगर इसे जो स्क्रीन के व्यूपोर्ट में मौजूद होता है.

रिटर्न

• इस टाइल ओवरले की दृश्यता.

सार्वजनिक अमान्य हटाएं ()

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

सार्वजनिक अमान्य setFadeIn (बूलियन फ़ेडइन)

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

पैरामीटर

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

सार्वजनिक अमान्य setTransparency (फ़्लोट पारदर्शिता)

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

पैरामीटर

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

सार्वजनिक अमान्य setVisible (बूलियन के तौर पर दिख रहा है)

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

पैरामीटर

दिख रहा है	इस ओवरले को दिखाने के लिए true; इसे ग्लोब पर दिखाने के लिए false.

सार्वजनिक अमान्य setZIndex (फ़्लोट zइंडेक्स)

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

पैरामीटर

zIndex	इस टाइल ओवरले का zIndex.