控管衝突行為

選取平台： Android iOS JavaScript

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

設定標記的衝突行為

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

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

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

• GMSCollisionBehaviorRequiredAndHidesOptional：無論是哪種衝突，一律顯示標記，並隱藏所有 GMSCollisionBehaviorOptionalAndHidesLowerPriority。標記只會在沒有重疊情況時顯示。不會GMSCollisionBehaviorRequired。如果這個類型的兩個標記重疊，系統會顯示 zIndex 較高的標記。如果標記具有相同的 zIndex，系統未定義其碰撞規則。

  注意：為了讓衝突行為妥善運作，建立進階標記時，建議都使用相同類型。包括以 iconView、圖示或預設功能表示的進階標記。

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