重なった場合の動作を管理する

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