ควบคุมลักษณะการชน

เลือกแพลตฟอร์ม: Android iOS JavaScript

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

ตั้งค่าลักษณะการทำงานเมื่อเครื่องหมายทับซ้อนกัน

หากต้องการตั้งค่าลักษณะการทำงานเมื่อเกิดการชนกัน ให้ตั้งค่า GMSAdvancedMarker.collisionBehavior เป็น ค่าใดค่าหนึ่งต่อไปนี้

  • GMSCollisionBehaviorRequired (ค่าเริ่มต้น): แสดงเครื่องหมายเสมอ ไม่ว่าจะมีการทับซ้อนกันหรือไม่ก็ตาม นี่คือลักษณะการทำงานเริ่มต้น ไม่มีผลต่อ การแสดงเครื่องหมายหรือป้ายกำกับแผนที่ฐานอื่นๆ

  • GMSCollisionBehaviorOptionalAndHidesLowerPriority: แสดงเครื่องหมายเฉพาะในกรณีที่ ไม่ทับซ้อนกับเครื่องหมายอื่นๆ หากเครื่องหมาย 2 รายการประเภทนี้ซ้อนทับกัน ระบบจะแสดงเครื่องหมายที่มี zIndexสูงกว่า หากมี zIndex เดียวกัน ระบบจะแสดงรายการที่มีตำแหน่งหน้าจอแนวตั้งต่ำกว่า

  • GMSCollisionBehaviorRequiredAndHidesOptional: แสดงเครื่องหมายเสมอ ไม่ว่าจะมีการทับซ้อนกันหรือไม่ก็ตาม และซ่อนGMSCollisionBehaviorOptionalAndHidesLowerPriority แสดงเครื่องหมายเฉพาะในกรณีที่ ไม่ทับซ้อนกับเครื่องหมายอื่นๆ ไม่มี GMSCollisionBehaviorRequired หากเครื่องหมาย 2 รายการประเภทนี้ทับซ้อนกัน ระบบจะแสดงเครื่องหมายที่มี zIndex สูงกว่า ไม่มีการกำหนดกฎการชนกันสำหรับเครื่องหมายที่มีzIndex เดียวกัน

Swift

// Defines a marker to always display and hide any marker or label overlay with this marker in the base map
marker.collisionBehavior = .requiredAndHidesOptional

Objective-C

// Defines a marker to always display and hide any marker or label overlay with this marker in the base map
marker.collisionBehavior = GMSCollisionBehaviorRequiredAndHidesOptional