का विस्तार करता है
ग्राउंड ओवरले वह इमेज होती है जो किसी मैप पर स्थिर होती है. ग्राउंड ओवरले में ये प्रॉपर्टी होती हैं:
- रैंक
- ग्राउंड ओवरले की जगह बताने के दो तरीके हैं:
- जगह का इस्तेमाल: आपको ग्राउंड ओवरले की एक इमेज देनी होगी. इस इमेज में
LatLng
का इस्तेमाल करके ऐंकर तय किया जाएगा. साथ ही, ओवरले की चौड़ाई (मीटर में) भी होनी चाहिए. डिफ़ॉल्ट रूप से, ऐंकर, इमेज के सबसे ऊपर 50% और इमेज की बाईं ओर से 50% हिस्सा होता है. इसे बदला जा सकता है. आपके पास ओवरले की ऊंचाई (मीटर में) दिखाने का विकल्प भी है. अगर आप ओवरले की ऊंचाई नहीं देते हैं, तो इमेज का अनुपात बनाए रखने के लिए, ओवरले की अपने-आप गिनती कर ली जाती है. - बाउंड का इस्तेमाल करना: आपको एक
LatLngBounds
देना होगा, जिसमें इमेज होगी.
IllegalArgumentException
दिखेगा. इसके अलावा, आपकोGroundOverlayOptions
ऑब्जेक्ट में, इनमें से किसी एक तरीके का इस्तेमाल करके, सिर्फ़ रैंक बताना ज़रूरी है. ऐसा न करने पर, दूसरा तरीका इस्तेमाल करने परIllegalStateException
को इस्तेमाल किया जाएगा. - जगह का इस्तेमाल: आपको ग्राउंड ओवरले की एक इमेज देनी होगी. इस इमेज में
- इमेज
- इस ओवरले के लिए इस्तेमाल की जाने वाली इमेज (
BitmapDescriptor
के तौर पर). इमेज की स्केलिंग की जाएगी, ताकि वह दी गई पोज़िशन के हिसाब से फ़िट हो सके. मैप में ग्राउंड ओवरले जोड़ने से पहले, आपको एक इमेज तय करनी होगी. अगर ऐसा नहीं किया जाता है, तो मैप पर जोड़ते समयIllegalArgumentException
को फेंका जाएगा. - बियरिंग
- इमेज को घड़ी की दिशा में घुमाकर कितनी मात्रा में घुमाया जाना चाहिए. रोटेशन का बीच का हिस्सा इमेज का ऐंकर होगा. यह ज़रूरी नहीं है और डिफ़ॉल्ट बियरिंग 0 है, जैसे कि इमेज को अलाइन किया गया है, ताकि उत्तर दिशा में ऊपर की ओर हो.
- zIndex
- वह क्रम जिसमें यह ग्राउंड ओवरले दूसरे ओवरले के हिसाब से बनाया जाता है (इसमें
Polyline
औरTileOverlay
शामिल हैं, लेकिनMarker
नहीं). बड़े zIndex वाला ओवरले, छोटे zIndex वाले ओवरले पर बनाया जाता है. एक ही 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));
सार्वजनिक तरीके से जुड़ी खास जानकारी
boolean |
इसके बराबर है(अन्य ऑब्जेक्ट)
यह टेस्ट करता है कि यह
GroundOverlay , दूसरे के बराबर है या नहीं. |
float |
getBearing()
उत्तर से घड़ी की दिशा में डिग्री में ग्राउंड ओवरले का असर दिखाता है.
|
LatLngBounds |
getBounds()
ग्राउंड ओवरले के लिए बाउंड रोकता है.
|
float |
getHeight()
ग्राउंड ओवरले की ऊंचाई दिखाता है.
|
String |
getId()
इस ग्राउंड ओवरले का आईडी हासिल करता है.
|
LatLng |
getPosition()
ऐंकर पॉइंट की जगह की जानकारी हासिल करता है.
|
ऑब्जेक्ट |
getTag()
मंडली के लिए टैग पाता है.
|
float |
getTransparency()
इस ग्राउंड ओवरले की पारदर्शिता मिलती है.
|
float |
getWidth()
ग्राउंड ओवरले की चौड़ाई दिखाता है.
|
float |
getZIndex()
इस ग्राउंड ओवरले का zIndex मिलता है.
|
int |
hashCode()
|
boolean |
isClickable()
ग्राउंड ओवरले की क्लिक करने की क्षमता हासिल करता है.
|
boolean |
isVisible()
इस ग्राउंड ओवरले के दिखने की जानकारी मिलती है.
|
void |
हटाएं()
इस ग्राउंड ओवरले को मैप से हटाता है.
|
void |
setBearing(फ़्लोट बेयरिंग)
ग्राउंड ओवरले (ग्राउंड ओवरले के वर्टिकल ऐक्सिस की दिशा) उत्तर से घड़ी की दिशा में डिग्री में सेट करता है.
|
void |
setClickable(बूलियन क्लिक करने लायक)
ग्राउंड ओवरले की क्लिक करने की क्षमता सेट करता है.
|
void |
setDimensions(फ़्लोट की चौड़ाई, फ़्लोट की ऊंचाई)
ग्राउंड ओवरले के डाइमेंशन सेट करता है.
|
void |
setDimensions(फ़्लोट की चौड़ाई)
ग्राउंड ओवरले की चौड़ाई सेट करता है.
|
void | |
void | |
void |
setPositionFromBounds(LatLngBounds बाउंड)
दिए गए
LatLngBounds में फ़िट करके, ग्राउंड ओवरले की जगह सेट करता है. |
void |
setTag(ऑब्जेक्ट टैग)
ग्राउंड ओवरले के लिए टैग सेट करता है.
|
void |
setTransparency(फ़्लोट ट्रांसपेरंसी (पारदर्शिता)
इस ग्राउंड ओवरले की पारदर्शिता सेट करता है.
|
void |
setVisible(बूलियन विज़ुअल)
इस ग्राउंड ओवरले की दृश्यता सेट करता है.
|
void |
setZIndex(फ़्लोट zIndex)
इस ग्राउंड ओवरले का zIndex सेट करता है.
|
इनहेरिट किए गए तरीके की खास जानकारी
सार्वजनिक तरीके
सार्वजनिक बूलियन इसके बराबर है (अन्य ऑब्जेक्ट)
यह टेस्ट करता है कि यह GroundOverlay
, दूसरे के बराबर है या नहीं.
पैरामीटर
अन्य | एक Object . |
---|
रिटर्न
- अगर दोनों ऑब्जेक्ट एक ही ऑब्जेक्ट हैं, यानी कि यह == अन्य है, तो 'सही'.
सार्वजनिक फ़्लोट getBearing ()
उत्तर से घड़ी की दिशा में डिग्री में ग्राउंड ओवरले का असर दिखाता है.
रिटर्न
- पहले से मौजूद है.
सार्वजनिक LatLngBounds getBounds ()
ग्राउंड ओवरले के लिए बाउंड रोकता है. यह ग्राउंड ओवरले के रोटेशन पर ध्यान नहीं देता.
रिटर्न
LatLngBounds
जिसमें ग्राउंड ओवरले शामिल है. इसमें, रोटेशन को अनदेखा किया जाता है.
सार्वजनिक फ़्लोट getHeight ()
ग्राउंड ओवरले की ऊंचाई दिखाता है.
रिटर्न
- ऊपर लगे ग्राउंड ओवरले की ऊंचाई को मीटर में बदलें.
सार्वजनिक स्ट्रिंग getId ()
इस ग्राउंड ओवरले का आईडी हासिल करता है. यह आईडी, मैप पर सभी GroundOverlays के लिए खास होगा.
रिटर्न
- इस ग्राउंड ओवरले का आईडी.
सार्वजनिक LatLng getPosition ()
ऐंकर पॉइंट की जगह की जानकारी हासिल करता है.
रिटर्न
- मैप की जगह (a
LatLng
).
सार्वजनिक ऑब्जेक्ट getTag ()
मंडली के लिए टैग पाता है.
रिटर्न
- अगर किसी टैग को
setTag
के साथ सेट किया गया था, तो टैग. अगर कोई टैग सेट नहीं किया गया है, तोnull
.
सार्वजनिक फ़्लोट getTransparency ()
इस ग्राउंड ओवरले की पारदर्शिता मिलती है.
रिटर्न
- इस ग्राउंड ओवरले की पारदर्शिता.
Public फ़्लोट getWidth ()
ग्राउंड ओवरले की चौड़ाई दिखाता है.
रिटर्न
- ऊपर लगे ग्राउंड ओवरले की चौड़ाई को मीटर में.
सार्वजनिक फ़्लोट getZIndex ()
इस ग्राउंड ओवरले का zIndex मिलता है.
रिटर्न
- ग्राउंड ओवरले का zIndex.
Public int hashCode ()
सार्वजनिक बूलियन isClickable ()
ग्राउंड ओवरले की क्लिक करने की क्षमता हासिल करता है. अगर ग्राउंड ओवरले पर क्लिक किया जा सकता है, तो जब उपयोगकर्ता ग्राउंड ओवरले पर क्लिक करेगा, तब आपके ऐप्लिकेशन को GoogleMap.OnGroundOverlayClickListener
पर सूचनाएं मिलेंगी. इवेंट लिसनर का रजिस्ट्रेशन setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
तक किया गया है.
रिटर्न
- अगर ग्राउंड ओवरले क्लिक करने लायक है, तो
true
. ऐसा न होने परfalse
दिखाता है.
सार्वजनिक बूलियन isVisible ()
इस ग्राउंड ओवरले के दिखने की जानकारी मिलती है. ध्यान दें कि इससे यह पता नहीं चलता है कि ग्राउंड ओवरले असल में स्क्रीन पर है या नहीं. हालांकि, अगर यह कैमरे के व्यूपोर्ट में शामिल होता है, तो इसे बनाया जाएगा या नहीं.
रिटर्न
- इस ग्राउंड ओवरले की विज़िबिलिटी.
Public void हटाएं ()
इस ग्राउंड ओवरले को मैप से हटाता है. ग्राउंड ओवरले (ग्राउंड ओवरले) को हटाने के बाद, इसके सभी तरीकों का व्यवहार तय नहीं होता.
Public void setBearing (फ़्लोट बियरिंग)
ग्राउंड ओवरले (ग्राउंड ओवरले के वर्टिकल ऐक्सिस की दिशा) उत्तर से घड़ी की दिशा में डिग्री में सेट करता है. ऐंकर पॉइंट को घुमाया जाता है.
पैरामीटर
बियरिंग | उत्तर से घड़ी की दिशा में डिग्री में |
---|
Public void setClickable (बूलियन क्लिक किया जा सकने वाला)
ग्राउंड ओवरले की क्लिक करने की क्षमता सेट करता है. अगर ग्राउंड ओवरले पर क्लिक किया जा सकता है, तो जब उपयोगकर्ता ग्राउंड ओवरले पर क्लिक करेगा, तब आपके ऐप्लिकेशन को GoogleMap.OnGroundOverlayClickListener
पर सूचनाएं मिलेंगी. इवेंट लिसनर का रजिस्ट्रेशन setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
तक किया गया है.
पैरामीटर
क्लिक करने योग्य | ग्राउंड ओवरले के लिए क्लिक करने की नई सेटिंग. |
---|
Public void setDimensions (फ़्लोट की चौड़ाई, फ़्लोट की ऊंचाई)
ग्राउंड ओवरले के डाइमेंशन सेट करता है. इमेज को खींचकर डाइमेंशन के हिसाब से बनाया जाएगा.
पैरामीटर
width | मीटर में चौड़ाई |
---|---|
ऊंचाई | मीटर में ऊंचाई |
Public void setDimensions (फ़्लोट विड्थ)
ग्राउंड ओवरले की चौड़ाई सेट करता है. आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को बनाए रखने के लिए, ग्राउंड ओवरले की ऊंचाई में ज़रूरत के मुताबिक बदलाव किया जाएगा.
पैरामीटर
width | मीटर में चौड़ाई |
---|
Public void setImage (BitmapDescriptor imageDescriptor)
ग्राउंड ओवरले के लिए इमेज सेट करता है. नई इमेज उतनी ही बाउंड होगी जितनी पुरानी इमेज का है.
पैरामीटर
imageDescriptor | इस ग्राउंड ओवरले के लिए इस्तेमाल करने के लिए BitmapDescriptor .
|
---|
Public void setPosition (LatLng latLng)
ऐंकर पॉइंट की जगह बदलकर, ग्राउंड ओवरले की जगह सेट करता है. इमेज की दूसरी सभी प्रॉपर्टी को सुरक्षित रखता है.
पैरामीटर
latLng | LatLng , जो ऐंकर पॉइंट रखने की नई जगह है.
|
---|
Public void setPositionFromBounds (LatLngBounds बाउंड)
दिए गए LatLngBounds
में फ़िट करके, ग्राउंड ओवरले की जगह सेट करता है. यह तरीका, ग्राउंड ओवरले की पोज़िशन तय करते समय, उसके रोटेशन (बियरिंग) को अनदेखा करेगा. हालांकि, इसकी ड्रॉइंग करते समय भी बेयरिंग का इस्तेमाल किया जाएगा.
पैरामीटर
सीमा | LatLngBounds जिसमें ग्राउंड ओवरले को रखना है
|
---|
Public void setTag (ऑब्जेक्ट टैग)
ग्राउंड ओवरले के लिए टैग सेट करता है.
इस प्रॉपर्टी का इस्तेमाल करके, किसी आर्बिट्रेरी Object
को इस ग्राउंड ओवरले के साथ जोड़ा जा सकता है.
उदाहरण के लिए, Object
में यह डेटा हो सकता है कि ग्राउंड ओवरले क्या दिखाता है. यह
एक अलग Map<GroundOverlay, Object>
को स्टोर करने से ज़्यादा आसान है. दूसरे उदाहरण के तौर पर, किसी डेटा सेट के आईडी से जुड़े String
आईडी को जोड़ा जा सकता है. Android के लिए Google Maps SDK टूल,
इस प्रॉपर्टी को न तो पढ़ता और न ही लिखता है. यह आपकी ज़िम्मेदारी है कि जब आपको इसकी ज़रूरत न हो, तब setTag(null)
को कॉल करके टैग हटा दें, ताकि आपके ऐप्लिकेशन में मेमोरी लीक न हो.
पैरामीटर
टैग | अगर यह शून्य है, तो टैग को हटा दिया जाता है. |
---|
Public void setTransparency (फ़्लोट ट्रांसपेरंसी (पारदर्शिता))
इस ग्राउंड ओवरले की पारदर्शिता सेट करता है. ज़्यादा जानकारी के लिए, इस क्लास में सबसे ऊपर मौजूद दस्तावेज़ देखें.
पैरामीटर
पारदर्शिता | [0..1] रेंज में एक फ़्लोट है, जहां 0 का मतलब है कि ग्राउंड ओवरले
ओपेक है और 1 का मतलब है कि ग्राउंड ओवरले पारदर्शी है.
|
---|
Public void setVisible (boolean visible)
इस ग्राउंड ओवरले की दृश्यता सेट करता है. न दिखने पर, ग्राउंड ओवरले नहीं बनाया जाता. हालांकि, यह अपनी सभी अन्य प्रॉपर्टी को सेव रखता है.
पैरामीटर
दिख रहा है | अगर true है, तो ग्राउंड ओवरले दिख रहा है. अगर false है, तो यह नहीं दिखेगा
|
---|
Public void setZIndex (फ़्लोट zIndex)
इस ग्राउंड ओवरले का zIndex सेट करता है. ज़्यादा जानकारी के लिए, इस क्लास में सबसे ऊपर मौजूद दस्तावेज़ देखें.
पैरामीटर
zIndex | इस ग्राउंड ओवरले का zIndex |
---|