OverlayView クラス
google.maps.OverlayView クラス
地図上にカスタムタイプのオーバーレイ オブジェクトを表示する場合は、このクラスを実装します。
オーバーレイのプロトタイプ MyOverlay.prototype = new google.maps.OverlayView(); を設定して、このクラスから継承します。OverlayView コンストラクタは空の関数であることが保証されています。onAdd()、draw()、onRemove() の 3 つのメソッドを実装する必要があります。
onAdd()メソッドでは、DOM オブジェクトを作成し、ペインの子として追加する必要があります。draw()メソッドで、これらの要素を配置する必要があります。onRemove()メソッドで、DOM からオブジェクトを削除する必要があります。
onAdd() メソッドと setMap(null) の呼び出しをトリガーして onRemove() メソッドをトリガーするには、有効な 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)パラメータ:
戻り値: なし
要素のクリック、タップ、ドラッグ、ホイール イベントが地図にバブリングアップするのを停止します。地図のドラッグとズーム、地図の「クリック」イベントを防ぐために使用します。 |
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 軸のピクセル範囲に対応します。 |