Mengelola konflik penanda, label, dan POI

Halaman ini menunjukkan cara menangani perilaku saat tumpang tindih antara penanda yang Anda tambahkan ke peta dan label default, seperti lokasi menarik (POI) atau nama jalan.

Sebelum memulai

Untuk menangani tumpang tindih penanda dan label, Anda harus menggunakan ID peta.

Jika menggunakan gambar bitmap peta pada mode ringan, Anda tidak dapat menangani tumpang tindih penanda dan label.

Menentukan prioritas penanda

Gunakan properti Marker.CollisionBehavior untuk menentukan prioritas pada penanda.

Gunakan salah satu nilai berikut:

  • REQUIRED - Default. Mewajibkan ditampilkannya penanda ketika tumpang tindih dengan penanda, label, dan POI lain.
  • OPTIONAL_AND_HIDES_LOWER_PRIORITY - Menunjukkan bahwa penanda dapat digantikan atau ditimpa oleh penanda wajib, atau digantikan oleh penanda OPTIONAL_AND_HIDES_LOWER_PRIORITY dengan prioritas yang lebih tinggi. Gunakan zIndex untuk membantu menentukan prioritas relatif di antara beberapa penanda OPTIONAL_AND_HIDES_LOWER_PRIORITY. Nilai zIndex yang lebih tinggi menunjukkan prioritas yang lebih tinggi.
  • REQUIRED_AND_HIDES_OPTIONAL - Mewajibkan ditampilkannya penanda sekaligus menyembunyikan penanda, label, atau POI OPTIONAL_AND_HIDES_LOWER_PRIORITY lain yang tumpang tindih dengan penanda itu. Penanda dapat tumpang tindih dengan penanda wajib lain.

Contoh kode berikut menunjukkan setelan CollisionBehavior untuk penanda baru:

Kotlin



val marker = map.addMarker(
    MarkerOptions()
        .position(LatLng(10.0, 10.0))
        .zIndex(10f) // Optional.
        .collisionBehavior(Marker.CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY)
)

Java


Marker marker = map.addMarker(
    new MarkerOptions()
        .position(new LatLng(10, 10))
        .zIndex(10) // Optional.
        .collisionBehavior(Marker.CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY));