Hành vi va chạm

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

Trang này cho bạn biết cách kiểm soát hành vi va chạm đối với một điểm đánh dấu.

Thiết lập trạng thái va chạm cho một điểm đánh dấu

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

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

  • 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ởi sử dụng phương thức AdvancedMarkerOptions.iconView(), được gọi là xem điểm đánh dấu và được vẽ trên một lớp phía trên bản đồ chính.

Để thiết lập hành vi xung đột, hãy đặt AdvancedMarkerOptions.collisionBehavior thành một trong các lệnh sau:

  • CollisionBehavior.REQUIRED: (mặc định) Luôn hiển thị điểm đánh dấu bất kể va chạm.
  • CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL Luôn hiển thị điểm đánh dấu bất kể xung đột và ẩn mọi OPTIONAL_AND_HIDES_LOWER_PRIORITY điểm đánh dấu hoặc nhãn trùng với điểm đánh dấu.

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

    • Nếu 2 điểm đánh dấu bitmap trùng nhau, thì điểm có zIndex cao hơn sẽ là hiển thị. Nếu các thiết bị đó có cùng zIndex, tức là thiết bị có màn hình dọc phía dưới vị trí được hiển thị. Để biết thêm thông tin về zIndex, hãy xem phần Điểm đánh dấu chỉ mục z.

    • Nếu hai điểm đánh dấu chế độ xem trùng nhau, thì điểm đánh dấu có zIndex cao hơn sẽ là hiển thị. Nếu chúng có cùng zIndex, điểm đánh dấu được tạo gần đây nhất trùng lặp với mọi điểm đánh dấu được tạo trước đó.

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

Ví dụ sau đây minh hoạ việc thiết lập hành vi xung đột 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 = AdvancedMarkerOptions.CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL
val advancedMarkerOptions: AdvancedMarkerOptions = AdvancedMarkerOptions()
    .position(latLng)
    .collisionBehavior(collisionBehavior)

val marker: Marker = map.addMarker(advancedMarkerOptions)

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(latLng)
            .collisionBehavior(collisionBehavior);

Marker marker = map.addMarker(options);