Marker クラス
google.maps.Marker
クラス
このクラスは MVCObject
を拡張します。
v=beta
を使用している場合は、const {Marker} = await google.map.importLibrary("marker")
を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Marker |
Marker([opts]) パラメータ:
指定されたオプションでマーカーを作成します。地図を指定した場合は、作成時にマーカーが地図に追加されます。マーカーを表示するには位置を設定する必要があります。 |
Methods | |
---|---|
getAnimation |
getAnimation() パラメータ: なし
戻り値:
Animation|null|undefined 現在実行中のアニメーションを取得します。 |
getClickable |
getClickable() パラメータ: なし
戻り値:
boolean マーカーがクリック可能な場合、true になります。Marker のクリック可能なステータスを取得します。 |
getCursor |
getCursor() パラメータ: なし
戻り値:
string|null|undefined カーソルを合わせたときに表示されるマウスカーソルの種類を取得します。 |
getDraggable |
getDraggable() パラメータ: なし
戻り値:
boolean マーカーがドラッグ可能な場合は true。Marker のドラッグ可能なステータスを取得します。 |
getIcon |
getIcon() パラメータ: なし
Marker のアイコンを取得します。MarkerOptions.icon をご確認ください。 |
getLabel |
getLabel() パラメータ: なし
戻り値:
MarkerLabel|null|string|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 |
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]) パラメータ:
戻り値: None
アニメーションを開始します。進行中のアニメーションはキャンセルされます。現在サポートされているアニメーションは Animation.BOUNCE 、Animation.DROP です。null を渡すと、アニメーションがすべて停止します。 |
setClickable |
setClickable(flag) パラメータ:
戻り値: None
Marker がクリック可能かどうかを設定します。 |
setCursor |
setCursor([cursor]) パラメータ:
戻り値: None
マウスオーバーに表示されるマウスカーソルの種類を設定します。 |
setDraggable |
setDraggable(flag) パラメータ:
戻り値: None
Marker がドラッグ可能かどうかを設定します。 |
setIcon |
setIcon([icon]) 戻り値: None
Marker のアイコンを設定します。MarkerOptions.icon をご確認ください。 |
setLabel |
setLabel([label]) パラメータ:
戻り値: None
Marker のラベルを設定します。MarkerOptions.label をご確認ください。 |
setMap |
setMap(map) パラメータ:
戻り値: None
指定された地図またはパノラマで Marker をレンダリングします。地図が null に設定されている場合、マーカーは削除されます。 |
setOpacity |
setOpacity([opacity]) パラメータ:
戻り値: None
Marker の不透明度を設定します。 |
setOptions |
setOptions(options) パラメータ:
戻り値: None
Marker のオプションを設定します。 |
setPosition |
setPosition([latlng]) パラメータ:
戻り値: None
Marker の形状を設定します。 |
setShape |
setShape([shape]) パラメータ:
戻り値: None
|
setTitle |
setTitle([title]) パラメータ:
戻り値: None
Marker ツールチップのタイトルを設定します。MarkerOptions.title をご確認ください。 |
setVisible |
setVisible(visible) パラメータ:
戻り値: None
Marker が表示されているかどうかを設定します。 |
setZIndex |
setZIndex([zIndex]) パラメータ:
戻り値: None
Marker の zIndex を設定します。MarkerOptions.zIndex をご確認ください。 |
継承:
addListener 、
bindTo 、
get 、
notify 、
set 、
setValues 、
unbind 、
unbindAll
|
定数 | |
---|---|
MAX_ZINDEX |
API がマーカーに割り当てるデフォルトの Z-Index の最大値。Z インデックスを高い値にするほど、マーカーが前に表示されます。 |
イベント | |
---|---|
animation_changed |
function() 引数: なし
このイベントは、 Marker アニメーション プロパティが変更されると発生します。 |
click |
function(event) 引数:
このイベントは、 Marker アイコンがクリックされたときに発生します。 |
clickable_changed |
function() 引数: なし
このイベントは、 Marker のクリック可能プロパティが変更されると発生します。 |
contextmenu |
function(event) 引数:
このイベントは、 Marker で DOM コンテキスト メニュー イベントが発生すると発生します。 |
cursor_changed |
function() 引数: なし
このイベントは、 Marker カーソル プロパティが変更されると発生します。 |
dblclick |
function(event) 引数:
このイベントは、 Marker アイコンがダブルクリックされると発生します。 |
drag |
function(event) 引数:
このイベントは、ユーザーが Marker をドラッグしている間に繰り返し発生します。 |
dragend |
function(event) 引数:
このイベントは、ユーザーが Marker のドラッグを停止すると発生します。 |
draggable_changed |
function() 引数: なし
このイベントは、 Marker のドラッグ可能なプロパティが変更されると発生します。 |
dragstart |
function(event) 引数:
このイベントは、ユーザーが Marker をドラッグし始めると発生します。 |
flat_changed |
function() 引数: なし
このイベントは、 Marker フラット プロパティが変更されると発生します。 |
icon_changed |
function() 引数: なし
このイベントは、 Marker アイコンのプロパティが変更されると発生します。 |
mousedown |
function(event) 引数:
このイベントは、 Marker でのマウスダウンに対して発生します。 |
mouseout |
function(event) 引数:
このイベントは、マウスが Marker アイコンの領域を離れると発生します。 |
mouseover |
function(event) 引数:
マウスが Marker アイコンの領域に入ると、このイベントが発生します。 |
mouseup |
function(event) 引数:
このイベントは、 Marker でのマウスアップに対して発生します。 |
position_changed |
function() 引数: なし
このイベントは、 Marker 位置プロパティが変更されると発生します。 |
shape_changed |
function() 引数: なし
このイベントは、 Marker シェイプのプロパティが変更されると発生します。 |
title_changed |
function() 引数: なし
このイベントは、 Marker タイトル プロパティが変更されると発生します。 |
visible_changed |
function() 引数: なし
このイベントは、 Marker の表示プロパティが変更されると発生します。 |
zindex_changed |
function() 引数: なし
このイベントは、 Marker zIndex プロパティが変更されると発生します。 |
|
function(event) 引数:
このイベントは、 Marker を右クリックすると発生します。 |
MarkerOptions インターフェース
google.maps.MarkerOptions
インターフェース
Marker に設定できるプロパティを定義するために使用される MarkerOptions オブジェクト。
プロパティ | |
---|---|
anchorPoint optional |
タイプ:
Point optional マーカーの位置から、マーカーをマーカーとして開いた情報ウィンドウの先端までのオフセット。 |
animation optional |
タイプ:
Animation optional デフォルト:
null マーカーが地図に追加されたときに再生するアニメーション。 |
clickable optional |
タイプ:
boolean optional デフォルト:
true true の場合、マーカーはマウスイベントとタップイベントを受け取ります。 |
|
タイプ:
string|CollisionBehavior optional デフォルト:
null ベクター地図上のマーカーの競合動作を設定します。 |
crossOnDrag optional |
タイプ:
boolean optional デフォルト:
true false の場合、ドラッグ時にマーカーの下に表示される交差が無効になります。 |
cursor optional |
タイプ:
string optional デフォルト:
pointer マウスオーバーで使用するマウスカーソルの種類。 |
draggable optional |
タイプ:
boolean optional デフォルト:
false true の場合、マーカーをドラッグできます。 |
icon optional |
フォアグラウンドのアイコン。文字列を指定すると、 Icon のように扱われ、文字列が url であるものとして扱われます。 |
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
定数
v=beta
を使用している場合は、const {CollisionBehavior} = await google.map.importLibrary("marker")
を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
OPTIONAL_AND_HIDES_LOWER_PRIORITY |
他のマーカーと重ならない場合にのみマーカーを表示します。同じタイプのマーカーが 2 つ重なっている場合は、ZIndex の値が高い方のマーカーが表示されます。同じ zIndex が設定されている場合、画面の垂直位置が低い方が表示されます。 |
REQUIRED |
衝突にかかわらず、常にマーカーを表示する。これがデフォルト設定です。 |
REQUIRED_AND_HIDES_OPTIONAL |
衝突の有無にかかわらず常にマーカーを表示し、マーカーと重なるオプション オプション AND_AND_HIDES_LOWER_PRIORITY を非表示にします。 |
Icon インターフェース
google.maps.Icon
インターフェース
マーカーのアイコン画像を表す構造。
プロパティ | |
---|---|
url |
タイプ:
string 画像またはスプライト シートの URL。 |
anchor optional |
タイプ:
Point optional 地図上のマーカーの位置に対応して画像を固定する位置。デフォルトでは、アンカーは画像の下辺中央に設定されています。 |
labelOrigin optional |
タイプ:
Point optional マーカーによってラベルが指定されている場合、アイコン画像の左上隅を基準とするラベルの原点。デフォルトでは、原点は画像の中心点にあります。 |
origin optional |
タイプ:
Point optional スプライト内の画像の位置(ある場合)。デフォルトでは、原点は画像 (0, 0) の左上にあります。 |
scaledSize optional |
タイプ:
Size optional スケーリング後の画像全体のサイズ(存在する場合)。このプロパティを使用して画像またはスプライトを伸縮します。 |
size optional |
タイプ:
Size optional スプライトまたは画像の表示サイズ。スプライトを使用する場合、スプライトのサイズを指定する必要があります。サイズを指定しない場合、画像を読み込むときに設定されます。 |
MarkerLabel インターフェース
google.maps.MarkerLabel
インターフェース
このオプションでは、マーカーラベルの外観を指定します。マーカーラベルは、マーカー内に表示される文字列(通常は 1 文字)です。カスタム マーカーで使用する場合は、Icon
クラスの labelOrigin
プロパティで配置を変更できます。
プロパティ | |
---|---|
text |
タイプ:
string ラベルに表示されるテキスト。 |
className optional |
タイプ:
string optional デフォルト:
'' (空の文字列)ラベルの要素の className プロパティ(要素の class 属性に相当)。スペースで区切られた複数の CSS クラスを追加できます。フォントの色、サイズ、太さ、ファミリーは、 MarkerLabel の他のプロパティを介してのみ設定できます。マーカーの競合管理も使用している場合は、CSS クラスを使用して、ラベルの位置や向きを変更しないでください(翻訳や回転を使用するなど)。 |
color optional |
タイプ:
string optional デフォルト:
'black' ラベルのテキストの色。 |
fontFamily optional |
タイプ:
string optional ラベルテキストのフォント ファミリー(CSS font-family プロパティに相当)。 |
fontSize optional |
タイプ:
string optional デフォルト:
'14px' ラベルテキストのフォントサイズ(CSS の font-size プロパティと同等)。 |
fontWeight optional |
タイプ:
string optional ラベルテキストのフォントの太さ(CSS font-weight プロパティに相当)。 |
MarkerShape インターフェース
google.maps.MarkerShape
インターフェース
このオブジェクトは、マーカー画像のクリック可能な領域を定義します。このシェイプは、type
と coord
という 2 つのプロパティで構成され、画像の不透明な領域を定義します。
プロパティ | |
---|---|
coords |
タイプ:
Array<number> この属性の形式は、 type の値によって異なります。http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords にある w3 AREA coords 仕様に従ってください。coords 属性は、ターゲット画像の左上端を基準とする図形のピクセル位置を指定する整数の配列です。座標は、type の値()に応じて異なります。 circle : 座標は [x1,y1,r] で、x1、y2 は円の中心の座標、r は円の半径です。- poly : 座標は [x1,y1,x2,y2...xn,yn] で、x,y ペアごとにポリゴンの 1 つの頂点の座標が含まれています。- rect : 座標は [x1,y1,x2,y2] です。ここで x1、y1 は長方形の左上隅の座標、x2,y2 は長方形の右下の座標です。 |
type |
タイプ:
string シェイプのタイプを記述します。 circle 、poly 、rect のいずれかを指定できます。 |
Symbol インターフェース
google.maps.Symbol
インターフェース
記号付きで、スタイリング付きのベクターパスで構成されます。シンボルは、マーカーのアイコンとして使用したり、ポリライン上に配置したりできます。
プロパティ | |
---|---|
path |
タイプ:
SymbolPath|string シンボルのパス。組み込みのシンボルパスです。SVG パスの表記法を使用して表現するカスタムパスです。必須。 |
anchor optional |
タイプ:
Point optional デフォルト:
google.maps.Point(0,0) マーカーやポリラインからの相対的な位置。記号のパスの座標は、アンカーの x 座標と y 座標からそれぞれ左方向と上方向に変換されます。この位置は、シンボルのパスと同じ座標系で表現されます。 |
fillColor optional |
タイプ:
string optional 記号の塗りつぶし色。名前付き拡張色を除くすべての CSS3 色に対応します。シンボル マーカーの場合、デフォルトは「black」です。ポリライン上のシンボルの場合、これは対応するポリラインのストロークの色がデフォルトになります。 |
fillOpacity optional |
タイプ:
number optional デフォルト:
0 シンボルの塗りつぶしの不透明度。 |
labelOrigin optional |
タイプ:
Point optional デフォルト:
google.maps.Point(0,0) パスの原点を基準としたラベルの原点。ラベルがマーカーによって指定されている場合。原点は、シンボルのパスと同じ座標系で表されます。このプロパティは、ポリライン上のシンボルには使用されません。 |
rotation optional |
タイプ:
number optional デフォルト:
0 シンボルを回転させる角度です。時計回りの度数で表します。 fixedRotation が false である IconSequence のシンボルは、それが存在するエッジの角度に対して回転します。 |
scale optional |
タイプ:
number optional シンボルのサイズ調整量。シンボル マーカーの場合、デフォルトは 1 です。スケーリング後のシンボルのサイズに制限はありません。ポリライン上のシンボルは、デフォルトではポリラインのストロークの太さに設定されます。スケーリング後、シンボルはシンボルのアンカーを中心とした 22 ピクセルの正方形内に配置する必要があります。 |
strokeColor optional |
タイプ:
string optional シンボルのストロークの色。名前付き拡張色を除くすべての CSS3 色に対応します。シンボル マーカーの場合、デフォルトは「black」です。ポリライン上のシンボルの場合、これはデフォルトでポリラインのストロークの色になります。 |
strokeOpacity optional |
タイプ:
number optional シンボルのストロークの不透明度。シンボル マーカーの場合、この値はデフォルトで 1 に設定されます。ポリライン上のシンボルの場合、これはデフォルトでポリラインのストロークの不透明度に設定されます。 |
strokeWeight optional |
タイプ:
number optional デフォルト: 記号の
Symbol.scale 。シンボルのストロークの太さ。 |
SymbolPath 定数
google.maps.SymbolPath
定数
組み込みのシンボルパス。
v=beta
を使用している場合は、const {SymbolPath} = await google.map.importLibrary("core")
を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BACKWARD_CLOSED_ARROW |
後方を指す閉じ矢印。 |
BACKWARD_OPEN_ARROW |
後方を指す開いた矢印。 |
CIRCLE |
円。 |
FORWARD_CLOSED_ARROW |
前方を指す矢印。 |
FORWARD_OPEN_ARROW |
前向きの矢印。 |
アニメーション定数
google.maps.Animation
定数
マーカーで再生できるアニメーション。アニメーションを再生するには、Marker の Marker.setAnimation
メソッドまたは MarkerOptions.animation
オプションを使用します。
v=beta
を使用している場合は、const {Animation} = await google.map.importLibrary("marker")
を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BOUNCE |
null で Marker.setAnimation を呼び出すと、アニメーションが停止するまでマーカーがバウンスします。 |
DROP |
マーカーが地図の上部から最終的な場所まで落ちると、マーカーが止まるとアニメーションが終了し、Marker.getAnimation が null を返します。このタイプのアニメーションは、通常、マーカーの作成時に指定します。 |