मार्कर

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

मार्कर मैप पर एकल स्थानों को दर्शाते हैं. आप डिफ़ॉल्ट रंग को बदलकर या मार्कर आइकन को कस्टम चित्र से बदलकर अपने मार्कर को कस्टमाइज़ कर सकते हैं. जानकारी विंडो किसी मार्कर को अतिरिक्त संदर्भ दे सकती हैं.

कोड सैंपल

GitHub पर ApiDemos डेटा स्टोर करने की जगह में एक नमूना शामिल होता है. यह नमूना अलग-अलग मार्कर की सुविधाएं दिखाता है:

Java

• MapWithMarker: मार्कर वाला आसान मैप. मार्कर के साथ मैप जोड़ने के बारे में ट्यूटोरियल देखें.
• MarkerDemoActivity: विकल्पों और सुनने वालों समेत मैप पर मार्कर का इस्तेमाल करना

कॉटलिन

• MapWithMarker: मार्कर वाला आसान मैप. मार्कर-कार्ट की मदद से मैप जोड़ने पर ट्यूटोरियल देखें.
• MarkerDemoActivity: विकल्पों और सुनने वालों समेत मैप पर मार्कर का इस्तेमाल करना

सुविधा के बारे में जानकारी

मार्कर, मैप पर जगहों की पहचान करते हैं. डिफ़ॉल्ट मार्कर एक मानक आइकॉन का इस्तेमाल करता है, जो Google Maps के रंग-रूप से आम है. एपीआई का इस्तेमाल करके, आइकॉन का रंग, इमेज या ऐंकर पॉइंट बदला जा सकता है. मार्कर, Marker टाइप के ऑब्जेक्ट होते हैं और उन्हें मैप में GoogleMap.addMarker(markerOptions) तरीके से जोड़ा जाता है.

मार्कर को इंटरैक्टिव बनाने के लिए डिज़ाइन किया गया है. उन्हें डिफ़ॉल्ट रूप से click इवेंट मिलते हैं और अक्सर उनका इस्तेमाल इवेंट की जानकारी देने वाले के साथ किया जाता है, ताकि जानकारी विंडो दिखाई जा सकें. मार्कर की draggable प्रॉपर्टी को true पर सेट करके, उपयोगकर्ता मार्कर की जगह बदल सकता है. मार्कर को हिलाने की क्षमता को चालू करने के लिए दबाकर रखें.

डिफ़ॉल्ट रूप से, जब कोई उपयोगकर्ता मार्कर पर टैप करता है, तो मैप टूलबार मैप के सबसे नीचे दाईं ओर दिखता है. इससे उपयोगकर्ता को Google Maps मोबाइल ऐप्लिकेशन का तुरंत ऐक्सेस मिल जाता है. आप टूलबार को बंद कर सकते हैं. ज़्यादा जानकारी के लिए, कंट्रोल करने की गाइड देखें.

मार्कर के साथ आरंभ करना

Maps Live का यह एपिसोड Android के लिए Maps SDK टूल का इस्तेमाल करके, आपके मैप में मार्कर जोड़ने की बुनियादी बातों के बारे में बताता है.

कोई मार्कर जोड़ें

नीचे दिए गए उदाहरण में, मैप में मार्कर जोड़ने का तरीका दिखाया गया है. यह मार्कर निर्देशांक -33.852,151.211 (सिडनी, ऑस्ट्रेलिया) पर बनाया गया है और क्लिक करने पर 'सिडनी में मार्कर' स्ट्रिंग दिखाता है.

Java

@Override
public void onMapReady(GoogleMap googleMap) {
    // Add a marker in Sydney, Australia,
    // and move the map's camera to the same location.
    LatLng sydney = new LatLng(-33.852, 151.211);
    googleMap.addMarker(new MarkerOptions()
        .position(sydney)
        .title("Marker in Sydney"));
    googleMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
}

      

Kotlin

override fun onMapReady(googleMap: GoogleMap) {
    // Add a marker in Sydney, Australia,
    // and move the map's camera to the same location.
    val sydney = LatLng(-33.852, 151.211)
    googleMap.addMarker(
        MarkerOptions()
            .position(sydney)
            .title("Marker in Sydney")
    )
    googleMap.moveCamera(CameraUpdateFactory.newLatLng(sydney))
}

      

मार्कर के बारे में अतिरिक्त जानकारी दिखाएं

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

मार्कर के साथ डेटा संबद्ध करें

Marker.setTag() का इस्तेमाल करके, आर्बिट्ररी डेटा ऑब्जेक्ट को मार्कर से स्टोर किया जा सकता है. साथ ही, Marker.getTag() का इस्तेमाल करके, डेटा ऑब्जेक्ट को रिकवर किया जा सकता है. नीचे दिए गए नमूने से पता चलता है कि टैग का इस्तेमाल करके, किसी मार्कर पर कितनी बार क्लिक किया गया है.

Java

/**
 * A demo class that stores and retrieves data objects with each marker.
 */
public class MarkerDemoActivity extends AppCompatActivity implements
    GoogleMap.OnMarkerClickListener,
    OnMapReadyCallback {

    private final LatLng PERTH = new LatLng(-31.952854, 115.857342);
    private final LatLng SYDNEY = new LatLng(-33.87365, 151.20689);
    private final LatLng BRISBANE = new LatLng(-27.47093, 153.0235);

    private Marker markerPerth;
    private Marker markerSydney;
    private Marker markerBrisbane;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_markers);
        SupportMapFragment mapFragment =
            (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    /** Called when the map is ready. */
    @Override
    public void onMapReady(GoogleMap map) {
        // Add some markers to the map, and add a data object to each marker.
        markerPerth = map.addMarker(new MarkerOptions()
            .position(PERTH)
            .title("Perth"));
        markerPerth.setTag(0);

        markerSydney = map.addMarker(new MarkerOptions()
            .position(SYDNEY)
            .title("Sydney"));
        markerSydney.setTag(0);

        markerBrisbane = map.addMarker(new MarkerOptions()
            .position(BRISBANE)
            .title("Brisbane"));
        markerBrisbane.setTag(0);

        // Set a listener for marker click.
        map.setOnMarkerClickListener(this);
    }

    /** Called when the user clicks a marker. */
    @Override
    public boolean onMarkerClick(final Marker marker) {

        // Retrieve the data from the marker.
        Integer clickCount = (Integer) marker.getTag();

        // Check if a click count was set, then display the click count.
        if (clickCount != null) {
            clickCount = clickCount + 1;
            marker.setTag(clickCount);
            Toast.makeText(this,
                marker.getTitle() +
                    " has been clicked " + clickCount + " times.",
                Toast.LENGTH_SHORT).show();
        }

        // Return false to indicate that we have not consumed the event and that we wish
        // for the default behavior to occur (which is for the camera to move such that the
        // marker is centered and for the marker's info window to open, if it has one).
        return false;
    }
}

      

Kotlin

/**
 * A demo class that stores and retrieves data objects with each marker.
 */
class MarkerDemoActivity : AppCompatActivity(),
    OnMarkerClickListener, OnMapReadyCallback {
    private val PERTH = LatLng(-31.952854, 115.857342)
    private val SYDNEY = LatLng(-33.87365, 151.20689)
    private val BRISBANE = LatLng(-27.47093, 153.0235)

    private var markerPerth: Marker? = null
    private var markerSydney: Marker? = null
    private var markerBrisbane: Marker? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_markers)
        val mapFragment =
            supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment?
        mapFragment!!.getMapAsync(this)
    }

    /** Called when the map is ready.  */
    override fun onMapReady(map: GoogleMap) {
        // Add some markers to the map, and add a data object to each marker.
        markerPerth = map.addMarker(
            MarkerOptions()
                .position(PERTH)
                .title("Perth")
        )
        markerPerth?.tag = 0
        markerSydney = map.addMarker(
            MarkerOptions()
                .position(SYDNEY)
                .title("Sydney")
        )
        markerSydney?.tag = 0
        markerBrisbane = map.addMarker(
            MarkerOptions()
                .position(BRISBANE)
                .title("Brisbane")
        )
        markerBrisbane?.tag = 0

        // Set a listener for marker click.
        map.setOnMarkerClickListener(this)
    }

    /** Called when the user clicks a marker.  */
    override fun onMarkerClick(marker: Marker): Boolean {

        // Retrieve the data from the marker.
        val clickCount = marker.tag as? Int

        // Check if a click count was set, then display the click count.
        clickCount?.let {
            val newClickCount = it + 1
            marker.tag = newClickCount
            Toast.makeText(
                this,
                "${marker.title} has been clicked $newClickCount times.",
                Toast.LENGTH_SHORT
            ).show()
        }

        // Return false to indicate that we have not consumed the event and that we wish
        // for the default behavior to occur (which is for the camera to move such that the
        // marker is centered and for the marker's info window to open, if it has one).
        return false
    }
}

      

यहां कुछ स्थितियों के उदाहरण दिए गए हैं, जिनमें मार्कर से डेटा सेव करना और वापस लाना मददगार होता है:

• आपके ऐप्लिकेशन में अलग-अलग तरह के मार्कर हो सकते हैं और उपयोगकर्ता के क्लिक करने पर उनके साथ अलग-अलग तरह का व्यवहार किया जाना चाहिए. ऐसा करने के लिए, String टाइप करके मार्कर को सेव किया जा सकता है.
• हो सकता है कि आप किसी ऐसे सिस्टम के साथ इंटरैक्ट कर रहे हों जिसमें यूनीक रिकॉर्ड आइडेंटिफ़ायर हों, जहां मार्कर उस सिस्टम में खास रिकॉर्ड को दिखाते हैं.
• मार्कर डेटा, किसी मार्कर का z-इंडेक्स तय करते समय, इस्तेमाल किए जाने के लिए प्राथमिकता दिखा सकता है.

खींचने और छोड़ने के लिए मार्कर बनाएं

मार्कर को मैप पर जोड़ने के बाद, उसकी जगह बदली जा सकती है. हालांकि, ऐसा तब तक होता है, जब तक उसकी draggable प्रॉपर्टी true पर सेट रहती है. खींचने के लिए मार्कर को दबाकर रखें. जब आप स्क्रीन से अपनी उंगली निकालेंगे, तो मार्कर उसकी स्थिति पर बना रहेगा.

मार्कर डिफ़ॉल्ट रूप से खींचे और नहीं खींचे जा सकते. आपको मार्कर को मैप पर जोड़ने से पहले उसे MarkerOptions.draggable(boolean) के साथ या ड्रैग करने लायक बनाने के लिए सेट करना होगा या Marker.setDraggable(boolean) को मैप पर जोड़ने के बाद सेट करना होगा. आप मार्कर पर ड्रैग इवेंट सुन सकते हैं, जैसा कि मार्कर ड्रैग इवेंट में बताया गया है.

नीचे दिया गया स्निपेट पर्थ, ऑस्ट्रेलिया में खींचने लायक एक मार्कर जोड़ता है.

Java

final LatLng perthLocation = new LatLng(-31.90, 115.86);
Marker perth = map.addMarker(
    new MarkerOptions()
        .position(perthLocation)
        .draggable(true));

      

Kotlin

val perthLocation = LatLng(-31.90, 115.86)
val perth = map.addMarker(
    MarkerOptions()
        .position(perthLocation)
        .draggable(true)
)

      

मार्कर को पसंद के मुताबिक बनाएं

इस वीडियो में, मैप पर जगहों को विज़ुअलाइज़ करने के लिए मार्कर का इस्तेमाल करने के तरीके दिखाए गए हैं.

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

मार्कर इन प्रॉपर्टी की मदद से पसंद के मुताबिक बनाए जा सकते हैं:

रैंक (ज़रूरी)

मैप पर मार्कर की जगह के लिए LatLng वैल्यू. Marker ऑब्जेक्ट के लिए, यह सिर्फ़ एक ज़रूरी प्रॉपर्टी है.

एंकर

इमेज पर मौजूद पॉइंट, जिसे मार्कर की LatLng स्थिति में रखा जाएगा. यह डिफ़ॉल्ट रूप से, इमेज के निचले हिस्से के बीच में होता है.

ऐल्फ़ा वर्शन

मार्कर की अपारदर्शिता को सेट करता है. डिफ़ॉल्ट वैल्यू 1.0 है.

टाइटल

ऐसा स्ट्रिंग जो जानकारी विंडो में तब दिखता है, जब उपयोगकर्ता मार्कर पर टैप करता है.

स्निपेट

अतिरिक्त टेक्स्ट, जो शीर्षक के नीचे दिखाया जाता है.

आइकॉन

एक बिट मैप जो डिफ़ॉल्ट मार्कर इमेज की जगह पर दिखाया जाता है.

खींचने और छोड़ने लायक

अगर आप उपयोगकर्ता को मार्कर हिलाने की अनुमति देना चाहते हैं, तो true पर सेट करें. false पर डिफ़ॉल्ट.

दिख रहा है

मार्कर को अदृश्य करने के लिए false पर सेट करें. डिफ़ॉल्ट सेटिंग true.

फ़्लैट या बिलबोर्ड ओरिएंटेशन

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

घुमाएं

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

नीचे दिया गया स्निपेट, डिफ़ॉल्ट आइकॉन वाला एक आसान मार्कर बनाता है.

Java

final LatLng melbourneLocation = new LatLng(-37.813, 144.962);
Marker melbourne = map.addMarker(
    new MarkerOptions()
        .position(melbourneLocation));

      

Kotlin

val melbourneLocation = LatLng(-37.813, 144.962)
val melbourne = map.addMarker(
    MarkerOptions()
        .position(melbourneLocation)
)

      

मार्कर के रंग को पसंद के मुताबिक बनाएं

icon() विधि में BitmapDescriptor ऑब्जेक्ट पास करके डिफ़ॉल्ट मार्कर इमेज का रंग कस्टमाइज़ किया जा सकता है. BitmapDescriptorFactory ऑब्जेक्ट में, पहले से तय रंगों का इस्तेमाल किया जा सकता है या BitmapDescriptorFactory.defaultMarker(float hue) तरीके से कस्टम मार्कर रंग सेट किया जा सकता है. रंग 0 और 360 के बीच का मान होता है, जो कलर व्हील पर मौजूद बिंदुओं को दिखाता है.

Java

final LatLng melbourneLocation = new LatLng(-37.813, 144.962);
Marker melbourne = map.addMarker(
    new MarkerOptions()
        .position(melbourneLocation)
        .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE)));

      

Kotlin

val melbourneLocation = LatLng(-37.813, 144.962)
val melbourne = map.addMarker(
    MarkerOptions()
        .position(melbourneLocation)
        .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))
)

      

मार्कर की अपारदर्शिता को पसंद के मुताबिक बनाएं

मार्कर के विकल्प को चुना जा सकता है. ऐल्फ़ा को 0.0 और 1.0 के बीच एक फ़्लोट के रूप में बताया जाना चाहिए, जहां 0 पूरी तरह से पारदर्शी है और 1 पूरी तरह से अपारदर्शी है.

Java

final LatLng melbourneLocation = new LatLng(-37.813, 144.962);
Marker melbourne = map.addMarker(new MarkerOptions()
    .position(melbourneLocation)
    .alpha(0.7f));

      

Kotlin

val melbourneLocation = LatLng(-37.813, 144.962)
val melbourne = map.addMarker(
    MarkerOptions()
        .position(melbourneLocation)
        .alpha(0.7f)
)

      

मार्कर इमेज को पसंद के मुताबिक बनाएं

आप डिफ़ॉल्ट मार्कर इमेज को कस्टम मार्कर इमेज से बदल सकते हैं. इसे अक्सर आइकॉन कहा जाता है. कस्टम आइकॉन को हमेशा BitmapDescriptor के तौर पर सेट किया जाता है. साथ ही, इन्हें BitmapDescriptorFactory क्लास में दिए गए तरीकों में से किसी एक का इस्तेमाल करके तय किया जाता है.

fromAsset(String assetName)

एसेट डायरेक्ट्री में बिटमैप इमेज के नाम का इस्तेमाल करके, कस्टम मार्कर बनाता है.

fromBitmap(Bitmap image)

बिट मैप इमेज से कस्टम मार्कर बनाता है.

fromFile(String fileName)

डिवाइस के स्टोरेज में मौजूद Bitmap इमेज फ़ाइल के नाम का इस्तेमाल करके, पसंद के मुताबिक आइकॉन बनाता है.

fromPath(String absolutePath)

बिट मैप इमेज के पूरे फ़ाइल पाथ से कस्टम मार्कर बनाता है.

fromResource(int resourceId)

बिट मैप इमेज के रिसॉर्स आईडी का इस्तेमाल करके, कस्टम मार्कर बनाता है.

नीचे दिया गया स्निपेट, कस्टम आइकॉन वाला मार्कर बनाता है.

Java

final LatLng melbourneLocation = new LatLng(-37.813, 144.962);
Marker melbourne = map.addMarker(
    new MarkerOptions()
        .position(melbourneLocation)
        .title("Melbourne")
        .snippet("Population: 4,137,400")
        .icon(BitmapDescriptorFactory.fromResource(R.drawable.arrow)));

      

Kotlin

val melbourneLocation = LatLng(-37.813, 144.962)
val melbourne = map.addMarker(
    MarkerOptions()
        .position(melbourneLocation)
        .title("Melbourne")
        .snippet("Population: 4,137,400")
        .icon(BitmapDescriptorFactory.fromResource(R.drawable.arrow))
)

      

मार्कर को फ़्लैट करें

आम तौर पर, मार्कर आइकॉन स्क्रीन के हिसाब से बनाए जाते हैं. मैप को घुमाने, तिरछा करने या ज़ूम करने से मार्कर का ओरिएंटेशन नहीं बदलता. आप मार्कर का ओरिएंटेशन पृथ्वी के ऊपर समतल रखने के लिए सेट कर सकते हैं. इस तरह से मुड़े हुए मार्कर, मैप को घुमाने पर घुमाएंगे और जब मैप को झुकाया जाएगा, तो उसका नज़रिया बदल जाएगा. मैप को ज़ूम इन या ज़ूम आउट करने पर फ़्लैट मार्कर का आकार बना रहेगा.

मार्कर का ओरिएंटेशन बदलने के लिए, मार्कर की flat प्रॉपर्टी को true पर सेट करें.

Java

final LatLng perthLocation = new LatLng(-31.90, 115.86);
Marker perth = map.addMarker(
    new MarkerOptions()
        .position(perthLocation)
        .flat(true));

      

Kotlin

val perthLocation = LatLng(-31.90, 115.86)
val perth = map.addMarker(
    MarkerOptions()
        .position(perthLocation)
        .flat(true)
)

      

मार्कर को घुमाएं

आप मार्कर को इसके Marker के साथ ऐंकर पॉइंट के आस-पास घुमा सकते हैं.setRotation() तरीका. घुमाव को घड़ी की दिशा में डिफ़ॉल्ट स्थिति से मापा जाता है. मैप पर मार्कर समतल होने पर, डिफ़ॉल्ट स्थिति उत्तर होता है. जब मार्कर समतल नहीं होता है, तो डिफ़ॉल्ट स्थिति ऊपर की ओर संकेत करती है और घुमाव ऐसा होता है कि मार्कर हमेशा कैमरे की ओर होता है.

नीचे दिया गया उदाहरण मार्कर को 90° घुमाता है. ऐंकर पॉइंट को 0.5,0.5 पर सेट करने से, मार्कर उसके बेस के बजाय, बीच में घूमता है.

Java

final LatLng perthLocation = new LatLng(-31.90, 115.86);
Marker perth = map.addMarker(
    new MarkerOptions()
        .position(perthLocation)
        .anchor(0.5f,0.5f)
        .rotation(90.0f));

      

Kotlin

val perthLocation = LatLng(-31.90, 115.86)
val perth = map.addMarker(
    MarkerOptions()
        .position(perthLocation)
        .anchor(0.5f, 0.5f)
        .rotation(90.0f)
)

      

मार्कर z-इंडेक्स

z-इंडेक्स, मैप पर अन्य मार्कर की तुलना में, इस मार्कर के स्टैक क्रम को बताता है. हाई z-इंडेक्स वाला मार्कर, z-इंडेक्स वाले उन मार्कर के ऊपर बनाया जाता है. z-इंडेक्स का डिफ़ॉल्ट मान 0 है.

यहां दिए गए कोड स्निपेट की तरह, MarkerOptions.zIndex() पर कॉल करके, मार्कर के विकल्प ऑब्जेक्ट पर z-इंडेक्स सेट करें:

Java

map.addMarker(new MarkerOptions()
    .position(new LatLng(10, 10))
    .title("Marker z1")
    .zIndex(1.0f));

      

Kotlin

map.addMarker(
    MarkerOptions()
        .position(LatLng(10.0, 10.0))
        .title("Marker z1")
        .zIndex(1.0f)
)

      

Marker.getZIndex() को कॉल करके, आप मार्कर की z-इंडेक्स ऐक्सेस कर सकते हैं और Marker.setZIndex() पर कॉल करके इसे बदल सकते हैं.

दूसरे ओवरले के z-इंडेक्स पर ध्यान दिए बिना मार्कर को हमेशा टाइल की लेयर और अन्य गैर-मार्कर ओवरले (ग्राउंड ओवरले, पॉलीलाइन, पॉलीगॉन, और अन्य आकार) के ऊपर बनाया जाता है. मार्कर को अन्य ओवरले की तुलना में अलग-अलग z-इंडेक्स समूह में माना जाता है.

क्लिक इवेंट पर z-इंडेक्स के असर के बारे में नीचे पढ़ें.

मार्कर इवेंट हैंडल करना

मैप एपीआई से आप मार्कर इवेंट सुन सकते हैं और उनके जवाब दे सकते हैं. इन इवेंट को सुनने के लिए, आपको GoogleMap ऑब्जेक्ट पर उससे जुड़े पहचानकर्ता को सेट करना होगा जिससे मार्कर जुड़े हों. जब इवेंट, मैप पर किसी एक मार्कर पर होता है, तो लिसनर के कॉलबैक को उससे जुड़े Marker ऑब्जेक्ट के साथ शुरू किया जाता है जो पैरामीटर के तौर पर पास किए जाते हैं. इस Marker ऑब्जेक्ट की तुलना, Marker ऑब्जेक्ट के अपने रेफ़रंस से करने के लिए, आपको == के बजाय equals() का इस्तेमाल करना होगा.

यहां दिए गए इवेंट सुने जा सकते हैं:

• मार्कर क्लिक इवेंट
• मार्कर ड्रैग इवेंट
• जानकारी विंडो के क्लिक इवेंट

मार्कर क्लिक इवेंट

मार्कर पर क्लिक इवेंट सुनने के लिए OnMarkerClickListener का इस्तेमाल किया जा सकता है. मैप पर इस पहचानकर्ता को सेट करने के लिए, GoogleMap.setOnMarkerClickListener(OnMarkerClickListener) पर कॉल करें. जब कोई उपयोगकर्ता किसी मार्कर पर क्लिक करता है, तो onMarkerClick(Marker) को कॉल किया जाएगा और मार्कर को एक आर्ग्युमेंट के रूप में पास किया जाएगा. यह तरीका एक बूलियन रिटर्न करता है जिससे यह पता चलता है कि आपने इवेंट का इस्तेमाल किया है या नहीं. इसका मतलब है कि आप डिफ़ॉल्ट तरीका देखना चाहते हैं. अगर यह false दिखाता है, तो आपके कस्टम व्यवहार के अलावा डिफ़ॉल्ट तरीका भी लागू होगा. मार्कर क्लिक इवेंट का डिफ़ॉल्ट व्यवहार उसकी जानकारी विंडो (उपलब्ध होने पर) दिखाना और कैमरे को इस तरह से खिसकाना है कि मार्कर मैप पर केंद्रित हो.

क्लिक इवेंट पर z-इंडेक्स का असर:

• जब कोई उपयोगकर्ता मार्कर के क्लस्टर पर क्लिक करता है, तो सबसे ज़्यादा z-इंडेक्स वाले मार्कर के लिए क्लिक इवेंट ट्रिगर होता है.
• हर क्लिक ज़्यादा से ज़्यादा एक इवेंट ट्रिगर करता है. दूसरे शब्दों में, क्लिक को निचले z-इंडेक्स मानों वाले मार्कर या अन्य ओवरले के पास नहीं भेजा जाता है.
• मार्कर के क्लस्टर पर क्लिक करने से, बाद में होने वाले क्लिक क्लस्टर में एक-एक करके आ जाते हैं, और हर क्लिक को अलग-अलग चुन लिया जाता है. साइकल के क्रम को पहले z-इंडेक्स को प्राथमिकता दी जाती है. इसके बाद, क्लिक पॉइंट के नज़दीक रखा जाता है.
• अगर उपयोगकर्ता, क्लस्टर की निकटता से बाहर क्लिक करता है, तो API क्लस्टर की फिर से गणना करता है और क्लिक चक्र की स्थिति रीसेट करता है, ताकि वह शुरुआत से शुरू हो.
• क्लिक इवेंट, चक्र को फिर से शुरू करने से पहले मार्कर क्लस्टर से दूसरे आकार और ओवरले में आ जाता है.
• दूसरे ओवरले के z-इंडेक्स पर ध्यान दिए बिना, मार्कर को अन्य ओवरले या आकारों (पॉलीलाइन, पॉलीगॉन, सर्कल, और/या ग्राउंड ओवरले) की तुलना में अलग-अलग z-इंडेक्स ग्रुप में माना जाता है. अगर एक से ज़्यादा मार्कर, ओवरले या आकार एक-दूसरे के ऊपर रखे जाते हैं, तो क्लिक इवेंट को पहले मार्कर के क्लस्टर में साइकल किया जाता है. इसके बाद, उनके z-इंडेक्स वैल्यू के आधार पर, क्लिक किए जा सकने वाले दूसरे ओवरले या आकार को ट्रिगर किया जाता है.

मार्कर ड्रैग इवेंट

किसी मार्कर पर ड्रैग इवेंट सुनने के लिए, आप OnMarkerDragListener का इस्तेमाल कर सकते हैं. मैप पर इस पहचानकर्ता को सेट करने के लिए, GoogleMap.setOnMarkerDragListener पर कॉल करें. मार्कर को खींचने के लिए, उपयोगकर्ता को उसे मार्कर पर दबाकर रखना होगा. जब उपयोगकर्ता स्क्रीन से अपनी उंगली हटा लेता है, तो मार्कर उस स्थिति पर ही रहेगा. जब किसी मार्कर को खींचा जाता है, तो शुरुआत में onMarkerDragStart(Marker) को कॉल किया जाता है. जब मार्कर को खींचा जा रहा होता है, तो लगातार onMarkerDrag(Marker) कॉल किया जाता है. ड्रैग के आखिर में onMarkerDragEnd(Marker) को कॉल किया जाता है. आप Marker.getPosition() को कॉल करके किसी भी समय मार्कर की स्थिति पा सकते हैं.

ध्यान दें: डिफ़ॉल्ट रूप से, मार्कर को खींचा नहीं जा सकता. मार्कर को खींचने लायक बनाने के लिए इस तरह सेट किया जाना चाहिए कि वह उपयोगकर्ता को खींचकर ले जाए. ऐसा करने के लिए, मैप पर जोड़ने से पहले MarkerOptions.draggable(boolean) के साथ मैप किया जा सकता है या मैप में जोड़ने के बाद Marker.setDraggable(boolean).