控管衝突行為

選取平台: Android iOS JavaScript

衝突行為可控管標記互相衝突 (重疊) 時的顯示方式。

設定標記的衝突行為

如要設定衝突行為,請將 GMSAdvancedMarker.collisionBehavior 設為下列其中一種狀態:

  • GMSCollisionBehaviorRequired (預設):無論是哪種衝突,一律顯示標記。這是預設行為。不會影響是否顯示任何其他標記或底圖標籤。

  • GMSCollisionBehaviorOptionalAndHidesLowerPriority:標記只會在沒有重疊情況時顯示。如果這個類型的兩個標記重疊,系統會顯示 zIndex 較高的標記。如果兩者的 zIndex 相同,系統會顯示直向畫面位置較低的標記。

  • GMSCollisionBehaviorRequiredAndHidesOptional:無論是哪種衝突,一律顯示標記,並隱藏任何 GMSCollisionBehaviorOptionalAndHidesLowerPriority。標記只會在沒有重疊情況時顯示。不會 GMSCollisionBehaviorRequired。如果這個類型的兩個標記重疊,系統會顯示 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