控管衝突行為

選取平台： 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