DOM elements

OverlayView クラス

google.maps.OverlayView クラス

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

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

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

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

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 インターフェース

このオブジェクトは、描画メソッド内から OverlayView で使用できるようになります。draw を呼び出すまでは、初期化されているとは限りません。
fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
パラメータ: 
  • pixel:  Point optional
  • noClampNoWrap:  boolean optional
戻り値:  LatLng|null
地図のコンテナのピクセル座標から、地理的座標を計算します。
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
パラメータ: 
  • pixel:  Point optional
  • noClampNoWrap:  boolean 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 軸のピクセル範囲に対応します。