ลักษณะการชนกัน

เลือกแพลตฟอร์ม แอนดรอยด์ iOS JavaScript

หน้านี้จะแสดงวิธีควบคุมลักษณะการชนกันของเครื่องหมาย

ตั้งค่าลักษณะการชนกันของเครื่องหมาย

ลักษณะการชนกันจะควบคุมลักษณะที่เครื่องหมายแสดงหากชนกัน (ซ้อนทับกัน) กับเครื่องหมายอื่น วิธีสร้างเครื่องหมายขั้นสูง จะกำหนดลักษณะการทำงานของการซ้อนทับ ดังนี้

• เครื่องหมายขั้นสูงที่สร้างโดยใช้ BitmapDescriptorFactory จะเรียกว่าเครื่องหมายบิตแมป เครื่องหมายเหล่านี้วาดโดยแผนที่หลัก

• เครื่องหมายขั้นสูงอื่นๆ ทั้งหมด รวมถึงเครื่องหมายที่สร้างโดย โดยใช้เมธอด AdvancedMarkerOptions.iconView() มีชื่อเรียกว่า เครื่องหมายดูและถูกวาดบนเลเยอร์เหนือแผนที่หลัก

หมายเหตุ: คุณควรสร้างเครื่องหมายขั้นสูงทั้งหมดเป็นประเภทเดียวกันเพื่อให้ลักษณะการชนทำงานได้อย่างดีที่สุด กล่าวคือ หากคุณใช้เครื่องหมายมุมมองกับเครื่องหมายหนึ่ง คุณก็ควรใช้เครื่องหมายมุมมองกับเครื่องหมายทั้งหมด

หากต้องการตั้งค่าลักษณะการชน ให้ตั้งค่า AdvancedMarkerOptions.collisionBehavior เป็นค่าใดค่าหนึ่งต่อไปนี้

• CollisionBehavior.REQUIRED: (ค่าเริ่มต้น) แสดงเครื่องหมายเสมอไม่ว่าจะมีการชนกันหรือไม่ก็ตาม
• CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL แสดงเครื่องหมายเสมอ โดยไม่คำนึงถึงการชน และซ่อน OPTIONAL_AND_HIDES_LOWER_PRIORITY เครื่องหมายหรือป้ายกำกับที่จะเหลื่อมซ้อนกับเครื่องหมาย

• CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY แสดงเครื่องหมายก็ต่อเมื่อไม่ทับซ้อนกับเครื่องหมายอื่นๆ

  • หากเครื่องหมาย bitmap 2 รายการซ้อนทับกัน ระบบจะแสดงเครื่องหมายที่มี zIndex สูงกว่า หากมี zIndex เดียวกัน ระบบจะแสดงรายการที่มีตำแหน่งแนวตั้งของหน้าจอต่ำกว่า ดูข้อมูลเพิ่มเติมเกี่ยวกับ zIndex ได้ที่เครื่องหมาย z-index

  • หากเครื่องหมายมุมมอง 2 รายการซ้อนทับกัน ระบบจะแสดงเครื่องหมายที่มี zIndex สูงกว่า หากมี zIndex เหมือนกัน เครื่องหมายที่สร้างล่าสุด ทับซ้อนกับเครื่องหมายที่สร้างขึ้นก่อนหน้า

  • เนื่องจากระบบจะวาดเครื่องหมายมุมมองในเลเยอร์เหนือเครื่องหมายบิตแมป เครื่องหมายมุมมองจึงซ้อนทับเครื่องหมายบิตแมป ดังนั้น คุณควรลอง เพื่อใช้เครื่องหมายประเภทเดียวกัน เพื่อการควบคุมการชนที่ดีขึ้น

ตัวอย่างต่อไปนี้แสดงลักษณะการชนกันของเครื่องหมาย

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