OverlayView クラス
google.maps.OverlayView
class
extends MVCObject
library "maps", "streetView"
地図上にカスタムタイプのオーバーレイ オブジェクトを表示する場合は、このクラスを実装します。
オーバーレイのプロトタイプを MyOverlay.prototype = new google.maps.OverlayView(); に設定して、このクラスから継承します。OverlayView コンストラクタは、空の関数であることが保証されています。onAdd()、draw()、onRemove() の 3 つのメソッドを実装する必要があります。
onAdd()メソッドでは、DOM オブジェクトを作成し、ペインの子として追加する必要があります。draw()メソッドで、これらの要素を配置する必要があります。onRemove()メソッドでは、DOM からオブジェクトを削除する必要があります。
onAdd() メソッドの呼び出しをトリガーするには、有効な Map オブジェクトを指定して setMap() を呼び出す必要があります。onRemove() メソッドをトリガーするには、setMap(null) を呼び出す必要があります。setMap() メソッドは、作成時に呼び出すことも、削除後にオーバーレイを再表示する必要があるときに呼び出すこともできます。その後、ズーム、中心、地図タイプなど、要素の位置を変更する可能性のある地図プロパティが変更されるたびに、draw() メソッドが呼び出されます。
const {OverlayView} = await google.maps.importLibrary("maps");
const {OverlayView} = await google.maps.importLibrary("streetView");
コンストラクタ | |
|---|---|
OverlayView |
OverlayView()パラメータ: なし
OverlayView を作成します。 |
静的メソッド | |
|---|---|
preventMapHitsAndGesturesFrom |
preventMapHitsAndGesturesFrom(element)パラメータ:
戻り値: なし
要素のクリック、タップ、ドラッグ、ホイール イベントが地図にバブルアップしないようにします。これを使用すると、地図のドラッグとズーム、地図の「クリック」イベントを防止できます。 |
preventMapHitsFrom |
preventMapHitsFrom(element)パラメータ:
戻り値: なし
要素のクリックまたはタップが地図にバブリングされないようにします。これを使用すると、地図で「クリック」イベントがトリガーされるのを防ぐことができます。 |
メソッド | |
|---|---|
draw |
draw()パラメータ: なし
戻り値:
voidこのメソッドを実装して、オーバーレイを描画または更新します。projection.fromLatLngToDivPixel() から取得した位置を使用して、MapPanes を基準としたオーバーレイの位置を正しく設定します。このメソッドは、onAdd() の後に呼び出され、ズームまたは中心が変更されたときに呼び出されます。このメソッドで計算コストの高い処理を行うことはおすすめしません。 |
getMap |
getMap()パラメータ: なし
戻り値:
Map|StreetViewPanorama |
getPanes |
getPanes()パラメータ: なし
戻り値:
MapPanes|nullこの OverlayView をレンダリングできるペインを返します。ペインは、API によって onAdd が呼び出されるまで初期化されません。 |
getProjection |
getProjection()パラメータ: なし
戻り値:
MapCanvasProjectionこの OverlayView に関連付けられている MapCanvasProjection オブジェクトを返します。API によって onAdd が呼び出されるまで、投影は初期化されません。 |
onAdd |
onAdd()パラメータ: なし
戻り値:
voidこのメソッドを実装して、オーバーレイ DOM 要素を初期化します。このメソッドは、有効な地図を指定して setMap() が呼び出された後に 1 回呼び出されます。この時点で、ペインと投影が初期化されています。 |
onRemove |
onRemove()パラメータ: なし
戻り値:
voidこのメソッドを実装して、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 軸のピクセル範囲に対応します。 |