DOM elements

OverlayView 類別

google.maps.OverlayView 類別

如果您想在地圖上顯示自訂類型的疊加層物件，可以導入此類別。

設定疊加層的原型：MyOverlay.prototype = new google.maps.OverlayView();，即可沿用此類別的原型。OverlayView 建構函式保證為空白函式。

您必須實作三種方法：onAdd()、draw() 和 onRemove()。

• 在 onAdd() 方法中，您應該建立 DOM 物件，並做為窗格的子項附加。
• 在 draw() 方法中，您應放置這些元素。
• 在 onRemove() 方法中，您應該從 DOM 中移除物件。

您必須使用有效的 Map 物件呼叫 setMap()，才能觸發對 onAdd() 方法的呼叫和 setMap(null)，以便觸發 onRemove() 方法。可以在建構期間，或在之後移除疊加層時重新顯示時，呼叫 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) 參數：  element：Element 傳回值：無 停止在元素上按一下、輕觸、拖曳和滾動事件，以對話框圖示到地圖中。使用此功能可以防止地圖拖曳和縮放，以及「點擊」事件。
preventMapHitsFrom	preventMapHitsFrom(element) 參數：  element：Element 傳回值：無 停止點選或輕觸元素，讓它以對話框向上顯示地圖。藉此防止地圖觸發「點擊」事件。

方法
draw	draw() 參數：無 傳回值：無 實作此方法以繪製或更新疊加層。使用來自 投影.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() 之後，就會呼叫此方法。此時，窗格以及投影就已被初始化。
onRemove	onRemove() 參數：無 傳回值：無 實作這個方法，從 DOM 移除元素。呼叫 setMap(null) 之後就呼叫此方法。
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 介面

此物件可透過繪圖方法提供給 OverlayView。但在呼叫繪製方法前不保證會初始化。

方法
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) 參數：  latLng：LatLng|LatLngLiteral 傳回值：  Point|null 計算地圖容器元素中特定地理位置的像素座標。
fromLatLngToDivPixel	fromLatLngToDivPixel(latLng) 參數：  latLng：LatLng|LatLngLiteral optional 傳回值：  Point|null 在 DOM 元素 (包含可拖曳的地圖) 的指定地理位置計算像素座標。
getVisibleRegion	getVisibleRegion() 參數：無 傳回值：  VisibleRegion|null 地圖可見的區域。如果地圖沒有大小資訊，則傳回 null。如果 OverlayView 位於 StreetViewPanorama 上，則傳回 null。
getWorldWidth	getWorldWidth() 參數：無 傳回值：  number 目前縮放等級的世界寬度 (以像素為單位)。若是標題角度為 90 或 270 度的投影，這會對應 Y 軸的像素範圍。