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)パラメータ:
戻り値: なし
地図またはパノラマにオーバーレイを追加します。 |
継承:
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])パラメータ:
戻り値:
LatLng|null地図のコンテナのピクセル座標から、地理的座標を計算します。 |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap])パラメータ:
戻り値:
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 軸のピクセル範囲に対応します。 |