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

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