ग्राउंड ओवरले

पब्लिक फ़ाइनल क्लास GroundOverlay ऑब्जेक्ट
का विस्तार करता है

ग्राउंड ओवरले वह इमेज होती है जिसे मैप पर जोड़ा जाता है. ग्राउंड ओवरले में ये चीज़ें शामिल होती हैं प्रॉपर्टी:

स्थिति

ग्राउंड ओवरले की पोज़िशन दो तरह से तय की जा सकती है:

• जगह की जानकारी का इस्तेमाल करना: आपको ग्राउंड ओवरले की एक इमेज देनी होगी, LatLng जिस पर ऐंकर को तय किया जाएगा और ओवरले की चौड़ाई (मीटर में). कॉन्टेंट बनाने डिफ़ॉल्ट रूप से, ऐंकर विज्ञापन में इमेज के ऊपर से 50% और इमेज के बाईं ओर से 50% की दूरी पर इमेज. इसे बदला जा सकता है. आप वैकल्पिक रूप से ओवरले की ऊंचाई प्रदान कर सकते हैं (में मीटर). अगर ओवरले की ऊंचाई नहीं दी जाती है, तो यह अपने-आप इसका कैलकुलेशन, इमेज के अनुपात को बनाए रखने के लिए किया गया है.
• सीमाओं का इस्तेमाल करना: आपको एक LatLngBounds देना होगा, जिसमें इमेज शामिल होगी.

ग्राउंड ओवरले को मैप पर जोड़ने से पहले आपको इसकी जगह बतानी होगी, नहीं तो, जब ग्राउंड ओवरले होता है, तो IllegalArgumentException फेंक दिया जाता है मैप में जोड़ा गया. इसके अलावा, आपको इनमें से किसी एक का इस्तेमाल करके ही स्थिति बतानी होगी GroundOverlayOptions ऑब्जेक्ट में तरीके; ऐसा न करने पर, दूसरी तरीके का इस्तेमाल करने पर एक IllegalStateException दिखेगा.

इमेज

इस ओवरले के लिए इस्तेमाल की जाने वाली इमेज (BitmapDescriptor के तौर पर). इमेज दी गई स्थिति में फ़िट करने के लिए स्केल किया गया है. ज़मीन जोड़ने से पहले आपको एक चित्र दर्ज करना होगा मैप को ओवरले करें; अगर नहीं है, तो IllegalArgumentException को फेंक दिया जाएगा मैप में जोड़ा गया.

बियरिंग

इमेज को घड़ी की दिशा में घुमाने के लिए तय की गई दूरी. इसका केंद्र घुमाना, इमेज का ऐंकर होगा. यह ज़रूरी नहीं है और डिफ़ॉल्ट बेयरिंग 0 है, यानी कि, इमेज को इस तरह अलाइन किया गया है कि वह ऊपर उत्तर की ओर है.

zIndex

अन्य ओवरले के हिसाब से, ग्राउंड ओवरले को किस क्रम में लगाया जाता है (इसमें ये शामिल हैं Polyline और TileOverlays, लेकिन Marker नहीं). एक ओवरले, बड़े zIndex को छोटे zIndexs के साथ ओवरले किया जाता है. ओवरले का क्रम एक जैसी zIndex वैल्यू आर्बिट्रेरी है. यह ज़रूरी नहीं है और डिफ़ॉल्ट zIndex 0 है.

पारदर्शिता

[0..1] रेंज में ग्राउंड ओवरले की पारदर्शिता, जहां 0 का मतलब है ओवरले ओपेक है और 1 का मतलब है कि ओवरले पूरी तरह से पारदर्शी है. अगर बताए गए बिट मैप पहले से ही आंशिक रूप से पारदर्शी है, प्रत्येक पिक्सेल की पारदर्शिता को स्केल किया जाएगा उसी के अनुसार (उदाहरण के लिए, अगर बिटमैप में एक पिक्सेल का अल्फ़ा मान 200 है और आप ग्राउंड ओवरले की पारदर्शिता 0.25 सेट करें, फिर पिक्सल 150 की ऐल्फ़ा वैल्यू वाली स्क्रीन). इस प्रॉपर्टी की खास जानकारी देना ज़रूरी नहीं है और डिफ़ॉल्ट पारदर्शिता 0 (ओपेक) है.

किसको दिखाई दे

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

क्लिक करने की योग्यता

अगर आपको ग्राउंड ओवरले पर उपयोगकर्ता के क्लिक करने पर ट्रिगर होने वाले इवेंट मैनेज करने हैं, तो इसे सेट करें प्रॉपर्टी को true के लिए सेट किया गया है. इस वैल्यू को कभी भी बदला जा सकता है. डिफ़ॉल्ट वैल्यू false है. अगर इस प्रॉपर्टी को true पर सेट किया गया है, तो आपके ऐप्लिकेशन को GoogleMap.OnGroundOverlayClickListener को setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) तक रजिस्टर किया गया.

टैग

ग्राउंड ओवरले से जुड़ा Object. उदाहरण के लिए, Object ये काम कर सकता है ग्राउंड ओवरले के बारे में डेटा शामिल होना चाहिए. यह किसी आइटम को स्टोर करने से ज़्यादा आसान है, Map<GroundOverlay, Object> को अलग करें. एक अन्य उदाहरण के तौर पर, किसी डेटा सेट के आईडी से जुड़ा String आईडी जोड़ा जा सकता है. Android के लिए Google Maps SDK टूल में से कोई भी नहीं इस प्रॉपर्टी को पढ़ता है या लिखता है.

इस क्लास के तरीकों को Android यूज़र इंटरफ़ेस (यूआई) थ्रेड पर कॉल किया जाना चाहिए. अगर ऐसा नहीं है, तो रनटाइम के दौरान IllegalStateException वैल्यू डाली जाएगी.

उदाहरण

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));
 

सार्वजनिक तौर पर उपलब्ध तरीके के बारे में खास जानकारी

बूलियन	इसके बराबर है(अन्य ऑब्जेक्ट) जांच करता है कि यह GroundOverlay, दूसरे के बराबर है या नहीं.
फ़्लोट	getBearing() यह ग्राउंड ओवरले की बियरिंग को उत्तर की ओर घड़ी की दिशा में डिग्री पर सेट करता है.
LatLngBounds	getBounds() ग्राउंड ओवरले की सीमाएं सेट करता है.
फ़्लोट	getHeight() ग्राउंड ओवरले की ऊंचाई बताता है.
स्ट्रिंग	getId() इस ग्राउंड ओवरले का आईडी प्राप्त करता है.
LatLng	getPosition() ऐंकर पॉइंट की जगह का पता लगाता है.
ऑब्जेक्ट	getTag() मंडली के लिए टैग प्राप्त करता है.
फ़्लोट	getTransparency() इस ग्राउंड ओवरले की पारदर्शिता लाता है.
फ़्लोट	getWidth() ग्राउंड ओवरले की चौड़ाई का पता लगाता है.
फ़्लोट	getZIndex() इस ग्राउंड ओवरले का zइंडेक्स प्राप्त करता है.
int	hashCode()
बूलियन	isClickable() ग्राउंड ओवरले की क्लिक करने की योग्यता की जानकारी देता है.
बूलियन	isVisible() इस ग्राउंड ओवरले की विज़िबिलिटी मिलती है.
अमान्य	remove() मैप से इस ग्राउंड ओवरले को हटाता है.
अमान्य	setBearing(फ़्लोट बेयरिंग) ग्राउंड ओवरले की बियरिंग सेट करता है (ज़मीन के वर्टिकल ऐक्सिस की दिशा में) ओवरले पॉइंट) उत्तर दिशा से घड़ी की सुई की दिशा में
अमान्य	setClickable(बूलियन क्लिक किया जा सकता है) ग्राउंड ओवरले की क्लिक करने की योग्यता सेट करता है.
अमान्य	setDimensions(फ़्लोट की चौड़ाई, फ़्लोट की ऊंचाई) ग्राउंड ओवरले के आयाम सेट करता है.
अमान्य	setDimensions(फ़्लोट चौड़ाई) ग्राउंड ओवरले की चौड़ाई सेट करता है.
अमान्य	setImage(BitmapDescriptor imageDescriptor) ग्राउंड ओवरले के लिए इमेज सेट करता है.
अमान्य	setPosition(LatLng latLng) ऐंकर पॉइंट की जगह बदलकर ग्राउंड ओवरले की जगह तय करता है.
अमान्य	setPositionFromBounds(LatLngBounds बाउंड) ग्राउंड ओवरले की जगह तय करता है. इसके लिए, इसे दिए गए LatLngBounds के हिसाब से सेट करना होता है.
अमान्य	setTag(ऑब्जेक्ट टैग) ग्राउंड ओवरले के लिए टैग सेट करता है.
अमान्य	setTransparency(फ़्लोट पारदर्शिता) इस ग्राउंड ओवरले की पारदर्शिता सेट करता है.
अमान्य	setVisible(boolean visible) इस ग्राउंड ओवरले की दृश्यता सेट करता है.
अमान्य	setZIndex(फ़्लोट zIndex) इस ग्राउंड ओवरले का zइंडेक्स सेट करता है.

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

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

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

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

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

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

पैरामीटर

अन्य	Object.

रिटर्न

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

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

यह ग्राउंड ओवरले की बियरिंग को उत्तर की ओर घड़ी की दिशा में डिग्री पर सेट करता है.

रिटर्न

• ग्राउंड ओवरले की बियरिंग.

सार्वजनिक LatLngBounds getBounds ()

ग्राउंड ओवरले की सीमाएं सेट करता है. यह ग्राउंड ओवरले के रोटेशन पर ध्यान नहीं देता.

रिटर्न

• ऐसा LatLngBounds जिसमें ग्राउंड ओवरले होता है और इसमें रोटेशन को अनदेखा किया जाता है.

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

ग्राउंड ओवरले की ऊंचाई बताता है.

रिटर्न

• मीटर में, ग्राउंड ओवरले की ऊंचाई.

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

इस ग्राउंड ओवरले का आईडी प्राप्त करता है. यह आईडी, मैप पर सभी GroundOverlays के बीच यूनीक होगा.

रिटर्न

• इस ग्राउंड ओवरले की आईडी.

सार्वजनिक LatLng getPosition ()

ऐंकर पॉइंट की जगह का पता लगाता है.

रिटर्न

• मैप पर स्थिति (एक LatLng).

सार्वजनिक ऑब्जेक्ट getTag ()

मंडली के लिए टैग प्राप्त करता है.

रिटर्न

• अगर कोई टैग setTag के साथ सेट किया गया था, तो टैग; अगर कोई टैग सेट नहीं किया गया है, तो null.

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

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

रिटर्न

• पारदर्शिता के बारे में ज़्यादा जानकारी मिलेगी.

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

ग्राउंड ओवरले की चौड़ाई का पता लगाता है.

रिटर्न

• मीटर में, ग्राउंड ओवरले की चौड़ाई.

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

इस ग्राउंड ओवरले का zइंडेक्स प्राप्त करता है.

रिटर्न

• ग्राउंड ओवरले का zIndex.

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

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

ग्राउंड ओवरले की क्लिक करने की योग्यता की जानकारी देता है. अगर ग्राउंड ओवरले पर क्लिक किया जा सकता है, तो आपका ऐप्लिकेशन GoogleMap.OnGroundOverlayClickListener पर तब सूचनाएं भेजी जाएंगी, जब उपयोगकर्ता ग्राउंड ओवरले पर क्लिक करता है. इवेंट लिसनर को setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) तक रजिस्टर किया गया है.

रिटर्न

• true अगर ग्राउंड ओवरले पर क्लिक किया जा सकता है; ऐसा न होने पर, false दिखाता है.

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

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

रिटर्न

• इस ग्राउंड ओवरले की दृश्यता.

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

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

सार्वजनिक अमान्य setBearing (फ़्लोट बियरिंग)

ग्राउंड ओवरले की बियरिंग सेट करता है (ज़मीन के वर्टिकल ऐक्सिस की दिशा में) ओवरले पॉइंट) उत्तर दिशा से घड़ी की सुई की दिशा में एंकर के बारे में रोटेशन किया जाता है अंक.

पैरामीटर

बियरिंग	उत्तर की ओर से घड़ी की सुई की दिशा में डिग्री की दिशा में

सार्वजनिक अमान्य setClickable (बूलियन क्लिक किया जा सकता है)

ग्राउंड ओवरले की क्लिक करने की योग्यता सेट करता है. अगर ग्राउंड ओवरले पर क्लिक किया जा सकता है, तो आपका ऐप्लिकेशन GoogleMap.OnGroundOverlayClickListener पर तब सूचनाएं भेजी जाएंगी, जब उपयोगकर्ता ग्राउंड ओवरले पर क्लिक करता है. इवेंट लिसनर को setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) तक रजिस्टर किया गया है.

पैरामीटर

क्लिक करने योग्य	ग्राउंड ओवरले के लिए क्लिक करने की योग्यता से जुड़ी नई सेटिंग.

सार्वजनिक अमान्य setDimensions (फ़्लोट की चौड़ाई, फ़्लोट की ऊंचाई)

ग्राउंड ओवरले के आयाम सेट करता है. डाइमेंशन के हिसाब से इमेज को खींच लिया जाएगा.

पैरामीटर

चौड़ाई	मीटर में चौड़ाई
ऊंचाई	मीटर में ऊंचाई

सार्वजनिक अमान्य setDimensions (फ़्लोट की चौड़ाई)

ग्राउंड ओवरले की चौड़ाई सेट करता है. ग्राउंड ओवरले की ऊंचाई को एडैप्ट किया जाएगा आसपेक्ट रेशियो बनाए रखने के लिए.

पैरामीटर

चौड़ाई	मीटर में चौड़ाई

सार्वजनिक अमान्य setImage (BitmapDescriptor इमेज डिस्क्रिप्टर)

ग्राउंड ओवरले के लिए इमेज सेट करता है. नई इमेज, पुरानी इमेज की सीमाओं के मुताबिक ही दिखेगी इमेज.

पैरामीटर

imageDescriptor	इस ग्राउंड ओवरले का इस्तेमाल करने के लिए BitmapDescriptor.

सार्वजनिक अमान्य setPosition (LatLng latLng)

ऐंकर पॉइंट की जगह बदलकर ग्राउंड ओवरले की जगह तय करता है. संरक्षित क्षेत्र इमेज की अन्य सभी प्रॉपर्टी.

पैरामीटर

latLng	LatLng, जो ऐंकर पॉइंट को लगाने की नई जगह है.

सार्वजनिक अमान्य setPositionFromBounds (LatLngBounds की सीमाएं)

ग्राउंड ओवरले की जगह तय करता है. इसके लिए, इसे दिए गए LatLngBounds के हिसाब से सेट करना होता है. यह ग्राउंड ओवरले की पोज़िशन सेट करते समय, यह तरीका ग्राउंड ओवरले के रोटेशन (बियरिंग) को अनदेखा कर देगा, लेकिन बियरिंग का इस्तेमाल तब भी किया जाएगा, जब इसे बनाया जाएगा.

पैरामीटर

सीमाएं	एक LatLngBounds, जिसमें ग्राउंड ओवरले लगाना है

सार्वजनिक अमान्य setTag (ऑब्जेक्ट टैग)

ग्राउंड ओवरले के लिए टैग सेट करता है.

इस प्रॉपर्टी का इस्तेमाल करके, इस ग्राउंड ओवरले के साथ आर्बिट्रेरी Object को जोड़ा जा सकता है. उदाहरण के लिए, Object में ग्राउंड ओवरले के बारे में डेटा हो सकता है. यह अलग Map<GroundOverlay, Object> को स्टोर करने के मुकाबले ज़्यादा आसान है. एक अन्य उदाहरण के रूप में, किसी डेटा सेट के आईडी से जुड़े String आईडी को जोड़ सकता है. इसके लिए Google Maps SDK Android इस प्रॉपर्टी को न तो पढ़ता है और न ही लिखता है. यह आपकी ज़िम्मेदारी है कि जब आपको टैग की ज़रूरत न हो, तब उसे हटाने के लिए setTag(null) को कॉल करें, ताकि आपके ऐप्लिकेशन में मेमोरी लीक न हो.

पैरामीटर

टैग	अगर यह खाली है, तो टैग हटा दिया जाता है.

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

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

पैरामीटर

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

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

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

पैरामीटर

दिख रहा है	अगर true है, तो ग्राउंड ओवरले दिखता है; अगर false है, तो

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

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

पैरामीटर

zIndex	इस ग्राउंड ओवरले का zIndex