マーカー

マーカーを使用すると、ユーザーが地図上で場所を確認しやすくなります。このガイドでは、3D マップでマーカーを使用、カスタマイズする方法を説明します。マーカーの形状、サイズ、色のほか、表示する高さを調整できます。

マーカーを使用して、地図上に場所を表示します。前述の例では、カスタマイズを加えていないシンプルなマーカーを 1 つ表示します。

色、スケール、アイコン画像をカスタマイズする

マーカーのデフォルトの背景色、グリフの色、輪郭線の色、サイズをカスタマイズできます。

カスタムのマーカー

サンプルを試す

マーカーのデフォルトのアイコンを、SVG 形式のカスタム リソースに差し替えます。

グラフィック付きのマーカー

サンプルを試す

マーカーの表示高度を設定する

マーカーを押し出して高さを設定することで、マーカーの高さを設定できます。

押し出したマーカー

サンプルを試す

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

重なった場合の動作とは、マーカーが別のマーカーと衝突した(表示位置が重なった)際の表示方法のことです。

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

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