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

Bu sayfada, haritanıza eklediğiniz işaretçiler ile önemli yerler 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ği, işaretçide önceliği belirtmek için kullanılır.

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 işaretçinin üzerine başka bir işaretçi yerleştirilebileceğini ya da işaretçinin daha yüksek önceliğe sahip bir OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçiyle değiştirilebileceğini gösterir. zIndex işaretleri arasındaki göreceli önceliği belirlemek için OPTIONAL_AND_HIDES_LOWER_PRIORITY simgesini kullanın. Daha yüksek bir zIndex değeri, daha yüksek önceliği gösterir.
  • REQUIRED_AND_HIDES_OPTIONAL - İşaretçiyle çakışan tüm OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçilerin, etiketlerin veya ÖY'lerin 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ı 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);