Clase OverlayView
Clase google.maps.OverlayView
Puedes implementar esta clase si deseas mostrar tipos personalizados de objetos superpuestos en el mapa.
Hereda de esta clase configurando el prototipo de tu diseño superpuesto: MyOverlay.prototype = new google.maps.OverlayView();
. Se garantiza que el constructor OverlayView
es 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.
setMap()
con un objeto Map
válido para activar la llamada al método onAdd()
y 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 se deba volver a mostrar la superposición después de quitarla. Luego, se llamará al método draw()
cada vez que cambie una propiedad del mapa que pueda cambiar la posición del elemento, como el zoom, el centro o el tipo de mapa.
Esta clase extiende MVCObject
.
Accede llamando a const {OverlayView} = await google.maps.importLibrary("maps")
o const {OverlayView} = await google.maps.importLibrary("streetView")
.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
OverlayView |
OverlayView() Parámetros: Ninguno
Crea un OverlayView . |
Métodos estáticos | |
---|---|
preventMapHitsAndGesturesFrom |
preventMapHitsAndGesturesFrom(element) Parámetros:
Valor de retorno: Ninguno
Detiene los eventos de clic, toque, arrastre y rueda en el elemento para que no se propaguen al mapa. Úsalo para evitar que se arrastre y se acerque el mapa, así como los eventos de "clic" en el mapa. |
preventMapHitsFrom |
preventMapHitsFrom(element) Parámetros:
Valor de retorno: Ninguno
Evita que el clic o la presión en el elemento se propaguen al mapa. Usa este parámetro para evitar que el mapa active eventos de "clic". |
Métodos | |
---|---|
draw |
draw() Parámetros: Ninguno
Valor de retorno: Ninguno
Implementa este método para dibujar o actualizar la superposición. Usa la posición de projection.fromLatLngToDivPixel() para posicionar correctamente la superposición en relación con MapPanes. Se llama a este método después de onAdd() y cuando cambia el nivel de zoom o el centro. No se recomienda realizar trabajos que requieran muchos recursos de procesamiento en este método. |
getMap |
getMap() Parámetros: Ninguno
Valor de devolución:
Map|StreetViewPanorama |
getPanes |
getPanes() Parámetros: Ninguno
Valor de devolución:
MapPanes|null Devuelve los paneles en los que se puede renderizar este OverlayView. Los paneles no se inicializan hasta que la API llama a onAdd . |
getProjection |
getProjection() Parámetros: Ninguno
Valor de devolución:
MapCanvasProjection Devuelve el objeto MapCanvasProjection asociado a este OverlayView . La proyección no se inicializa hasta que la API llama a onAdd . |
onAdd |
onAdd() Parámetros: Ninguno
Valor de retorno: Ninguno
Implementa este método para inicializar los elementos DOM de la 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, se habrán inicializado los paneles y la proyección. |
onRemove |
onRemove() Parámetros: Ninguno
Valor de retorno: 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 de retorno: Ninguno
Agrega la superposición al mapa o al panorama. |
Heredado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interfaz de MapPanes
Interfaz de google.maps.MapPanes
Propiedades | |
---|---|
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 más bajo 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 el OverlayView
desde el método draw. No se garantiza que se inicialice hasta que se llame a draw.
Métodos | |
---|---|
fromContainerPixelToLatLng |
fromContainerPixelToLatLng(pixel[, noClampNoWrap]) Parámetros:
Valor de devolución:
LatLng|null Calcula las coordenadas geográficas a partir de las coordenadas de píxeles en el contenedor del mapa. |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap]) Parámetros:
Valor de devolución:
LatLng|null Calcula las coordenadas geográficas a partir de las coordenadas de píxeles en el div que contiene el mapa arrastrable. |
fromLatLngToContainerPixel |
fromLatLngToContainerPixel(latLng) Parámetros:
Valor de devolución:
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 de devolución:
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 de devolución:
VisibleRegion|null Es la región visible del mapa. Devuelve null si el mapa no tiene tamaño. Devuelve null si OverlayView está en un StreetViewPanorama. |
getWorldWidth |
getWorldWidth() Parámetros: Ninguno
Valor de devolución:
number Es el ancho del mundo en píxeles en el nivel de zoom actual. En el caso de las proyecciones con un ángulo de orientación de 90 o 270 grados, esto corresponde al intervalo de píxeles en el eje Y. |