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

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