重なった場合の動作を制御する

このプロダクトまたは機能は、pre-GA（一般提供前）のプレビュー版です。pre-GA のプロダクトや機能では、サポートが限定されることがあります。また、pre-GA のプロダクトや機能を変更すると、他の pre-GA バージョンに対応しなくなる場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳しくは、リリース ステージの説明をご覧ください。

このページでは、マーカーが重なった場合の動作の設定方法を解説します。 重なった場合の動作とは、マーカーが別のマーカーと衝突した（表示位置が重なった）際の表示方法のことです。

重なった場合の動作を指定するには、collisionBehavior を次のいずれかに設定します。

• REQUIRED: 他のマーカーと重なっていても常に表示されます。
• REQUIRED_AND_HIDES_OPTIONAL: 他のマーカーと重なっても常に表示されますが、このマーカーと表示位置が重なる OPTIONAL_AND_HIDES_LOWER_PRIORITY のマーカーとラベルはすべて非表示になります。
• OPTIONAL_AND_HIDES_LOWER_PRIORITY: 他のマーカーと表示位置が重ならない場合にのみ表示されます。このタイプのマーカー同士が重なった場合、zIndex の高い方が表示されます。zIndex も同一の場合、画面内の縦位置が低いほうが表示されます。

次の例は、マーカーの重なった場合の動作の設定方法を示したものです。

const marker = new Marker3DElement({
    position: {lat, lng},
    collisionBehavior: google.maps.CollisionBehavior.REQUIRED
});