मार्कर

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

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

कोड सैंपल

GitHub पर मौजूद ApiDemos रिपॉज़िटरी में एक सैंपल शामिल है. इसमें मार्कर की अलग-अलग सुविधाओं के बारे में बताया गया है:

Kotlin

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

Java

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

परिचय

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

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

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

मार्कर का इस्तेमाल शुरू करना

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

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

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

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))
}

      

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));
}

      

मार्कर के बारे में ज़्यादा जानकारी दिखाना

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

डेटा को मार्कर से जोड़ना

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

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
    }
}

      

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;
    }
}

      

यहां कुछ ऐसे उदाहरण दिए गए हैं जिनमें मार्कर की मदद से डेटा को स्टोर और फिर से पाना फ़ायदेमंद होता है:

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

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

मैप में मार्कर जोड़ने के बाद, उसकी जगह बदली जा सकती है. हालांकि, इसके लिए ज़रूरी है कि उसकी draggable प्रॉपर्टी true पर सेट हो. मार्कर को खींचने और छोड़ने की सुविधा चालू करने के लिए, मार्कर को दबाकर रखें. स्क्रीन से उंगली हटाने पर, मार्कर उसी जगह पर रहेगा.

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

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

Kotlin

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

      

Java

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

      

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

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

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

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

पद (ज़रूरी है)

मैप पर मार्कर की पोज़िशन के लिए LatLng वैल्यू. Marker ऑब्जेक्ट के लिए, यह एकमात्र ज़रूरी प्रॉपर्टी है.

एंकर

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

ऐल्फ़ा

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

शीर्षक

मार्कर पर टैप करने पर, जानकारी वाली विंडो में दिखने वाली स्ट्रिंग.

स्निपेट

टाइटल के नीचे दिखने वाला अतिरिक्त टेक्स्ट.

आइकॉन

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

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

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

दिख रहा है

मार्कर को न दिखाने के लिए, false पर सेट करें. डिफ़ॉल्ट रूप से, यह वैल्यू true पर सेट होती है.

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

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

घुमाव

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

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

Kotlin

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

      

Java

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

      

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

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

Kotlin

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

      

Java

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

      

मार्कर की ओपैसिटी को पसंद के मुताबिक बनाना

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

Kotlin

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

      

Java

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

      

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

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

fromAsset(String assetName)

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

fromBitmap(Bitmap image)

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

fromFile(String fileName)

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

fromPath(String absolutePath)

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

fromResource(int resourceId)

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

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

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))
)

      

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)));

      

मार्कर को फ़्लैट करना

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

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

Kotlin

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

      

Java

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

      

मार्कर को घुमाना

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

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

Kotlin

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

      

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));

      

मार्कर का z-index

z-index से पता चलता है कि मैप पर मौजूद अन्य मार्कर के मुकाबले, इस मार्कर का स्टैक क्रम क्या है. ज़्यादा z-index वाला मार्कर, कम z-index वाले मार्कर के ऊपर दिखाया जाता है. z-index की डिफ़ॉल्ट वैल्यू 0 है.

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

Kotlin

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

      

Java

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

      

Marker.getZIndex() को कॉल करके, मार्कर का z-index ऐक्सेस किया जा सकता है. साथ ही, Marker.setZIndex() को कॉल करके, इसे बदला जा सकता है.

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

क्लिक इवेंट पर z-index के असर के बारे में यहां पढ़ें.

मार्कर इवेंट मैनेज करना

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

इन इवेंट को सुना जा सकता है:

• मार्कर पर क्लिक करने से जुड़े इवेंट
• मार्कर को खींचकर छोड़ने से जुड़े इवेंट
• जानकारी वाली विंडो पर क्लिक करने से जुड़े इवेंट

मार्कर पर क्लिक करने से होने वाले इवेंट

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

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

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

मार्कर को खींचकर छोड़ने से जुड़े इवेंट

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

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