衝突時動作を制御する

プラットフォームを選択: 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