टकराव का व्यवहार

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

यह पेज आपको किसी मार्कर के लिए टकराव के व्यवहार को कंट्रोल करने का तरीका बताता है.

मार्कर के लिए टकराव का व्यवहार सेट करना

टकराने के व्यवहार से यह तय होता है कि अगर कोई मार्कर, किसी दूसरे मार्कर के साथ टकराने (ओवरलैप) होता है, तो उसे कैसे दिखाया जाता है. बेहतर मार्कर बनाने का तरीका तय करता है कि टकराव का व्यवहार कैसे काम करता है:

  • BitmapDescriptorFactory का इस्तेमाल करके बनाए गए बेहतर मार्कर को बिटमैप मार्कर कहा जाता है. ये मार्कर मुख्य मैप से खींचे जाते हैं.

  • अन्य सभी बेहतर मार्कर, जिनमें AdvancedMarkerOptions.iconView() तरीके का इस्तेमाल करके बनाए गए मार्कर भी शामिल हैं, को व्यू मार्कर कहा जाता है. इन्हें मुख्य मैप के ऊपर की किसी लेयर पर बनाया जाता है.

टकराव के व्यवहार को सेट करने के लिए, AdvancedMarkerOptions.collisionBehavior को इनमें से किसी एक पर सेट करें:

  • CollisionBehavior.REQUIRED: (डिफ़ॉल्ट) टकराने पर ध्यान दिए बिना मार्कर हमेशा दिखाएं.
  • CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL मार्कर को हमेशा दिखाएं, चाहे उनके बीच टकराव होता हो या नहीं. साथ ही, उन OPTIONAL_AND_HIDES_LOWER_PRIORITY मार्कर या लेबल को छिपा दें जो मार्कर को ओवरलैप करते हैं.
  • CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY मार्कर को सिर्फ़ तब दिखाएं, जब वह अन्य मार्कर के साथ ओवरलैप न हो.

    • अगर दो बिटमैप मार्कर ओवरलैप होते हैं, तो ज़्यादा zIndex वाला मार्कर दिखाया जाता है. अगर दोनों का zIndex एक जैसा है, तो नीचे वाली वर्टिकल स्क्रीन वाली स्क्रीन दिखेगी. zIndex के बारे में ज़्यादा जानकारी के लिए, मार्कर z-index देखें.

    • अगर दो व्यू मार्कर ओवरलैप होते हैं, तो ज़्यादा zIndex वाला मार्कर दिखाया जाता है. अगर उनके पास एक ही zIndex है, तो सबसे आखिर में बनाया गया मार्कर, इससे पहले बनाए गए सभी मार्कर को ओवरलैप कर देता है.

    • व्यू मार्कर, बिटमैप मार्कर के ऊपर बनी किसी लेयर पर बनाए जाते हैं. इसलिए, व्यू मार्कर, बिटमैप मार्कर को ओवरलैप करते हैं. इसलिए, टकराव को बेहतर ढंग से कंट्रोल करने के लिए, एक ही तरह के मार्कर इस्तेमाल करने चाहिए.

नीचे दिए गए उदाहरण में, मार्कर के लिए टकराव का व्यवहार सेट करने का तरीका दिखाया गया है:

Kotlin

// Collision behavior can only be changed in the AdvancedMarkerOptions object.
// Changes to collision behavior after a marker has been created are not possible
val collisionBehavior: Int = AdvancedMarkerOptions.CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL
val advancedMarkerOptions: AdvancedMarkerOptions = AdvancedMarkerOptions()
    .position(latLng)
    .collisionBehavior(collisionBehavior)
val marker: Marker = map.addMarker(advancedMarkerOptions)

Java

// Collision behavior can only be changed in the AdvancedMarkerOptions object.
// Changes to collision behavior after a marker has been created are not possible
int collisionBehavior = AdvancedMarkerOptions.CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL;
AdvancedMarkerOptions options =
        new AdvancedMarkerOptions()
            .position(latLng)
            .collisionBehavior(collisionBehavior);
Marker marker = map.addMarker(options);