WebGL

WebGLOverlayView

Clase google.maps.WebGLOverlayView

La vista de superposición de WebGL brinda acceso directo al mismo contexto de renderización de WebGL que usa Google Maps Platform para renderizar el mapa base vectorial. Este uso de un contexto de renderización compartida proporciona beneficios como la oclusión de profundidad con la geometría de los edificios 3D y la capacidad de sincronizar el contenido 2D/3D con la renderización del mapa base.

Con la Vista de superposición de WebGL, puedes agregar contenido a tus mapas directamente con WebGL o bibliotecas de gráficos populares, como Three.js o deck.gl. A fin de usar la superposición, puedes extender google.maps.WebGLOverlayView y proporcionar una implementación para cada uno de los siguientes hooks de ciclo de vida: WebGLOverlayView.onAdd, WebGLOverlayView.onContextRestored, WebGLOverlayView.onDraw, WebGLOverlayView.onContextLost y WebGLOverlayView.onRemove.

Debes llamar a WebGLOverlayView.setMap con un objeto Map válido para activar la llamada al método onAdd() y a setMap(null) a fin de activar el método onRemove(). Se puede llamar al método setMap() en el momento de la construcción o en cualquier momento posterior a la superposición que se debe volver a mostrar después de la eliminación. Cada vez que cambie una propiedad del mapa, se llamará al método onDraw() que podría cambiar la posición del elemento, como el zoom, el centro o el tipo de mapa. WebGLOverlayView solo se puede agregar a un mapa vectorial que tenga un elemento MapOptions.mapId.

Esta clase extiende MVCObject.

WebGLOverlayView
WebGLOverlayView()
Parámetros: ninguno
Crea un WebGLOverlayView.
getMap
getMap()
Parámetros: ninguno
Valor que se muestra: Map|null|undefined
onAdd
onAdd()
Parámetros: ninguno
Valor que se muestra: Ninguno
Implementa este método para recuperar o crear estructuras de datos intermedias antes de dibujar la superposición que no requiere acceso inmediato al contexto de renderización de WebGL.
onContextLost
onContextLost()
Parámetros: ninguno
Valor que se muestra: Ninguno
Se llama a este método cuando el contexto de renderización se pierde por algún motivo, y es donde debes limpiar cualquier estado de GL preexistente, ya que ya no es necesario.
onContextRestored
onContextRestored(options)
Parámetros:
  • optionsWebGLStateOptions que permite a los desarrolladores restablecer el contexto de GL
Valor que se muestra: Ninguno
Se llama a este método una vez que el contexto de renderización está disponible. Úsalo para inicializar o vincular cualquier estado de WebGL, como sombreadores u objetos de búfer.
onDraw
onDraw(options)
Parámetros:
  • options: WebGLDrawOptions que permite a los desarrolladores renderizar contenido en un mapa base de Google asociado
Valor que se muestra: Ninguno
Implementa este método para dibujar contenido WebGL directamente en el mapa. Ten en cuenta que si la superposición necesita un nuevo marco dibujado, llama a WebGLOverlayView.requestRedraw.
onRemove
onRemove()
Parámetros: ninguno
Valor que se muestra: Ninguno
Se llama a este método cuando se quita la superposición del mapa con WebGLOverlayView.setMap(null) y es donde debes quitar todos los objetos intermedios.
onStateUpdate
onStateUpdate(options)
Parámetros:
  • options: WebGLStateOptions que permite a los desarrolladores restablecer el contexto de GL
Valor que se muestra: Ninguno
Implementa este método para controlar las actualizaciones de estado de GL fuera del marco de animación de renderización.
requestRedraw
requestRedraw()
Parámetros: ninguno
Valor que se muestra: Ninguno
Activa el mapa para volver a dibujar un fotograma.
requestStateUpdate
requestStateUpdate()
Parámetros: ninguno
Valor que se muestra: Ninguno
Activa el mapa para actualizar el estado de GL.
setMap
setMap([map])
Parámetros:
  • mapMap optional El mapa para acceder al estado de la división, el modelo y la vista
Valor que se muestra: Ninguno
Agrega la superposición al mapa.
Heredada: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

WebGLDrawOptions.

Interfaz google.maps.WebGLDrawOptions

Opciones de dibujo.

gl
WebGLRenderingContext en el que se renderizará esta WebGLOverlayView.
transformer
Transformación de la matriz desde el espacio de la cámara hasta las coordenadas de latitud y longitud.

WebGLStateOptions.

Interfaz google.maps.WebGLStateOptions

Opciones de estado de GL.

gl
WebGLRenderingContext en el que se renderizará esta WebGLOverlayView.

CoordinateTransformer

Interfaz google.maps.CoordinateTransformer

Esta interfaz proporciona métodos convenientes a fin de generar matrices para renderizar escenas WebGL sobre el mapa base de Google.

Nota: Una referencia a este objeto no debe mantenerse fuera del alcance de la llamada WebGLOverlayView.onDraw de encapsulamiento.

fromLatLngAltitude
fromLatLngAltitude(latLngAltitude[, rotations, scale])
Parámetros:
  • latLngAltitude: LatLngAltitude|LatLngAltitudeLiteral Latitud, longitud y altitud.
  • rotationsFloat32Array optional Es un arreglo que contiene un ángulo de rotación de Euler en grados, en la convención XYZ.
  • scale:  Es el arreglo Float32Array optional que contiene un arreglo escalar XYZ para aplicar al eje cardinal.
Valor que se muestra: Float64Array Es la matriz de MVP que se usará con WebGL.
getCameraParams
getCameraParams()
Parámetros: ninguno
Valor que se muestra: CameraParams parámetros de cámara

CameraParams

Interfaz google.maps.CameraParams

Se usa para recuperar parámetros de cámara, como el de la cámara GL que se usa para WebGLOverlayView.

Esta interfaz extiende CameraOptions.

center
Tipo: LatLng
heading
Tipo: number
tilt
Tipo: number
zoom
Tipo: number