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
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 colocar 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 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 se debe volver a mostrar 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
.
Cuando se usa v=beta
, se puede acceder llamando a const {OverlayView} = await google.map.importLibrary("maps")
o const {OverlayView} = await google.map.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 que se muestra: Ninguno
Evita que los eventos de clic, toque, arrastre y rueda del elemento aparezcan en el cuadro hasta el mapa. Úsalo para evitar los arrastres y el zoom en el mapa, así como los eventos de "clic" en el mapa. |
preventMapHitsFrom |
preventMapHitsFrom(element) Parámetros:
Valor que se muestra: Ninguno
Deja de hacer clic en el elemento para que aparezca en el mapa. Usa esto para evitar que el mapa active eventos de "clic". |
Métodos | |
---|---|
draw |
draw() Parámetros: ninguno
Valor que se muestra: 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 respecto de 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 realizar trabajo de procesamiento costoso en este método. |
getMap |
getMap() Parámetros: ninguno
Valor que se muestra:
Map|StreetViewPanorama |
getPanes |
getPanes() Parámetros: ninguno
Valor que se muestra:
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 muestra:
MapCanvasProjection Muestra el objeto MapCanvasProjection asociado con este OverlayView . La proyección no se inicializa hasta que la API llama a onAdd . |
onAdd |
onAdd() Parámetros: ninguno
Valor que se muestra: 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 llamar a setMap() con un mapa válido. En este punto, los paneles y la proyección se habrán inicializado. |
onRemove |
onRemove() Parámetros: ninguno
Valor que se muestra: 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 muestra: Ninguno
Agrega la superposición al mapa o al panorama. |
Heredada:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
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). |
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 invoque el dibujo.
Métodos | |
---|---|
fromContainerPixelToLatLng |
fromContainerPixelToLatLng(pixel[, noClampNoWrap]) Parámetros:
Valor que se muestra:
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:
Valor que se muestra:
LatLng|null Calcula las coordenadas geográficas a partir de las coordenadas de píxeles en el elemento div que contiene el mapa arrastrable. |
fromLatLngToContainerPixel |
fromLatLngToContainerPixel(latLng) Parámetros:
Valor que se muestra:
Point|null Calcula las coordenadas de píxeles de la ubicación geográfica en cuestión en el elemento contenedor del mapa. |
fromLatLngToDivPixel |
fromLatLngToDivPixel(latLng) Parámetros:
Valor que se muestra:
Point|null Calcula las coordenadas de píxeles de la ubicación geográfica en cuestión en el elemento DOM que contiene el mapa arrastrable. |
getVisibleRegion |
getVisibleRegion() Parámetros: ninguno
Valor que se muestra:
VisibleRegion|null Es la región visible del mapa. Muestra null si el mapa no tiene tamaño. Muestra null si OverlayView está en StreetViewPanorama. |
getWorldWidth |
getWorldWidth() Parámetros: ninguno
Valor que se muestra:
number El ancho del mundo en píxeles con el nivel de zoom actual. Para las proyecciones cuyo ángulo de orientación es de 90 o 270 grados, corresponde al intervalo de píxeles del eje Y. |