DOM elements

OverlayView クラス

google.maps.OverlayView クラス

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

オーバーレイのプロトタイプ MyOverlay.prototype = new google.maps.OverlayView(); を設定して、このクラスから継承します。OverlayView コンストラクタは必ず空の関数になります。

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

  • onAdd() メソッドで、DOM オブジェクトを作成し、ペインの子として追加する必要があります。
  • draw() メソッドで、これらの要素を配置する必要があります。
  • onRemove() メソッドで、DOM からオブジェクトを削除する必要があります。
onAdd() メソッドの呼び出しをトリガーするには、有効な Map オブジェクトを指定して setMap() を呼び出し、onRemove() メソッドをトリガーするには 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 インターフェース

このオブジェクトは、draw メソッド内から 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 軸のピクセル範囲に対応します。