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

เลือกแพลตฟอร์ม 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