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

Bu sayfada, haritanıza eklediğiniz işaretçiler ile önemli yerler (ÖY) veya sokak adları gibi varsayılan etiketler arasındaki çakışmaları nasıl yöneteceğiniz gösterilmektedir.

Başlamadan önce

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

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

İşaretçi önceliklerini belirtme

Marker kullanın.CollisionBehavior özelliğini kullanın.

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, zorunlu bir işaretçiyle değiştirilebileceğini veya üst üste binebileceğini ya da daha yüksek öncelikli bir OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçisiyle değiştirilebileceğini gösterir. OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretleri arasındaki göreceli önceliği belirlemek için zIndex kullanın. Daha yüksek bir zIndex değeri, daha yüksek önceliği gösterir.
  • REQUIRED_AND_HIDES_OPTIONAL: Bir işaretçinin gösterilmesini gerektirir. Bu sırada, işaretçiyle çakışan tüm OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçiler, etiketler veya ÖY'ler gizlenir. İş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ı 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);