मार्कर, लेबल, और पीओआई की टकराव मैनेज करना

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

शुरू करने से पहले

मार्कर और लेबल के टकराव को मैनेज करने के लिए, आपको map id का इस्तेमाल करना होगा.

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

मार्कर की प्राथमिकताएं तय करना

Marker का इस्तेमाल करें.CollisionBehavior प्रॉपर्टी का इस्तेमाल करके, मार्कर की प्राथमिकता तय करें.

इनमें से किसी एक वैल्यू का इस्तेमाल करें:

  • REQUIRED - डिफ़ॉल्ट. इसमें ऐसे मार्कर को दिखाना ज़रूरी है जो अन्य मार्कर, लेबल, और दिलचस्पी की जगहों के साथ ओवरलैप करता हो.
  • OPTIONAL_AND_HIDES_LOWER_PRIORITY - इससे पता चलता है कि मार्कर को किसी ज़रूरी मार्कर से बदला जा सकता है या वह उसके साथ ओवरलैप हो सकता है. इसके अलावा, इसे ज़्यादा प्राथमिकता वाले OPTIONAL_AND_HIDES_LOWER_PRIORITY मार्कर से भी बदला जा सकता है. OPTIONAL_AND_HIDES_LOWER_PRIORITY मार्कर के बीच प्राथमिकता तय करने के लिए, zIndex का इस्तेमाल करें. zIndex की ज़्यादा वैल्यू का मतलब है कि उसे ज़्यादा प्राथमिकता दी गई है.
  • REQUIRED_AND_HIDES_OPTIONAL - किसी भी OPTIONAL_AND_HIDES_LOWER_PRIORITY मार्कर, लेबल या दिलचस्पी की जगह (पीओआई) को छिपाते समय, मार्कर को दिखाना ज़रूरी है. ऐसा तब करना होता है, जब ये मार्कर, लेबल या पीओआई, मार्कर के साथ ओवरलैप करते हों. ऐसा हो सकता है कि मार्कर, ज़रूरी बताए गए अन्य मार्कर के साथ ओवरलैप हो रहा हो.

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

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