マーカー
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
マーカーを使用すると、ユーザーが地図上で場所を確認しやすくなります。このガイドでは、3D マップでマーカーを使用、カスタマイズする方法を説明します。マーカーの形状、サイズ、色のほか、表示する高さを調整できます。
マーカーを使用して、地図上に場所を表示します。上記の例は、カスタマイズが適用されていない基本的な単一のマーカーです。
色、スケール、アイコン画像をカスタマイズする
マーカーのデフォルトの背景色、グリフの色、輪郭線の色、サイズをカスタマイズできます。

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

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

マーカーをクリックやキーボード イベントに反応させる
click
イベント リスナーを追加して、マーカーがクリックやキーボード イベントに反応するようにします。
function initMap() {
const map = new Map3DElement({
center: { lat: 37.4690, lng: -122.1074, altitude: 0 },
tilt: 67.5,
range: 45000,
mode: MapMode.HYBRID
});
const interactiveMarker = new google.maps.marker.Marker3DInteractiveElement({
map,
position: {lat: 37.4239163, lng: -122.0947209},
});
interactiveMarker.addEventListener('gmp-click', (event) => {
// Handle the click event.
// ...
});
}
マーカーが重なった場合の動作を設定する
別のマーカーや地図ラベルと表示位置が重なった場合の動作を指定できます。
const marker = new Marker3DElement({
position: {lat, lng},
collisionBehavior: google.maps.CollisionBehavior.REQUIRED
});
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-04-29 UTC。
[null,null,["最終更新日 2025-04-29 UTC。"],[],[],null,["\u003cbr /\u003e\n\n| This product or feature is in Preview (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage\n| descriptions](/maps/launch-stages).\n\n\u003cbr /\u003e\n\nUse markers to draw a user's attention to a location on a map. This guide\ndemonstrates how to use and customize markers in 3D maps. You can control the\nshape, size, and color of markers, in addition to the altitude at which they\nappear.\n\nUse markers to show locations on maps. The example above shows a basic, single\nmarker with no customization applied.\n\nCustomize color, scale and icon image\n\nCustomize the default marker's background, glyph, border color, and size.\n\nReplace the default marker icon with a custom SVG resource.\n\nSet marker altitude\n\nYou can set marker altitude by extruding the marker and setting the altitude.\n\nMake markers respond to click and keyboard events\n\nMake a marker respond to clicks and keyboard events by adding a `click` event\nlistener. \n\n function initMap() {\n const map = new Map3DElement({\n center: { lat: 37.4690, lng: -122.1074, altitude: 0 },\n tilt: 67.5,\n range: 45000,\n mode: MapMode.HYBRID\n });\n\n const interactiveMarker = new google.maps.marker.Marker3DInteractiveElement({\n map,\n position: {lat: 37.4239163, lng: -122.0947209},\n });\n\n interactiveMarker.addEventListener('gmp-click', (event) =\u003e {\n // Handle the click event.\n // ...\n });\n }\n\nSet marker collision behavior\n\nSpecify how a marker should behave when it collides with another marker or map\nlabel. \n\n const marker = new Marker3DElement({\n position: {lat, lng},\n collisionBehavior: google.maps.CollisionBehavior.REQUIRED\n });\n\nNext step\n\n- [Add a marker](/maps/documentation/javascript/3d/marker-add)"]]