マーカーを使用すると、ユーザーが地図上で場所を確認しやすくなります。このガイドでは、3D マップでマーカーを使用、カスタマイズする方法を説明します。マーカーの形状、サイズ、色のほか、表示する高さを調整できます。
マーカーを使用して、地図上に場所を表示します。前述の例では、カスタマイズを加えていないシンプルなマーカーを 1 つ表示します。
色、スケール、アイコン画像をカスタマイズする
マーカーのデフォルトの背景色、グリフの色、輪郭線の色、サイズをカスタマイズできます。
マーカーのデフォルトのアイコンを、SVG 形式のカスタム リソースに差し替えます。
マーカーの表示高度を設定する
マーカーを押し出して高さを設定することで、マーカーの高さを設定できます。
重なった場合の動作を管理する
重なった場合の動作とは、マーカーが別のマーカーと衝突した(表示位置が重なった)際の表示方法のことです。
重なった場合の動作を指定するには、collisionBehavior
を次のいずれかに設定します。
REQUIRED
: 他のマーカーと重なっていても常に表示されます。REQUIRED_AND_HIDES_OPTIONAL
: 他のマーカーと重なっても常に表示されますが、このマーカーと表示位置が重なるOPTIONAL_AND_HIDES_LOWER_PRIORITY
のマーカーとラベルはすべて非表示になります。OPTIONAL_AND_HIDES_LOWER_PRIORITY
: 他のマーカーと表示位置が重ならない場合にのみ表示されます。このタイプのマーカー同士が重なった場合、zIndex
の高い方が表示されます。zIndex
も同一の場合、画面内の縦位置が低いほうが表示されます。