OverlayView クラス
google.maps.OverlayView
クラス
地図上にカスタム タイプのオーバーレイ オブジェクトを表示する場合は、このクラスを実装できます。
オーバーレイのプロトタイプを設定して、このクラスを継承します: MyOverlay.prototype = new google.maps.OverlayView();
。OverlayView
コンストラクタは、空の関数であることが保証されています。onAdd()
、draw()
、onRemove()
の 3 つのメソッドを実装する必要があります。
onAdd()
メソッドで、DOM オブジェクトを作成してペインの子として追加する必要があります。draw()
メソッドで、これらの要素を配置します。onRemove()
メソッドで、DOM からオブジェクトを削除する必要があります。
onRemove()
メソッドをトリガーするには、onAdd()
メソッドと setMap(null)
の呼び出しをトリガーする有効な 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) パラメータ:
戻り値: None
要素でのクリック、タップ、ドラッグ、ホイール イベントが地図に表れるのを停止します。これを使用して、地図のドラッグやズーム、地図でのクリック操作を防ぎます。 |
preventMapHitsFrom |
preventMapHitsFrom(element) パラメータ:
戻り値: None
地図の上からボタンが表示されるまで、要素のクリックやタップを停止します。地図で「クリック」イベントがトリガーされないようにするために使用します。 |
Methods | |
---|---|
draw |
draw() パラメータ: なし
戻り値: None
このメソッドを実装して、オーバーレイを描画または更新します。projection.fromLatLngToDivPixel() からの位置を使用して、MapPanes に対するオーバーレイを正しく配置します。このメソッドは onAdd() の後で呼び出され、ズームや中心が変化したときに呼び出されます。この方法では、計算コストの高い処理はおすすめしません。 |
getMap |
getMap() パラメータ: なし
戻り値:
Map|StreetViewPanorama |
getPanes |
getPanes() パラメータ: なし
戻り値:
MapPanes|null この OverlayView をレンダリングできるペインを返します。このペインは、API によって onAdd が呼び出されるまで初期化されません。 |
getProjection |
getProjection() パラメータ: なし
戻り値:
MapCanvasProjection この OverlayView に関連付けられている MapCanvasProjection オブジェクトを返します。投影は、API によって onAdd が呼び出されるまで初期化されません。 |
onAdd |
onAdd() パラメータ: なし
戻り値: None
このメソッドは、オーバーレイ DOM 要素を初期化するために実装します。このメソッドは、setMap() が有効なマップで呼び出された後に 1 回呼び出されます。この時点でペインと投影が初期化されます。 |
onRemove |
onRemove() パラメータ: なし
戻り値: None
このメソッドを実装して、DOM から要素を削除します。このメソッドは、setMap(null) の呼び出し後に 1 回呼び出されます。 |
setMap |
setMap(map) パラメータ:
戻り値: None
地図またはパノラマにオーバーレイを追加します。 |
継承:
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 を呼び出すまでは、初期化されているとは限りません。
Methods | |
---|---|
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 軸のピクセルスパンに対応します。 |