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

बीटा वर्शन वाले एसडीके को बंद करने की सूचना:

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

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

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

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

मार्कर और लेबल के बीच होने वाले टकराव को मैनेज करने के लिए, आपके पास a मैप आईडी होना चाहिए.

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

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

मार्कर पर प्राथमिकता तय करने के लिए, 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);