このページは Cloud Translation API によって翻訳されました。

Marker (legacy)

Marker クラス

google.maps.Marker クラス

非推奨: google.maps.Marker は、2024 年 2 月 21 日にサポートが終了しました。代わりにAdvancedMarkerElementを使用してください。現在のところ、google.maps.Marker の廃止予定はありませんが、google.maps.Marker よりも AdvancedMarkerElement を使用することをおすすめします。google.maps.Marker では、重大な回帰に関するバグの修正は引き続き行われますが、google.maps.Marker の既存のバグは修正されません。サポートを終了する 12 か月前までに改めてお知らせいたします。詳細については、https://developers.google.com/maps/deprecations をご覧ください。移行ガイドについては、https://developers.google.com/maps/documentation/javascript/advanced-markers/migration をご覧ください。

このクラスは MVCObject を拡張します。

const {Marker} = await google.maps.importLibrary("marker") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

コンストラクタ
`Marker`	`Marker([opts])` パラメータ: `opts`: `MarkerOptions optional` 名前付きの省略可能な引数指定されたオプションでマーカーを作成します。地図が指定されている場合、マーカーは構築時に地図に追加されます。マーカーを表示するには、位置を設定する必要があります。

定数
`MAX_ZINDEX`	API がマーカーに割り当てるデフォルトの最大 Z-Index。Z インデックスを高い値にするほど、マーカーが前に表示されます。

メソッド
`getAnimation`	`getAnimation()` パラメータ: なし戻り値: `Animation\|null\|undefined` 現在実行中のアニメーションを取得します。
`getClickable`	`getClickable()` パラメータ: なし戻り値: `boolean` マーカーがクリック可能な場合は True。 `Marker` のクリック可能なステータスを取得します。
`getCursor`	`getCursor()` パラメータ: なし戻り値: `string\|null\|undefined` ホバー時に表示されるマウスカーソルのタイプを取得します。
`getDraggable`	`getDraggable()` パラメータ: なし戻り値: `boolean` マーカーがドラッグ可能である場合は true。 `Marker` のドラッグ可能なステータスを取得します。
`getIcon`	`getIcon()` パラメータ: なし戻り値: `string\|Icon\|Symbol\|null\|undefined` `Marker` のアイコンを取得します。`MarkerOptions.icon`をご確認ください。
`getLabel`	`getLabel()` パラメータ: なし戻り値: `MarkerLabel\|string\|null\|undefined` `Marker` のラベルを取得します。`MarkerOptions.label`をご確認ください。
`getMap`	`getMap()` パラメータ: なし戻り値: `Map\|StreetViewPanorama` `Marker` がレンダリングされる地図またはパノラマを取得します。
`getOpacity`	`getOpacity()` パラメータ: なし戻り値: `number\|null\|undefined` 0.0 ～ 1.0 の数値。 `Marker` の不透明度を取得します。
`getPosition`	`getPosition()` パラメータ: なし戻り値: `LatLng\|null\|undefined` `Marker` の位置を取得します。
`getShape`	`getShape()` パラメータ: なし戻り値: `MarkerShape\|null\|undefined` インタラクションに使用される `Marker` の形状を取得します。`MarkerOptions.shape` と `MarkerShape` をご覧ください。
`getTitle`	`getTitle()` パラメータ: なし戻り値: `string\|null\|undefined` `Marker` ツールチップのタイトルを取得します。`MarkerOptions.title`をご確認ください。
`getVisible`	`getVisible()` パラメータ: なし戻り値: `boolean` マーカーが表示されている場合は True。 `Marker` の可視性を取得します。
`getZIndex`	`getZIndex()` パラメータ: なし戻り値: `number\|null\|undefined` マーカーの zIndex。 `Marker` の zIndex を取得します。`MarkerOptions.zIndex`をご確認ください。
`setAnimation`	`setAnimation([animation])` パラメータ: `animation`: `Animation optional` 再生するアニメーション。戻り値: なしアニメーションを開始します。進行中のアニメーションはキャンセルされます。現在サポートされているアニメーションは `Animation.BOUNCE`、`Animation.DROP` です。`null` を渡すと、アニメーションが停止します。
`setClickable`	`setClickable(flag)` パラメータ: `flag`: `boolean` `true` の場合、マーカーをクリックできます。戻り値: なし `Marker` がクリック可能かどうかを設定します。
`setCursor`	`setCursor([cursor])` パラメータ: `cursor`: `string optional` マウスカーソルの種類。戻り値: なしホバー時に表示されるマウスカーソルのタイプを設定します。
`setDraggable`	`setDraggable(flag)` パラメータ: `flag`: `boolean optional` `true` の場合、マーカーをドラッグできます。戻り値: なし `Marker` がドラッグ可能かどうかを設定します。
`setIcon`	`setIcon([icon])` パラメータ: `icon`: `string\|Icon\|Symbol optional` 戻り値: なし `Marker` のアイコンを設定します。`MarkerOptions.icon`をご確認ください。
`setLabel`	`setLabel([label])` パラメータ: `label`: `string\|MarkerLabel optional` ラベルは、文字列または `MarkerLabel` オブジェクトのいずれかになります。戻り値: なし `Marker` のラベルを設定します。`MarkerOptions.label`をご確認ください。
`setMap`	`setMap(map)` パラメータ: `map`: `Map\|StreetViewPanorama` 戻り値: なし指定された地図またはパノラマに `Marker` をレンダリングします。地図が `null` に設定されている場合、マーカーは削除されます。
`setOpacity`	`setOpacity([opacity])` パラメータ: `opacity`: `number optional` 0.0（透明）から 1.0（不透明）までの数値。戻り値: なし `Marker` の不透明度を設定します。
`setOptions`	`setOptions(options)` パラメータ: `options`: `MarkerOptions` 戻り値: なし `Marker` のオプションを設定します。
`setPosition`	`setPosition([latlng])` パラメータ: `latlng`: `LatLng\|LatLngLiteral optional` 新しい位置。戻り値: なし `Marker` の位置を設定します。
`setShape`	`setShape([shape])` パラメータ: `shape`: `MarkerShape optional` 戻り値: なしインタラクションに使用される `Marker` の形状を設定します。`MarkerOptions.shape` と `MarkerShape` をご覧ください。
`setTitle`	`setTitle([title])` パラメータ: `title`: `string optional` 戻り値: なし `Marker` ツールチップのタイトルを設定します。`MarkerOptions.title`をご確認ください。
`setVisible`	`setVisible(visible)` パラメータ: `visible`: `boolean` `true` の場合、マーカーが表示されます戻り値: なし `Marker` が表示される場合に設定します。
`setZIndex`	`setZIndex([zIndex])` パラメータ: `zIndex`: `number optional` 戻り値: なし `Marker` の zIndex を設定します。`MarkerOptions.zIndex`をご確認ください。
継承: `addListener`、 `bindTo`、 `get`、 `notify`、 `set`、 `setValues`、 `unbind`、 `unbindAll`

イベント
`animation_changed`	`function()` 引数: なしこのイベントは、`Marker` アニメーションプロパティが変更されたときに発生します。
`click`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、`Marker` アイコンがクリックされたときに発生します。
`clickable_changed`	`function()` 引数: なしこのイベントは、`Marker` クリック可能プロパティが変更されたときに発生します。
`contextmenu`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、`Marker` で DOM contextmenu イベントが発生したときに発生します。
`cursor_changed`	`function()` 引数: なしこのイベントは、`Marker` カーソルプロパティが変更されたときに発生します。
`dblclick`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、`Marker` アイコンがダブルクリックされたときに発生します。
`drag`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが `Marker` をドラッグしている間、繰り返し発生します。
`dragend`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが `Marker` のドラッグを終了したときに発生します。
`draggable_changed`	`function()` 引数: なしこのイベントは、`Marker` draggable プロパティが変更されたときに発生します。
`dragstart`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが `Marker` のドラッグを開始したときに発生します。
`flat_changed`	`function()` 引数: なしこのイベントは、`Marker` フラットプロパティが変更されたときに発生します。
`icon_changed`	`function()` 引数: なしこのイベントは、`Marker` アイコンプロパティが変更されたときに発生します。
`mousedown`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、`Marker` で mousedown が発生したときに発生します。
`mouseout`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、マウスが `Marker` アイコンの領域から離れたときに発生します。
`mouseover`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、マウスが `Marker` アイコンの領域に入ったときに発生します。
`mouseup`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、`Marker` で mouseup が発生したときに発生します。
`position_changed`	`function()` 引数: なしこのイベントは、`Marker` 位置プロパティが変更されたときに発生します。
`shape_changed`	`function()` 引数: なしこのイベントは、`Marker` シェイププロパティが変更されたときに発生します。
`title_changed`	`function()` 引数: なしこのイベントは、`Marker` タイトルプロパティが変更されたときに発生します。
`visible_changed`	`function()` 引数: なしこのイベントは、`Marker` 可視プロパティが変更されたときに発生します。
`zindex_changed`	`function()` 引数: なしこのイベントは、`Marker` zIndex プロパティが変更されたときに発生します。
`rightclick`	非推奨: macOS でのコントロールクリックなどの使用パターンをサポートするには、代わりに `Marker.contextmenu` イベントを使用してください。 `function(event)` 引数: `event`: `MapMouseEvent` このイベントは、`Marker` の右クリックで発生します。

MarkerOptions インターフェース

google.maps.MarkerOptions インターフェース

マーカーに設定できるプロパティを定義するために使用される MarkerOptions オブジェクト。

プロパティ
`anchorPoint optional`	タイプ: `Point optional` マーカーの位置から、マーカーをアンカーとして開いた InfoWindow の先端までのオフセット。
`animation optional`	タイプ: `Animation optional` デフォルト: `null` マーカーが地図に追加されたときに再生するアニメーション。
`clickable optional`	タイプ: `boolean optional` デフォルト: `true` `true` の場合、マーカーはマウスイベントとタッチイベントを受け取ります。
`collisionBehavior optional`	非推奨: `collisionBehavior` は 2023 年 7 月に非推奨になりました。代わりに `AdvancedMarkerElement.collisionBehavior` を使用してください注意: v=beta チャンネルでのみ使用できます。タイプ: `string\|CollisionBehavior optional` デフォルト: `null` ベクターマップ上のマーカーが重なった場合の動作を設定します。
`crossOnDrag optional`	タイプ: `boolean optional` デフォルト: `true` `false` の場合、ドラッグ時にマーカーの下に表示される十字を無効にします。
`cursor optional`	タイプ: `string optional` デフォルト: `pointer` マウスカーソルを重ねたときに表示するマウスカーソルの種類。
`draggable optional`	タイプ: `boolean optional` デフォルト: `false` `true` の場合、マーカーをドラッグできます。注: これを `true` に設定すると、`clickable` が `false` に設定されていても、マーカーをクリックできるようになります。
`icon optional`	タイプ: `string\|Icon\|Symbol optional` フォアグラウンドのアイコン。文字列が指定された場合、文字列を `url` とする `Icon` として扱われます。
`label optional`	タイプ: `string\|MarkerLabel optional` デフォルト: `null` マーカーにラベルを追加します。マーカーラベルは、マーカー内に表示される文字または数値です。ラベルには、文字列または `MarkerLabel` オブジェクトを指定できます。このパラメータが指定され、`MarkerOptions.title` が指定されていない場合、指定されたラベルのテキストを含むユーザー補助テキスト（スクリーンリーダーで使用するなど）がマーカーに追加されます。なお、`label` は現在、最適化されていないマーカーのユーザー補助テキストにのみ使用されています。
`map optional`	タイプ: `Map\|StreetViewPanorama optional` マーカーを表示する地図。マーカーを表示するには地図が必要であり、マーカーの構築時に指定されていない場合は `Marker.setMap` で指定できます。
`opacity optional`	タイプ: `number optional` デフォルト: 1.0 0.0（透明）から 1.0（不透明）までの数値。
`optimized optional`	タイプ: `boolean optional` 最適化すると、多数のマーカーが単一の静的要素としてレンダリングされ、パフォーマンスが向上します。最適化は、多くのマーカーが必要な場合に便利です。詳しくは、マーカーの最適化をご覧ください。注: この最適化は、ベクターマップ上のマーカーには影響しません。
`position optional`	タイプ: `LatLng\|LatLngLiteral optional` マーカーの位置を設定します。マーカーは、位置情報が提供されるまで（たとえば、ユーザーの操作や選択によって）構築されても表示されないことがあります。マーカーの構築時に指定されていない場合、マーカーの位置は `Marker.setPosition` で指定できます。
`shape optional`	タイプ: `MarkerShape optional` ドラッグ/クリック用の画像マップの領域定義。
`title optional`	タイプ: `string optional` デフォルト: `undefined` ロールオーバーテキスト。指定された場合、ユーザー補助テキスト（スクリーンリーダーで使用するなど）が、指定された値とともにマーカーに追加されます。なお、`title` は現在、最適化されていないマーカーのユーザー補助テキストにのみ使用されています。
`visible optional`	タイプ: `boolean optional` デフォルト: `true` `true` の場合、マーカーは表示されます。
`zIndex optional`	タイプ: `number optional` すべてのマーカーは、zIndex の順で地図上に表示されます。つまり、この値が大きいマーカーは、値が小さいマーカーよりも前面に表示されます。デフォルトでは、マーカーは画面の垂直方向の位置に従って表示され、画面で低い位置にあるマーカーが高い位置にあるマーカーより前に表示されます。

CollisionBehavior 定数

google.maps.CollisionBehavior 定数

const {CollisionBehavior} = await google.maps.importLibrary("marker") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。

定数
`OPTIONAL_AND_HIDES_LOWER_PRIORITY`	他のマーカーと位置が重ならない場合にだけ表示されます。このタイプのマーカー同士が重なった場合、zIndex の高いほうが表示されます。zIndex が同じ場合は、画面内の縦位置が低いほうが表示されます。
`REQUIRED`	他のマーカーと重なっていても常に表示されます。これはデフォルトの動作です。
`REQUIRED_AND_HIDES_OPTIONAL`	他のマーカーと重なっても常に表示されますが、このマーカーと表示位置が重なる OPTIONAL_AND_HIDES_LOWER_PRIORITY のマーカーとラベルはすべて非表示になります。

Marker (legacy) コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Marker クラス

コンストラクタ

定数

メソッド

イベント

MarkerOptions インターフェース

プロパティ

CollisionBehavior 定数

定数

Marker (legacy)