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

प्लैटफ़ॉर्म चुनें: 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 दिखाया जाता है. zIndex के बारे में ज़्यादा जानकारी के लिए, मार्कर का z-इंडेक्स देखें.

    • अगर दो व्यू मार्कर ओवरलैप होते हैं, तो ज़्यादा 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 = CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL
val advancedMarkerOptions: AdvancedMarkerOptions = AdvancedMarkerOptions()
    .position(LatLng(10.0, 10.0))
    .collisionBehavior(collisionBehavior)

val marker: Marker = map.addMarker(advancedMarkerOptions) ?: error("Failed to add marker")

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(new LatLng(10.0, 10.0))
        .collisionBehavior(collisionBehavior);

Marker marker = map.addMarker(options);