İşaretçileri, etiketleri ve ÖY çakışmalarını yönetme

Bu sayfada, haritanıza eklediğiniz işaretçiler ile ilgi alanları veya sokak adları gibi varsayılan etiketler arasındaki çakışmaları nasıl yöneteceğiniz açıklanmaktadır.

Başlamadan önce

İşaretçi ve etiket çakışmalarını yönetmek için harita kimliği kullanmanız gerekir.

Basit mod üzerinden haritanın bit eşlem resmini kullanıyorsanız işaretçi ve etiket çakışmalarını yönetemezsiniz.

İşaretçi önceliklerini belirtme

Marker kullanın.CollisionBehavior özelliğini kullanarak bir işaretçide önceliği belirtebilirsiniz.

Aşağıdaki değerlerden birini kullanın:

  • REQUIRED - Varsayılan. Diğer işaretçiler, etiketler ve ÖY'lerle çakışan bir işaretçinin gösterilmesini gerektirir.
  • OPTIONAL_AND_HIDES_LOWER_PRIORITY: İşaretçinin gerekli bir işaretçiyle değiştirilebileceğini veya gerekli bir işaretçi tarafından çakıştırılabileceğini ya da daha yüksek önceliğe sahip bir OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçisiyle değiştirilebileceğini gösterir. zIndex işaretleri arasındaki göreceli önceliği belirlemek için OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretlerini kullanın. Daha yüksek bir zIndex değeri, daha yüksek önceliği gösterir.
  • REQUIRED_AND_HIDES_OPTIONAL - İşaretçiyle çakışan OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçilerin, etiketlerin veya önemli yerlerin gizlenmesi ve işaretçinin gösterilmesi gerekir. İşaretçi, diğer gerekli işaretçilerle çakışabilir.

Aşağıdaki kod örneğinde, yeni bir işaretçi için CollisionBehavior ayarının nasıl yapılacağı gösterilmektedir:

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