WebGL

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

WebGLOverlayView 類別

google.maps.WebGLOverlayView 類別

WebGL 疊加層檢視可直接存取 Google 地圖平台用來轉譯向量基本地圖的 WebGL 轉譯結構定義。使用共用轉譯結構定義,也能享有各種好處,例如具有 3D 建築物幾何圖形的深度遮蔽,以及同步處理基本地圖轉譯的 2D/3D 內容。

透過 WebGL 疊加層檢視畫面,你可以使用 WebGL 或熱門的圖形程式庫 (例如 Three.js 或簡報.gl) 直接將內容新增至地圖。如要使用重疊元素,您可以擴充 google.maps.WebGLOverlayView,並為以下每個生命週期掛鉤提供實作:WebGLOverlayView.onAddWebGLOverlayView.onContextRestoredWebGLOverlayView.onDrawWebGLOverlayView.onContextLostWebGLOverlayView.onRemove

您必須使用有效的 Map 物件呼叫 WebGLOverlayView.setMap,才能觸發對 onAdd() 方法的呼叫和 setMap(null),以便觸發 onRemove() 方法。您可在建構時呼叫 setMap() 方法,或者在移除後,應重新顯示疊加層的時候。當地圖屬性有所變更時,系統會呼叫 onDraw() 方法,例如變焦、置中或地圖類型。WebGLOverlayView 只能新增至含有 MapOptions.mapId 的向量地圖。

這個類別會擴充 MVCObject

WebGLOverlayView
WebGLOverlayView()
參數:
建立 WebGLOverlayView
getMap
getMap()
參數:
傳回值:Map|null|undefined
onAdd
onAdd()
參數:
傳回值:
在繪製不需要先存取 WebGL 轉譯結構定義的疊加層之前,先實作這個方法以擷取或建立中繼資料結構。
onContextLost
onContextLost()
參數:
傳回值:
當算繪結構定義因任何原因而遺失時,系統會呼叫此方法,且您可視需要清除任何現有的 GL 狀態,因為不再需要這麼做。
onContextRestored
onContextRestored(options)
參數:
傳回值:
算繪結構定義可供使用時,系統就會呼叫此方法。可用來初始化或繫結任何 WebGL 狀態,例如著色器或緩衝區物件。
onDraw
onDraw(options)
參數:
  • optionsWebGLDrawOptions 可讓開發人員將內容轉譯至相關聯的 Google 基本地圖。
傳回值:
實作此方法即可直接在地圖上繪製 WebGL 內容。請注意,如果疊加層需要繪製新的頁框,請呼叫 WebGLOverlayView.requestRedraw
onRemove
onRemove()
參數:
傳回值:
當使用 WebGLOverlayView.setMap(null) 從地圖移除疊加層時,系統會呼叫這個方法,且應移除所有中繼物件。
onStateUpdate
onStateUpdate(options)
參數:
傳回值:
實作這個方法來處理轉譯動畫影格外的任何 GL 狀態更新。
requestRedraw
requestRedraw()
參數:
傳回值:
觸發地圖重新繪製頁框。
requestStateUpdate
requestStateUpdate()
參數:
傳回值:
觸發地圖以更新 GL 狀態。
setMap
setMap([map])
參數:
  • mapMap optional存取 div、模型和檢視狀態的地圖。
傳回值:
將疊加層新增至地圖。
已沿用: addListenerbindTogetnotifysetsetValuesunbindunbindAll

WebGLDrawOptions 介面

google.maps.WebGLDrawOptions 介面介面

繪圖選項。

gl
要顯示這個 WebGLOverlayView 的 WebGLrenderContext。
transformer
從相機空間到經緯度座標的矩陣轉換。

WebGLStateOptions 介面

google.maps.WebGLStateOptions 介面介面

GL 狀態選項。

gl
要顯示這個 WebGLOverlayView 的 WebGLrenderContext。

CoordinateTransformer 介面

google.maps.CoordinateTransformer 介面介面

這個介面提供便利的方法,可產生矩陣,以在 Google 基本地圖之上算繪 WebGL 場景。

注意:此物件的參照不得在封裝 WebGLOverlayView.onDraw 呼叫的範圍之外。

fromLatLngAltitude
fromLatLngAltitude(latLngAltitude[, rotations, scale])
參數:
傳回值:Float64Array 搭配 WebGL 使用的 MVP 矩陣。
getCameraParams
getCameraParams()
參數:
傳回值:CameraParams 相機參數

CameraParams 介面

google.maps.CameraParams 介面介面

用於擷取相機參數,例如用於 WebGLOverlayView 的 GL 相機參數。

此介面會擴充 CameraOptions

center
類型:LatLng
heading
類型:number
tilt
類型:number
zoom
類型:number