Info Window

Clase InfoWindow

Clase google.maps.InfoWindow

Superposición que parece una burbuja y, a menudo, está conectada a un marcador.

Esta clase extiende MVCObject.

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

InfoWindow
InfoWindow([opts])
Parámetros: 
Crea una ventana de información con las opciones determinadas. Las ventanas de información se pueden colocar en el mapa en una posición determinada o encima de un marcador, según lo que se especifique en las opciones. A menos que el desplazamiento lateral automático esté inhabilitado, una ventana de información desplaza el mapa para que sea visible cuando se abra. Después de construir un objeto InfoWindow, debes llamar a open para mostrarlo en el mapa. El usuario puede hacer clic en el botón de cierre de la ventana de información para quitarla del mapa, o el desarrollador puede llamar a cerrar() para obtener el mismo efecto.
close
close()
Parámetros: Ninguno
Valor que se devuelve: Ninguno
Cierra esta ventana de información quitándola de la estructura del DOM.
focus
focus()
Parámetros: Ninguno
Valor que se devuelve: Ninguno
Establece el foco en este InfoWindow. Te recomendamos que consideres usar este método junto con un evento visible para asegurarte de que InfoWindow sea visible antes de establecer el enfoque en él. No se puede enfocar un elemento InfoWindow que no es visible.
getContent
getContent()
Parámetros: Ninguno
Valor que se muestra:  string|Element|Text|null|undefined Es el contenido de esta ventana de información. Es igual que el contenido que se configuró anteriormente.
getPosition
getPosition()
Parámetros: Ninguno
Valor que se muestra:  LatLng|null|undefined: Es la posición LatLng de este InfoWindow.
getZIndex
getZIndex()
Parámetros: Ninguno
Valor que se muestra:  number: Es el zIndex de esta ventana de información.
open
open([options, anchor])
Parámetros: 
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional Es un objeto InfoWindowOpenOptions (recomendado) o el mapa|panorama en el que se renderiza esta InfoWindow.
  • anchorMVCObject|AdvancedMarkerElement optional Es el anclaje en el que se posicionará esta ventana de información. Si el ancla no es nulo, la ventana de información se posicionará en la parte superior central del ancla. La ventana de información se renderizará en el mismo mapa o panorámica que el ancla (cuando esté disponible).
Valor que se devuelve: Ninguno
Abre esta ventana de información en el mapa determinado. De manera opcional, se puede asociar un elemento InfoWindow con un ancla. En la API principal, el único ancla es la clase Marker. Sin embargo, un ancla puede ser cualquier MVCObject que exponga una propiedad position de LatLng y, opcionalmente, una propiedad anchorPoint de Point para calcular pixelOffset (consulta InfoWindowOptions). anchorPoint es el desplazamiento desde la posición del ancla hasta la punta de la ventana de información. Se recomienda usar la interfaz InfoWindowOpenOptions como argumento único para este método. Para evitar cambiar el enfoque del navegador cuando esté abierto, establece InfoWindowOpenOptions.shouldFocus en false.
setContent
setContent([content])
Parámetros: 
  • contentstring|Element|Text optional Es el contenido que se mostrará en esta ventana de información.
Valor que se devuelve: Ninguno
setOptions
setOptions([options])
Parámetros: 
Valor que se devuelve: Ninguno
setPosition
setPosition([position])
Parámetros: 
  • positionLatLng|LatLngLiteral optional Es la posición de LatLng en la que se muestra esta InfoWindow.
Valor que se devuelve: Ninguno
setZIndex
setZIndex(zIndex)
Parámetros: 
  • zIndexnumber Es el índice z de esta ventana de información. Se mostrará una ventana de información con un índice z mayor delante de todas las demás ventanas de información con un índice z más bajo.
Valor que se devuelve: Ninguno
Heredado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argumentos: Ninguno
Este evento se activa cada vez que se cierra InfoWindow. Por ejemplo, esto podría deberse a llamar al método InfoWindow.close, presionar la tecla Escape para cerrar la ventana de información, hacer clic en el botón para cerrar o mover la ventana de información a otro mapa.
closeclick
function()
Argumentos: Ninguno
Este evento se activa cuando se hace clic en el botón de cierre.
content_changed
function()
Argumentos: Ninguno
Este evento se activa cuando la propiedad de contenido cambia.
domready
function()
Argumentos: Ninguno
Este evento se activa cuando la <div> que contiene el contenido de InfoWindow se adjunta al DOM. Te recomendamos que supervises este evento si creas el contenido de la ventana de información de forma dinámica.
position_changed
function()
Argumentos: Ninguno
Este evento se activa cuando la propiedad de posición cambia.
visible
function()
Argumentos: Ninguno
Este evento se activa cuando InfoWindow está completamente visible. Este evento no se activa cuando InfoWindow se desplaza lateralmente y vuelve a aparecer en la pantalla.
zindex_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia el zIndex de InfoWindow.

InfoWindowOptions

Interfaz de google.maps.InfoWindowOptions

InfoWindowOptions, que se usa para definir las propiedades que se pueden configurar en un objeto InfoWindow.

ariaLabel optional
Tipo:  string optional
AriaLabel para asignarla a la ventana de información.
content optional
Tipo:  string|Element|Text optional
Contenido que se mostrará en la ventana de información. Puede ser un elemento HTML, una cadena de texto sin formato o una cadena que contenga HTML. Se ajustará el tamaño de la ventana de información según el contenido. Para establecer un tamaño explícito en el contenido, configúralo como un elemento HTML con ese tamaño.
disableAutoPan optional
Tipo:  boolean optional
Valor predeterminado: false
Inhabilita el desplazamiento lateral del mapa para que el elemento InfoWindow sea completamente visible cuando se abra.
maxWidth optional
Tipo:  number optional
Es el ancho máximo del elemento InfoWindow, sin importar el ancho del contenido. Este valor solo se considera si se configura antes de una llamada a open(). Para cambiar el ancho máximo cuando cambies el contenido, llama a close(), setOptions() y, luego, a open().
minWidth optional
Tipo:  number optional
Es el ancho mínimo del elemento InfoWindow, sin importar el ancho del contenido. Cuando uses esta propiedad, se recomienda establecer minWidth en un valor inferior al ancho del mapa (en píxeles). Este valor solo se considera si se configura antes de una llamada a open(). Para cambiar el ancho mínimo cuando cambies el contenido, llama a close(), setOptions() y, luego, a open().
pixelOffset optional
Tipo:  Size optional
Desplazamiento, en píxeles, de la punta de la ventana de información a partir del punto del mapa en cuyas coordenadas geográficas está anclada. Si se abre una InfoWindow con un ancla, el pixelOffset se calculará a partir de la propiedad anchorPoint del ancla.
position optional
Tipo:  LatLng|LatLngLiteral optional
El objeto LatLng en el que se muestra esta InfoWindow. Si se abre InfoWindow con un ancla, se usará su posición.
zIndex optional
Tipo:  number optional
Todas las InfoWindows se muestran en el mapa en el orden de su zIndex, y los valores más altos se muestran delante de InfoWindows con valores más bajos. De forma predeterminada, los InfoWindows se muestran según su latitud, y los InfoWindows de latitudes inferiores aparecen delante de InfoWindows en latitudes más altas. Siempre se muestran InfoWindows delante de los marcadores.

InfoWindowOpenOptions

Interfaz de google.maps.InfoWindowOpenOptions

Opciones para abrir una ventana de información

anchor optional
El anclaje en el que se posicionará esta ventana de información. Si el ancla no es nulo, la ventana de información se posicionará en la parte superior central del ancla. La ventana de información se renderizará en el mismo mapa o panorámica que el ancla (cuando esté disponible).
map optional
Tipo:  Map|StreetViewPanorama optional
El mapa o la panorámica en los que se debe renderizar esta ventana de información.
shouldFocus optional
Tipo:  boolean optional
Indica si el foco debe moverse o no dentro de la ventana de información cuando se abre. Cuando esta propiedad no se establece o se establece en null o undefined, se usa una heurística para decidir si el foco se debe mover o no. Se recomienda configurar esta propiedad de forma explícita para que se adapte a tus necesidades, ya que la heurística está sujeta a cambios y es posible que no funcione bien en todos los casos de uso.