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

OverlayView
OverlayView()
參數:
建立 OverlayView
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
參數:
  • elementElement
傳回值:
停止在元素上按一下、輕觸、拖曳和滾動事件,以對話框圖示到地圖中。使用此功能可以防止地圖拖曳和縮放,以及「點擊」事件。
preventMapHitsFrom
preventMapHitsFrom(element)
參數:
  • elementElement
傳回值:
停止點選或輕觸元素,讓它以對話框向上顯示地圖。藉此防止地圖觸發「點擊」事件。
draw
draw()
參數:
傳回值:
實作此方法以繪製或更新疊加層。使用來自 投影.fromLatLngToDivPixel() 的位置,正確定位疊加層相對於 MapPanes。在 onAdd() 之後會呼叫此方法,在縮放或中心變更時呼叫。我們不建議在這個方法中執行昂貴的運算工作。
getMap
getMap()
參數:
getPanes
getPanes()
參數:
傳回值:MapPanes|null
傳回可轉譯此 OverlayView 的窗格。在 API 呼叫 onAdd 之前,窗格都不會初始化。
getProjection
getProjection()
參數:
傳回與此 OverlayView 相關聯的 MapCanvasProjection 物件。除非 API 呼叫 onAdd,否則系統不會初始化投影。
onAdd
onAdd()
參數:
傳回值:
實作這個方法來初始化疊加層 DOM 元素。在透過有效的地圖呼叫 setMap() 之後,就會呼叫此方法。此時,窗格以及投影就已被初始化。
onRemove
onRemove()
參數:
傳回值:
實作這個方法,從 DOM 移除元素。呼叫 setMap(null) 之後就呼叫此方法。
setMap
setMap(map)
參數:
傳回值:
將疊加層新增至地圖或全景。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll

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])
參數:
  • pixelPoint optional
  • noClampNoWrapboolean optional
傳回值:LatLng|null
從地圖容器中的像素座標計算地理座標。
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
參數:
  • pixelPoint optional
  • noClampNoWrapboolean optional
傳回值: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 軸的像素範圍。