Info Window

Clase InfoWindow

Clase google.maps.InfoWindow

Es una 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 Bibliotecas de la API de Maps JavaScript.

InfoWindow
InfoWindow([opts])
Parámetros: 
Crea una ventana de información con las opciones proporcionadas. Se puede colocar una ventana de información en un mapa en una posición particular o sobre un marcador, según lo que se especifique en las opciones. A menos que se inhabilite el desplazamiento automático, una ventana de información desplazará el mapa para que se vea cuando se abra. Después de construir un 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 lograr el mismo efecto.
isOpen
Tipo:  boolean
Verifica si el InfoWindow está abierto.
close
close()
Parámetros:  Ninguno
Valor que se muestra:  Ninguno
Cierra este InfoWindow quitándolo de la estructura del DOM.
focus
focus()
Parámetros:  Ninguno
Valor que se muestra:  Ninguno
Enfoque en este InfoWindow. Te recomendamos que uses 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 InfoWindow que no es visible.
getContent
getContent()
Parámetros:  Ninguno
Valor que se muestra:  string|Element|Text|null|undefined El contenido de este InfoWindow. Es igual que lo que se configuró anteriormente como contenido.
getHeaderContent
getHeaderContent()
Parámetros:  Ninguno
Valor que se muestra:  string|Element|Text|null|undefined Es el contenido del encabezado de este InfoWindow. Consulta InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parámetros:  Ninguno
Valor que se muestra:  boolean|undefined Indica si toda la fila del encabezado está inhabilitada o no. Consulta InfoWindowOptions.headerDisabled.
getPosition
getPosition()
Parámetros:  Ninguno
Valor que se muestra:  LatLng|null|undefined La posición LatLng de este InfoWindow.
getZIndex
getZIndex()
Parámetros:  Ninguno
Valor que se muestra:  number El z-index de este InfoWindow.
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 el ancla a la que se posicionará este InfoWindow. Si el ancla no es nulo, la ventana de información se posicionará en la parte superior central de la ancla. La ventana de información se renderizará en el mismo mapa o panorama que la ancla (cuando esté disponible).
Valor que se muestra:  Ninguno
Abre este InfoWindow en el mapa determinado. De manera opcional, se puede asociar una ventana de información 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 LatLng position y, de manera opcional, una propiedad Point anchorPoint para calcular el 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 el único argumento de este método. Para evitar que se cambie el enfoque del navegador cuando se abre, establece InfoWindowOpenOptions.shouldFocus en false.
setContent
setContent([content])
Parámetros: 
  • contentstring|Element|Text optional Es el contenido que mostrará esta ventana de información.
Valor que se muestra:  Ninguno
setHeaderContent
setHeaderContent([headerContent])
Parámetros: 
Valor que se muestra:  Ninguno
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Parámetros: 
Valor que se muestra:  Ninguno
setOptions
setOptions([options])
Parámetros: 
Valor que se muestra:  Ninguno
setPosition
setPosition([position])
Parámetros: 
  • positionLatLng|LatLngLiteral optional Es la posición LatLng en la que se mostrará este InfoWindow.
Valor que se muestra:  Ninguno
setZIndex
setZIndex(zIndex)
Parámetros: 
  • zIndexnumber Es el índice z de este InfoWindow. Se mostrará una ventana de información con un índice z más alto frente a todas las demás ventanas de información con un índice z más bajo.
Valor que se muestra:  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 puede deberse a que se llamó al método InfoWindow.close, se presionó la tecla Escape para cerrar la ventana de información, se hizo clic en el botón de cierre o se movió 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 de contenido.
domready
function()
Argumentos:  Ninguno
Este evento se activa cuando el <div> que contiene el contenido de InfoWindow se adjunta al DOM. Te recomendamos que supervises este evento si compilas 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 de posición.
visible
function()
Argumentos:  Ninguno
Este evento se activa cuando el InfoWindow está completamente visible. Este evento no se activa cuando se desplaza InfoWindow y luego se vuelve a mostrar en la pantalla.
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 InfoWindow.

ariaLabel optional
Tipo:  string optional
Es la etiqueta Aria 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 contiene HTML. El tamaño de InfoWindow se ajustará según el contenido. Para establecer un tamaño explícito para el contenido, configura el contenido como un elemento HTML con ese tamaño.
disableAutoPan optional
Tipo:  boolean optional
Predeterminado: false
Inhabilita el desplazamiento del mapa para que el InfoWindow 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 InfoWindow. Puede ser un elemento HTML o una cadena de texto sin formato. El tamaño de InfoWindow se ajustará según el contenido. Para establecer un tamaño explícito para el contenido del encabezado, establece headerContent como un elemento HTML con ese tamaño.
headerDisabled optional
Tipo:  boolean optional
Inhabilita toda la fila del encabezado en el InfoWindow. Cuando se establece como verdadero, se quita el encabezado para que se oculten el contenido del encabezado y el botón de cierre.
maxWidth optional
Tipo:  number optional
Es el ancho máximo de la ventana de información, independientemente del ancho del contenido. Este valor solo se considera 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, a open().
minWidth optional
Tipo:  number optional
Es el ancho mínimo de la ventana de información, independientemente del ancho del contenido. Cuando uses esta propiedad, te recomendamos que configures minWidth en un valor inferior al ancho del mapa (en píxeles). Este valor solo se considera 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, a open().
pixelOffset optional
Tipo:  Size optional
Es el desplazamiento, en píxeles, de la punta 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 un InfoWindow con un ancla, el pixelOffset se calculará a partir de la propiedad anchorPoint del ancla.
position optional
Tipo:  LatLng|LatLngLiteral optional
Es la LatLng en la que se mostrará esta ventana de información. Si se abre la ventana de información con un ancla, se usará la posición de la ancla.
zIndex optional
Tipo:  number optional
Todas las ventanas de información se muestran en el mapa en 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 de latitudes más bajas aparecen delante de las de latitudes más altas. Las ventanas de información siempre se muestran frente a los marcadores.

Interfaz InfoWindowOpenOptions

Interfaz de google.maps.InfoWindowOpenOptions

Opciones para abrir un InfoWindow

anchor optional
Es el ancla a la 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 de la ancla. La ventana de información se renderizará en el mismo mapa o panorama que la ancla (cuando esté disponible).
map optional
Tipo:  Map|StreetViewPanorama optional
Es el mapa o la panorámica en los 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 se establece o se establece en null o undefined, se usa una heurística para decidir si se debe mover el enfoque 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 puede no funcionar bien para todos los casos de uso.