DOM elements

OverlayView クラス

google.maps.OverlayView クラス

地図上にカスタム タイプのオーバーレイ オブジェクトを表示する場合は、このクラスを実装できます。

オーバーレイのプロトタイプを設定して、このクラスを継承します: MyOverlay.prototype = new google.maps.OverlayView();OverlayView コンストラクタは、空の関数であることが保証されています。

onAdd()draw()onRemove() の 3 つのメソッドを実装する必要があります。

  • onAdd() メソッドで、DOM オブジェクトを作成してペインの子として追加する必要があります。
  • draw() メソッドで、これらの要素を配置します。
  • onRemove() メソッドで、DOM からオブジェクトを削除する必要があります。
onRemove() メソッドをトリガーするには、onAdd() メソッドと setMap(null) の呼び出しをトリガーする有効な Map オブジェクトを指定して setMap() を呼び出す必要があります。setMap() メソッドは、作成時に、または削除後にオーバーレイを再表示する必要がある任意の時点で呼び出すことができます。draw() メソッドは、要素の位置(ズーム、中心、地図のタイプなど)を変更できる地図プロパティが変更されるたびに呼び出されます。

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

アクセスするには、const {OverlayView} = await google.maps.importLibrary("maps") または const {OverlayView} = await google.maps.importLibrary("streetView") を呼び出します。詳しくは、Maps JavaScript API のライブラリをご覧ください。

OverlayView
OverlayView()
パラメータ: なし
OverlayView を作成します。
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
パラメータ: 
戻り値: None
要素でのクリック、タップ、ドラッグ、ホイール イベントが地図に表れるのを停止します。これを使用して、地図のドラッグやズーム、地図でのクリック操作を防ぎます。
preventMapHitsFrom
preventMapHitsFrom(element)
パラメータ: 
戻り値: None
地図の上からボタンが表示されるまで、要素のクリックやタップを停止します。地図で「クリック」イベントがトリガーされないようにするために使用します。
draw
draw()
パラメータ: なし
戻り値: None
このメソッドを実装して、オーバーレイを描画または更新します。projection.fromLatLngToDivPixel() からの位置を使用して、MapPanes に対するオーバーレイを正しく配置します。このメソッドは onAdd() の後で呼び出され、ズームや中心が変化したときに呼び出されます。この方法では、計算コストの高い処理はおすすめしません。
getMap
getMap()
パラメータ: なし
戻り値:  Map|StreetViewPanorama
getPanes
getPanes()
パラメータ: なし
戻り値:  MapPanes|null
この OverlayView をレンダリングできるペインを返します。このペインは、API によって onAdd が呼び出されるまで初期化されません。
getProjection
getProjection()
パラメータ: なし
戻り値:  MapCanvasProjection
この OverlayView に関連付けられている MapCanvasProjection オブジェクトを返します。投影は、API によって onAdd が呼び出されるまで初期化されません。
onAdd
onAdd()
パラメータ: なし
戻り値: None
このメソッドは、オーバーレイ DOM 要素を初期化するために実装します。このメソッドは、setMap() が有効なマップで呼び出された後に 1 回呼び出されます。この時点でペインと投影が初期化されます。
onRemove
onRemove()
パラメータ: なし
戻り値: None
このメソッドを実装して、DOM から要素を削除します。このメソッドは、setMap(null) の呼び出し後に 1 回呼び出されます。
setMap
setMap(map)
パラメータ: 
  • mapMap|StreetViewPanorama optional地図またはパノラマ。null の場合、レイヤは削除されます。
戻り値: None
地図またはパノラマにオーバーレイを追加します。
継承: addListenerbindTogetnotifysetsetValuesunbindunbindAll

MapPanes インターフェース

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

floatPane
タイプ:  Element
このペインには、情報ウィンドウが含まれます。このペインは地図オーバーレイの中で最も上にあります。(ペイン 4)
mapPane
タイプ:  Element
このペインは最下層のペインでタイルの上にあります。DOM イベントを受け付けません。(ペイン 0)
markerLayer
タイプ:  Element
このペインにはマーカーが表示されます。DOM イベントを受け付けません。(ペイン 2)
overlayLayer
タイプ:  Element
このペインには、ポリライン、ポリゴン、地面オーバーレイ、タイルレイヤ オーバーレイが含まれます。DOM イベントを受け付けません。(ペイン 1)
overlayMouseTarget
タイプ:  Element
このペインには、DOM イベントを受け取る要素が表示されます。(ペイン 3)

MapCanvasProjection インターフェース

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

このオブジェクトは、draw メソッド内から OverlayView で使用できます。draw を呼び出すまでは、初期化されているとは限りません。

fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
パラメータ: 
  • pixelPoint optional
  • noClampNoWrapboolean optional
戻り値:  LatLng|null
地図のコンテナのピクセル座標から、地理的座標を計算します。
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
パラメータ: 
  • pixelPoint optional
  • noClampNoWrapboolean optional
戻り値:  LatLng|null
ドラッグ可能な地図を含む DIV のピクセル座標から地理座標を計算します。
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
パラメータ: 
戻り値:  Point|null
地図のコンテナ要素内の指定された地理的位置のピクセル座標を計算します。
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
パラメータ: 
戻り値:  Point|null
ドラッグ可能な地図を含む、DOM 要素内で指定された地理的場所を、ピクセル座標で計算します。
getVisibleRegion
getVisibleRegion()
パラメータ: なし
戻り値:  VisibleRegion|null
地図に表示される領域です。地図にサイズがない場合、null を返します。OverlayView が StreetViewPanorama にある場合、null を返します。
getWorldWidth
getWorldWidth()
パラメータ: なし
戻り値:  number
現在のズームレベルにおけるピクセル単位の幅(ピクセル単位)。向首角が 90 度または 270 度の投影の場合、これは Y 軸のピクセルスパンに対応します。