Hành vi va chạm

Chọn nền tảng: Android iOS JavaScript

Trang này hướng dẫn bạn cách kiểm soát trạng thái va chạm cho một điểm đánh dấu.

Đặt trạng thái va chạm cho điểm đánh dấu

Trạng thái va chạm kiểm soát cách một điểm đánh dấu hiển thị nếu điểm đánh dấu đó va chạm (trùng lặp) với một điểm đánh dấu khác. Cách bạn tạo điểm đánh dấu nâng cao sẽ xác định cách hoạt động của hành vi va chạm:

  • Dấu đánh dấu nâng cao được tạo bằng cách sử dụng BitmapDescriptorFactory được gọi là dấu đánh dấu bitmap. Các điểm đánh dấu này được vẽ bằng bản đồ chính.

  • Tất cả các điểm đánh dấu nâng cao khác, bao gồm cả những điểm đánh dấu được tạo bằng phương thức AdvancedMarkerOptions.iconView(), được gọi là điểm đánh dấu chế độ xem và được vẽ trên một lớp phía trên bản đồ chính.

Để đặt trạng thái va chạm, hãy đặt AdvancedMarkerOptions.collisionBehavior thành một trong những giá trị sau:

  • CollisionBehavior.REQUIRED: (mặc định) Luôn hiển thị điểm đánh dấu bất kể có xung đột hay không.
  • CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL Luôn hiển thị điểm đánh dấu bất kể có xung đột hay không, đồng thời ẩn mọi OPTIONAL_AND_HIDES_LOWER_PRIORITY điểm đánh dấu hoặc nhãn sẽ chồng chéo với điểm đánh dấu.

  • CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY Chỉ hiển thị điểm đánh dấu nếu điểm đánh dấu đó không chồng chéo với các điểm đánh dấu khác.

    • Nếu hai điểm đánh dấu bitmap chồng chéo lên nhau, thì điểm đánh dấu có zIndex cao hơn sẽ xuất hiện. Nếu các quảng cáo có cùng zIndex, thì quảng cáo có vị trí màn hình dọc thấp hơn sẽ xuất hiện. Để biết thêm thông tin về zIndex, hãy xem phần Chỉ mục z của điểm đánh dấu.

    • Nếu hai điểm đánh dấu chế độ xem chồng chéo lên nhau, thì điểm đánh dấu có zIndex cao hơn sẽ xuất hiện. Nếu các điểm đánh dấu có cùng zIndex, thì điểm đánh dấu được tạo gần nhất sẽ chồng lên mọi điểm đánh dấu được tạo trước đó.

    • Vì điểm đánh dấu khung hiển thị được vẽ trên một lớp phía trên điểm đánh dấu bitmap, nên điểm đánh dấu khung hiển thị sẽ chồng lên điểm đánh dấu bitmap. Do đó, bạn nên cố gắng sử dụng các điểm đánh dấu cùng loại để kiểm soát va chạm tốt hơn.

Ví dụ sau đây cho thấy cách đặt trạng thái va chạm cho một điểm đánh dấu:

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