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

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

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

पोज़िशन
ग्राउंड ओवरले की जगह बताने के दो तरीके हैं:
  • जगह का इस्तेमाल करना: आपको ग्राउंड ओवरले की इमेज देनी होगी. LatLng की मदद से, ऐंकर को ठीक किया जाएगा और ओवरले की चौड़ाई (मीटर में) होती है. इमेज डिफ़ॉल्ट रूप से, इमेज के सबसे ऊपरी हिस्से से 50% और इमेज के बाईं ओर से 50% की जाती है. इसे बदला जा सकता है. इसके अलावा, ओवरले की ऊंचाई की जानकारी भी दी जा सकती है. इसकी ऊंचाई मीटर में होती है. अगर ओवरले की ऊंचाई नहीं दी जाती है, तो इमेज का अनुपात बनाए रखने के लिए, ओवरले का साइज़ अपने-आप जुड़ जाता है.
  • सीमा का इस्तेमाल करना: आपको LatLngBounds देना होगा जिसमें इमेज शामिल होगी.
मैप में जोड़ने से पहले, आपको ग्राउंड ओवरले की जगह बतानी होगी. ऐसा न करने पर, मैप पर ग्राउंड ओवरले जोड़ने पर, IllegalArgumentException डाला जाएगा. इसके अलावा, आपको GroundOverlayOptions ऑब्जेक्ट में इनमें से किसी एक तरीके का इस्तेमाल करके ही पोज़िशन तय करनी होगी. अगर आप ऐसा नहीं करते हैं, तो दूसरे तरीके का इस्तेमाल करके, IllegalStateException को फेंका जाएगा.
इमेज
इस ओवरले के लिए इस्तेमाल की जाने वाली इमेज (BitmapDescriptor के रूप में). इमेज को स्केल किया जाएगा, ताकि वह दी गई जगह पर फ़िट हो सके. मैप में ग्राउंड ओवरले जोड़ने से पहले, आपको एक इमेज बतानी होगी. अगर मैप में नहीं जोड़ी गई है, तो IllegalArgumentException को नहीं डाला जाएगा.
बियरिंग
इमेज को घड़ी की दिशा में घुमाएं. इमेज के बीच का हिस्सा, रोटेशन का बीच होगा. यह वैकल्पिक है और डिफ़ॉल्ट बियरिंग 0 है. जैसे, चित्र को इस तरह संरेखित किया गया है कि ऊपर उत्तर की ओर है.
zइंडेक्स
जिस क्रम में इस ग्राउंड ओवरले को दूसरे ओवरले के हिसाब से बनाया गया है (इसमें Polyline और TileOverlay शामिल हैं, लेकिन Marker नहीं). बड़े zindex वाले ओवरले को छोटे zindexs वाले ओवरले के ऊपर बनाया जाता है. एक ही zindex वैल्यू के साथ ओवरले का क्रम, आर्बिट्रेरी है. यह वैकल्पिक है और डिफ़ॉल्ट zindex 0 है.
पारदर्शिता
[0..1] रेंज में ग्राउंड ओवरले की पारदर्शिता, जहां 0 का मतलब है कि ओवरले साफ़ नहीं है और 1 का मतलब है कि ओवरले पूरी तरह पारदर्शी है. अगर बताया गया बिटमैप पहले से ही कुछ पारदर्शी है, तो हर पिक्सल की पारदर्शिता को उसके मुताबिक स्केल किया जाएगा. उदाहरण के लिए, अगर बिट मैप में मौजूद पिक्सल की ऐल्फ़ा वैल्यू 200 है, तो आप ग्राउंड ओवरले की पारदर्शिता 0.25 के तौर पर तय करेंगे. ऐसा करने पर पिक्सल, 150 की ऐल्फ़ा वैल्यू के साथ स्क्रीन पर रेंडर होगा. इस प्रॉपर्टी की जानकारी देना ज़रूरी नहीं है और इसकी डिफ़ॉल्ट पारदर्शिता 0 (अपारदर्शिता) है.
किसको दिखे
यह बताता है कि ग्राउंड ओवरले दिखता है या नहीं. इसका मतलब है कि यह मैप पर बनाया गया है या नहीं. एक दिखाई न देने वाला ग्राउंड ओवरले ड्रॉ नहीं किया जाता है, लेकिन इसकी सभी दूसरी प्रॉपर्टी को बनाए रखता है. यह वैकल्पिक है और डिफ़ॉल्ट तौर पर दिखने वाली सेटिंग true होती है, जैसे कि यह दिखने वाली होती है.
क्लिक करने की क्षमता
अगर आप उपयोगकर्ता के ग्राउंड ओवरले पर क्लिक करके इवेंट चलाना चाहते हैं, तो इस प्रॉपर्टी को true पर सेट करें. इस वैल्यू को कभी भी बदला जा सकता है. डिफ़ॉल्ट वैल्यू false है. अगर इस प्रॉपर्टी को true पर सेट किया गया है, तो आपके ऐप्लिकेशन को setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) के ज़रिए रजिस्टर की गई 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()
यह ग्राउंड ओवरले&#39s आईडी मिलता है.
LatLng
getPosition()
ऐंकर पॉइंट की जगह की जानकारी दिखाता है.
अस्वीकार करें
getTag()
सर्कल के लिए टैग हासिल करता है.
फ़्लोट
getTransparency()
इस ग्राउंड ओवरले की पारदर्शिता का पता लगाता है.
फ़्लोट
getWidth()
ग्राउंड ओवरले की चौड़ाई का पता लगाता है.
फ़्लोट
getZindex()
इस ग्राउंड ओवरले का zindex मिलता है.
int
बूलियन
isClickable()
ग्राउंड ओवरले पर क्लिक किया जा सकता है.
बूलियन
isvisible()
इस ग्राउंड ओवरले की दृश्यता पाएं.
शून्य
हटाएं()
यह ग्राउंड ओवरले मैप से हटा देता है.
शून्य
setBearing(फ़्लो बियरिंग)
ग्राउंड ओवरले (ग्राउंड ओवरले की वर्टिकल ऐक्सिस की दिशा) को घड़ी की दिशा में उत्तर दिशा से डिग्री पर सेट करता है.
शून्य
setClickable(बूलियन क्लिक किया जा सकता है)
ग्राउंड ओवरले की क्लिक करने की क्षमता सेट करता है.
शून्य
setअप डाइमेंशन(फ़्लोट चौड़ाई, फ़्लोट ऊंचाई)
ग्राउंड ओवरले के डाइमेंशन सेट करता है.
शून्य
setdimension(फ़्लोट की चौड़ाई)
ग्राउंड ओवरले की चौड़ाई सेट करता है.
शून्य
setImage(BitmapDescriptor imageDescriptor)
ग्राउंड ओवरले के लिए चित्र सेट करता है.
शून्य
setPosition(LatLng latLng)
ऐंकर पॉइंट की जगह को बदलकर, ग्राउंड ओवरले की पोज़िशन सेट करता है.
शून्य
setPositionFromBounds(LatLngBounds की सीमाएं)
ग्राउंड ओवरले की स्थिति को दिए गए LatLngBounds से फ़िट करके सेट करता है.
शून्य
setTag(ऑब्जेक्ट टैग)
ग्राउंड ओवरले के लिए टैग सेट करता है.
शून्य
setTransparency (फ़्लो ट्रांसपेरंसी)
इस ग्राउंड ओवरले की पारदर्शिता सेट करता है.
शून्य
setvisible(बूलियन दिख रहा है)
इस ग्राउंड ओवरले की दृश्यता सेट करता है.
शून्य
setZindex(फ़्लो zindex)
इस ग्राउंड ओवरले का zindex सेट करता है.

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

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

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

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

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

Public फ़्लोट getBearing ()

उत्तर दिशा से घड़ी की दिशा में सतह के ओवरले की दिशा मिलती है.

लौटाए गए आइटम
  • ग्राउंड ओवरले की बियरिंग.

Public LatLngBounds getBounds ()

ग्राउंड ओवरले की सीमाएं पाएं. यह ग्राउंड ओवरले के घुमाव को अनदेखा करता है.

लौटाए गए आइटम
  • LatLngBounds, जिसमें ज़मीन का ओवरले लगा होता है और रोटेशन को अनदेखा किया जाता है.

public फ़्लोट getHeight ()

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

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

public string getId ()

यह ग्राउंड ओवरले&#39s आईडी मिलता है. यह आईडी, मैप पर सभी ग्राउंड ओवरले के लिए यूनीक होगी.

लौटाए गए आइटम
  • यह ग्राउंड ओवरले's आईडी

Public LatLng getPosition ()

ऐंकर पॉइंट की जगह की जानकारी दिखाता है.

लौटाए गए आइटम
  • मैप पर स्थान (एक LatLng).

public Object getTag ()

सर्कल के लिए टैग हासिल करता है.

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

public फ़्लोट getTransparency ()

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

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

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

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

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

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

इस ग्राउंड ओवरले का zindex मिलता है.

लौटाए गए आइटम
  • ग्राउंड ओवरले की zindex.

Public int hashCode ()

Public बूलियन isClickable ()

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

लौटाए गए आइटम
  • true अगर ग्राउंड ओवरले क्लिक किया जा सकता है; नहीं तो false दिखाता है.

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

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

लौटाए गए आइटम
  • यह ग्राउंड ओवरले's किसको दिखे.

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

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

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

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

पैरामीटर
बियरिंग उत्तर दिशा से घड़ी की दिशा में बियरिंग

Public प्रॉडक्ट setClickable (बूलियन क्लिक किया जा सकता है)

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

पैरामीटर
क्लिक करने योग्य ग्राउंड ओवरले के लिए क्लिक करने की नई सेटिंग.

Public प्रॉडक्ट setडाइमेंशन (फ़्लोट विड्थ, फ़्लोट हाइट)

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

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

Public प्रॉडक्ट setडाइमेंशन (फ़्लोट विड्थ)

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

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

Public प्रॉडक्ट setImage (BitmapDescriptor imageDescriptor)

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

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

Public प्रॉडक्ट setPosition (LatLng latLng)

ऐंकर पॉइंट की जगह को बदलकर, ग्राउंड ओवरले की पोज़िशन सेट करता है. इमेज की सभी दूसरी प्रॉपर्टी को सुरक्षित रखता है.

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

Public प्रॉडक्ट setPositionFromBounds (LatLngBounds की सीमाएं)

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

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

Public प्रॉडक्ट setTag (ऑब्जेक्ट टैग)

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

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

पैरामीटर
टैग अगर शून्य है, तो टैग को हटा दिया जाता है.

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

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

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

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

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

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

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

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

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