Info Window

Clase InfoWindow

Clase google.maps.InfoWindow

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

Esta clase extiende MVCObject.

Accede llamando a const {InfoWindow} = await google.maps.importLibrary("maps") o const {InfoWindow} = await google.maps.importLibrary("streetView").
Consulta Bibliotecas en la API de Maps JavaScript.

InfoWindow
InfoWindow([opts])
Parámetros: 
Crea una ventana de información con las opciones proporcionadas. Se puede colocar una InfoWindow en un mapa en una posición determinada o sobre un marcador, según lo que se especifique en las opciones. A menos que se inhabilite el desplazamiento lateral automático, una InfoWindow desplazará lateralmente el mapa para hacerse 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 bien el desarrollador puede llamar a close() para obtener el mismo efecto.
isOpen
Tipo:  boolean
Comprueba si la ventana de información está abierta.
close
close()
Parámetros: Ninguno
Valor de retorno: Ninguno
Cierra esta ventana de información quitándola de la estructura del DOM.
focus
focus()
Parámetros: Ninguno
Valor de retorno: Ninguno
Establece el enfoque en este InfoWindow. Te recomendamos que uses este método junto con un evento visible para asegurarte de que InfoWindow esté visible antes de establecer el enfoque en él. No se puede enfocar un InfoWindow que no está visible.
getContent
getContent()
Parámetros: Ninguno
Valor que se muestra:  string|Element|Text|null|undefined El contenido de esta ventana de información. Es el mismo que se estableció anteriormente como contenido.
getHeaderContent
getHeaderContent()
Parámetros: Ninguno
Valor de retorno:  string|Element|Text|null|undefined Es el contenido del encabezado de esta ventana de información. Consulta InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parámetros: Ninguno
Valor de devolución:  boolean|undefined Indica si la fila de encabezado completa está inhabilitada o no. Consulta InfoWindowOptions.headerDisabled.
getPosition
getPosition()
Parámetros: Ninguno
Valor de retorno:  LatLng|null|undefined La posición de LatLng de esta ventana de información.
getZIndex
getZIndex()
Parámetros: Ninguno
Valor que se muestra:  number El zIndex de esta ventana de información.
open
open([options, anchor])
Parámetros: 
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional Un objeto InfoWindowOpenOptions (recomendado) o el mapa|panorama en el que se renderizará esta ventana de información.
  • anchorMVCObject|AdvancedMarkerElement optional Es la ancla en la que se posicionará esta ventana de información. Si el ancla no es nula, 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 anclaje (cuando esté disponible).
Valor de retorno: Ninguno
Abre esta ventana de información en el mapa determinado. De manera opcional, se puede asociar una ventana de información con un ancla. En la API principal, el único elemento de anclaje es la clase Marker. Sin embargo, un ancla puede ser cualquier MVCObject que exponga una propiedad LatLng position y, de manera opcional, una propiedad Point anchorPoint para calcular el pixelOffset (consulta InfoWindowOptions). El anchorPoint es el desplazamiento desde la posición del ancla hasta la esquina de la ventana de información. Se recomienda usar la interfaz InfoWindowOpenOptions como único argumento para este método. Para evitar que se cambie el enfoque del navegador al abrirlo, 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 de retorno: Ninguno
setHeaderContent
setHeaderContent([headerContent])
Parámetros: 
Valor de retorno: Ninguno
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Parámetros: 
Valor de retorno: Ninguno
setOptions
setOptions([options])
Parámetros: 
Valor de retorno: Ninguno
setPosition
setPosition([position])
Parámetros: 
  • positionLatLng|LatLngLiteral optional Es la posición de LatLng en la que se mostrará esta ventana de información.
Valor de retorno: Ninguno
setZIndex
setZIndex(zIndex)
Parámetros: 
  • zIndexnumber Es el índice Z de esta ventana de información. Una ventana de información con un índice z mayor se mostrará delante de todas las demás ventanas de información con un índice z menor.
Valor de retorno: Ninguno
Heredado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argumentos: Ninguno
Este evento se activa cada vez que se cierra el objeto InfoWindow. Por ejemplo, esto podría deberse a una llamada al método InfoWindow.close, a presionar la tecla Escape para cerrar la ventana de información, a hacer clic en el botón de cierre o a 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 cambia la propiedad content.
domready
function()
Argumentos: Ninguno
Este evento se activa cuando el <div> que contiene el contenido del InfoWindow se adjunta al DOM. Te recomendamos que supervises este evento si estás creando el contenido de la ventana de información de forma dinámica.
headercontent_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad headerContent.
headerdisabled_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad headerDisabled.
position_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad position.
visible
function()
Argumentos: Ninguno
Este evento se activa cuando el elemento InfoWindow es completamente visible. Este evento no se activa cuando InfoWindow se desplaza fuera de la pantalla y luego vuelve a aparecer.
zindex_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia el zIndex de InfoWindow.

Interfaz InfoWindowOptions

Interfaz de google.maps.InfoWindowOptions

Objeto InfoWindowOptions que se usa para definir las propiedades que se pueden establecer en un objeto InfoWindow.

ariaLabel optional
Tipo:  string optional
Es la etiqueta ariaLabel que se asignará a la ventana de información.
content optional
Tipo:  string|Element|Text optional
Es el 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. El tamaño de la ventana de información se ajustará según el contenido. Para establecer un tamaño explícito para el contenido, configúralo como un elemento HTML con ese tamaño.
disableAutoPan optional
Tipo:  boolean optional
Predeterminado: false
Inhabilita el desplazamiento panorámico del mapa para que la ventana de información sea completamente visible cuando se abra.
headerContent optional
Tipo:  string|Element|Text optional
Es el contenido que se mostrará en la fila del encabezado de la ventana de información. Puede ser un elemento HTML o una cadena de texto sin formato. El tamaño de la ventana de información se ajustará según el contenido. Para establecer un tamaño explícito para el contenido del encabezado, configura headerContent como un elemento HTML con ese tamaño.
headerDisabled optional
Tipo:  boolean optional
Inhabilita toda la fila del encabezado en la ventana de información. Cuando se establece como verdadero, se quita el encabezado para que se oculte el contenido del encabezado y el botón de cierre.
maxWidth optional
Tipo:  number optional
Ancho máximo de la ventana de información, independientemente del ancho del contenido. Este valor solo se tiene en cuenta si se establece antes de una llamada a open(). Para cambiar el ancho máximo cuando cambias el contenido, llama a close(), setOptions() y, luego, open().
minWidth optional
Tipo:  number optional
Ancho mínimo de la ventana de información, independientemente del ancho del contenido. Cuando uses esta propiedad, te recomendamos que establezcas minWidth en un valor inferior al ancho del mapa (en píxeles). Este valor solo se tiene en cuenta si se establece antes de una llamada a open(). Para cambiar el ancho mínimo cuando cambias el contenido, llama a close(), setOptions() y, luego, open().
pixelOffset optional
Tipo:  Size optional
Es el desplazamiento, en píxeles, de la esquina de la ventana de información desde el punto del mapa en cuyas coordenadas geográficas se fija la ventana de información. Si se abre una ventana de información con un ancla, el pixelOffset se calculará a partir de la propiedad anchorPoint del ancla.
position optional
Tipo:  LatLng|LatLngLiteral optional
Es el objeto LatLng en el que se mostrará esta ventana de información. Si la ventana de información se abre con un ancla, se usará la posición del ancla.
zIndex optional
Tipo:  number optional
Todas las ventanas de información se muestran en el mapa en el orden de su zIndex, y los valores más altos se muestran delante de las ventanas de información con valores más bajos. De forma predeterminada, las ventanas de información se muestran según su latitud, y las ventanas de información de latitudes más bajas aparecen delante de las ventanas de información de latitudes más altas. Las ventanas de información siempre se muestran delante de los marcadores.

Interfaz InfoWindowOpenOptions

Interfaz de google.maps.InfoWindowOpenOptions

Opciones para abrir una ventana de información

anchor optional
Es la posición de anclaje en la que se ubicará esta ventana de información. Si el ancla no es nula, 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 anclaje (cuando esté disponible).
map optional
Tipo:  Map|StreetViewPanorama optional
Es el mapa o la panorámica en la que se 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 está establecida o cuando se establece en null o undefined, se usa una heurística para decidir si se debe mover el enfoque. Se recomienda que configures esta propiedad de forma explícita para que se ajuste a tus necesidades, ya que la heurística está sujeta a cambios y es posible que no funcione bien para todos los casos de uso.