重なった場合の動作とは、マーカーが別のマーカーと表示位置が重なった場合の表示方法のことです。
マーカーが重なった場合の動作を設定する
重なった場合の動作を設定するには、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