मैप की नई स्टाइल, जल्द ही Google Maps Platform पर उपलब्ध होगी. मैप की स्टाइल में हुए इस अपडेट में, नया डिफ़ॉल्ट कलर पटल जोड़ा गया है. साथ ही, मैप के अनुभवों और उसे इस्तेमाल करने के तरीके में सुधार भी किए गए हैं. मार्च 2025 में, सभी मैप स्टाइल अपने-आप अपडेट हो जाएंगी. उपलब्धता और जल्दी ऑप्ट इन करने के तरीके के बारे में ज़्यादा जानकारी के लिए, Google Maps Platform के लिए नई मैप स्टाइल देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

रैंक

ग्राउंड ओवरले की जगह बताने के दो तरीके हैं:

जगह का इस्तेमाल: आपको ग्राउंड ओवरले की एक इमेज देनी होगी. इस इमेज में 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	setImage(BitmapDescriptor imageDescriptor) ग्राउंड ओवरले के लिए इमेज सेट करता है.
void	setPosition(LatLng latLng) ऐंकर पॉइंट की जगह बदलकर, ग्राउंड ओवरले की जगह सेट करता है.
void	setPositionFromBounds(LatLngBounds बाउंड) दिए गए `LatLngBounds` में फ़िट करके, ग्राउंड ओवरले की जगह सेट करता है.
void	setTag(ऑब्जेक्ट टैग) ग्राउंड ओवरले के लिए टैग सेट करता है.
void	setTransparency(फ़्लोट ट्रांसपेरंसी (पारदर्शिता) इस ग्राउंड ओवरले की पारदर्शिता सेट करता है.
void	setVisible(बूलियन विज़ुअल) इस ग्राउंड ओवरले की दृश्यता सेट करता है.
void	setZIndex(फ़्लोट zIndex) इस ग्राउंड ओवरले का zIndex सेट करता है.

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

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

boolean	इसके बराबर है(ऑब्जेक्ट आर्ग्युमेंट0)
फ़ाइनल क्लास<?>	getClass()
int	hashCode()
फ़ाइनल शून्य	notify()
फ़ाइनल शून्य	notifyAll()
String	toString()
फ़ाइनल शून्य	wait(long org0, int arch1)
फ़ाइनल शून्य	wait(long org0)
फ़ाइनल शून्य	wait()

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

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

यह टेस्ट करता है कि यह 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