DOM elements

Clase OverlayView

Clase google.maps.OverlayView

Puedes implementar esta clase si deseas mostrar tipos personalizados de objetos superpuestos en el mapa.

Para heredar de esta clase, configura el prototipo de tu superposición: MyOverlay.prototype = new google.maps.OverlayView();. Se garantiza que el constructor OverlayView será una función vacía.

Debes implementar tres métodos: onAdd(), draw() y onRemove().

  • En el método onAdd(), debes crear objetos DOM y agregarlos como elementos secundarios de los paneles.
  • En el método draw(), debes posicionar estos elementos.
  • En el método onRemove(), debes quitar los objetos del DOM.
Debes llamar a setMap() con un objeto Map válido para activar la llamada al método onAdd() y a setMap(null) para activar el método onRemove(). Se puede llamar al método setMap() en el momento de la construcción o en cualquier momento posterior cuando la superposición debe volver a mostrarse después de quitarla. Se llamará al método draw() cada vez que cambie una propiedad del mapa que podría modificar la posición del elemento, como el zoom, el centro o el tipo de mapa.

Esta clase extiende MVCObject.

Para acceder, llama a const {OverlayView} = await google.maps.importLibrary("maps") o const {OverlayView} = await google.maps.importLibrary("streetView"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

OverlayView
OverlayView()
Parámetros: Ninguno
Crea un OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
Parámetros: 
Valor que se devuelve: Ninguno
Evita que los eventos de clic, presión, arrastre y rueda del elemento aparezcan en el mapa. Usa esta opción para evitar que se arrastre y haga zoom en el mapa, al igual que los eventos de "clic" en el mapa.
preventMapHitsFrom
preventMapHitsFrom(element)
Parámetros: 
Valor que se devuelve: Ninguno
Deja de presionar o hacer clic en el elemento para que no se muestre en el mapa. Úsalo para evitar que el mapa active eventos de "clic".
draw
draw()
Parámetros: Ninguno
Valor que se devuelve: Ninguno
Implementa este método para dibujar o actualizar la superposición. Usa la posición de proyección.fromLatLngToDivPixel() para posicionar correctamente la superposición en relación con los MapPanes. Se llama a este método después de onAdd(), y se lo llama cuando se cambia el zoom o el centro. No se recomienda hacer un trabajo costoso desde el punto de vista informático con este método.
getMap
getMap()
Parámetros: Ninguno
Valor que se devuelve:  Map|StreetViewPanorama
getPanes
getPanes()
Parámetros: Ninguno
Valor que se devuelve:  MapPanes|null
Muestra los paneles en los que se puede renderizar esta OverlayView. Los paneles no se inicializan hasta que la API llama a onAdd.
getProjection
getProjection()
Parámetros: Ninguno
Valor que se devuelve:  MapCanvasProjection
Muestra el objeto MapCanvasProjection asociado con esta OverlayView. No se inicializa la proyección hasta que la API llame a onAdd.
onAdd
onAdd()
Parámetros: Ninguno
Valor que se devuelve: Ninguno
Implementa este método para inicializar los elementos del DOM de superposición. Se llama a este método una vez después de que se llama a setMap() con un mapa válido. En este punto, ya se habrán inicializado los paneles y la proyección.
onRemove
onRemove()
Parámetros: Ninguno
Valor que se devuelve: Ninguno
Implementa este método para quitar tus elementos del DOM. Se llama a este método una vez después de una llamada a setMap(null).
setMap
setMap(map)
Parámetros: 
Valor que se devuelve: Ninguno
Agrega la superposición al mapa o la panorámica.
Heredado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaz de MapPanes

Interfaz de google.maps.MapPanes

floatPane
Tipo:  Element
Este panel contiene la ventana de información. Se encuentra encima de todas las superposiciones del mapa. (Panel 4).
mapPane
Tipo:  Element
Este panel es el inferior y se encuentra encima de los mosaicos. No recibe eventos del DOM. (Panel 0).
markerLayer
Tipo:  Element
Este panel contiene marcadores. No recibe eventos del DOM. (Panel 2).
overlayLayer
Tipo:  Element
Este panel contiene polilíneas, polígonos, superposiciones de suelo y superposiciones de capas de mosaicos. No recibe eventos del DOM. (Panel 1).
overlayMouseTarget
Tipo:  Element
Este panel contiene elementos que reciben eventos del DOM. (Panel 3).

Interfaz de MapCanvasProjection

Interfaz de google.maps.MapCanvasProjection

Este objeto está disponible para OverlayView desde el método de dibujo. No se garantiza que se inicialice hasta que se llame a draw.

fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
Parámetros: 
  • pixelPoint optional
  • noClampNoWrapboolean optional
Valor que se devuelve:  LatLng|null
Calcula las coordenadas geográficas a partir de coordenadas de píxeles en el contenedor del mapa.
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
Parámetros: 
  • pixelPoint optional
  • noClampNoWrapboolean optional
Valor que se devuelve:  LatLng|null
Calcula las coordenadas geográficas a partir de las coordenadas de píxeles del elemento div que contiene el mapa arrastrable.
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
Parámetros: 
Valor que se devuelve:  Point|null
Calcula las coordenadas de píxeles de la ubicación geográfica determinada en el elemento contenedor del mapa.
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
Parámetros: 
Valor que se devuelve:  Point|null
Calcula las coordenadas de píxeles de la ubicación geográfica determinada en el elemento DOM que contiene el mapa arrastrable.
getVisibleRegion
getVisibleRegion()
Parámetros: Ninguno
Valor que se devuelve:  VisibleRegion|null
Indica la región visible del mapa. Muestra null si el mapa no tiene tamaño. Muestra null si OverlayView está en un StreetViewPanorama.
getWorldWidth
getWorldWidth()
Parámetros: Ninguno
Valor que se devuelve:  number
Es el ancho del mundo en píxeles con el nivel de zoom actual. En el caso de las proyecciones con un ángulo de orientación de 90 o 270 grados, corresponde al intervalo de píxeles del eje Y.