Info Window

Classe InfoWindow

Classe google.maps.InfoWindow

Uma sobreposição que parece com uma bolha e é normalmente conectada a um marcador.

Essa classe estende MVCObject.

Acesse chamando const {InfoWindow} = await google.maps.importLibrary("maps") ou const {InfoWindow} = await google.maps.importLibrary("streetView"). Consulte Bibliotecas na API Maps JavaScript.

Construtor

InfoWindow

InfoWindow([opts]) Parâmetros: opts:  InfoWindowOptions optional Cria uma janela de informações com as opções especificadas. Uma InfoWindow pode ser colocada em um mapa em uma posição específica ou acima de um marcador, dependendo das especificações nas opções. A menos que o recurso panorâmico automático esteja desativado, uma InfoWindow movimentará o mapa para se tornar visível quando for aberta. Após a construção de uma InfoWindow, você precisa chamar open para exibi-la no mapa. O usuário pode clicar no botão fechar na InfoWindow para removê-la do mapa, ou o desenvolvedor pode chamar close() para obter o mesmo resultado.

Propriedades
isOpen	Tipo:boolean Verifica se a InfoWindow está aberta.

Métodos
close	close() Parâmetros:nenhum Valor de retorno:nenhum Fecha esta janela de informações removendo-a da estrutura DOM.
focus	focus() Parâmetros:nenhum Valor de retorno:nenhum Define o foco neste InfoWindow. Considere usar esse método com um evento visible para garantir que InfoWindow esteja visível antes de definir o foco nele. Um InfoWindow que não está visível não pode ser focado.
getContent	getContent() Parâmetros:nenhum Valor de retorno:string|Element|Text|null|undefined O conteúdo dessa InfoWindow. O mesmo que foi definido anteriormente como conteúdo.
getHeaderContent	getHeaderContent() Parâmetros:nenhum Valor de retorno:string|Element|Text|null|undefined O conteúdo do cabeçalho dessa InfoWindow. Consulte InfoWindowOptions.headerContent.
getHeaderDisabled	getHeaderDisabled() Parâmetros:nenhum Valor de retorno:boolean|undefined indica se toda a linha de cabeçalho está desativada ou não. Consulte InfoWindowOptions.headerDisabled.
getPosition	getPosition() Parâmetros:nenhum Valor de retorno:LatLng|null|undefined a posição LatLng dessa InfoWindow.
getZIndex	getZIndex() Parâmetros:nenhum Valor de retorno:number o z-index dessa InfoWindow.
open	open([options, anchor]) Parâmetros: options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional Um objeto InfoWindowOpenOptions (recomendado) ou o mapa/panorama em que renderizar essa InfoWindow. anchor:  MVCObject|AdvancedMarkerElement optional A âncora em que essa InfoWindow será posicionada. Se a âncora não for nula, a InfoWindow será posicionada na parte de cima, no centro da âncora. A InfoWindow será renderizada no mesmo mapa ou panorama que a âncora (quando disponível). Valor de retorno:nenhum Abre essa InfoWindow no mapa especificado. Se preferir, uma InfoWindow pode ser associada a uma âncora. Na API principal, a única âncora é a classe Marker. No entanto, uma âncora pode ser qualquer MVCObject que expõe uma propriedade position LatLng e, opcionalmente, uma propriedade anchorPoint de ponto para calcular o pixelOffset (consulte InfoWindowOptions). O anchorPoint é o deslocamento da posição da âncora até a ponta da InfoWindow. É recomendável usar a interface InfoWindowOpenOptions como o único argumento para esse método. Para evitar a mudança do foco do navegador na abertura, defina InfoWindowOpenOptions.shouldFocus como false.
setContent	setContent([content]) Parâmetros: content:  string|Element|Text optional O conteúdo a ser mostrado por essa InfoWindow. Valor de retorno:nenhum
setHeaderContent	setHeaderContent([headerContent]) Parâmetros: headerContent:  string|Element|Text optional O conteúdo do cabeçalho a ser exibido por esta InfoWindow. Consulte InfoWindowOptions.headerContent. Valor de retorno:nenhum
setHeaderDisabled	setHeaderDisabled([headerDisabled]) Parâmetros: headerDisabled:  boolean optional especifica se a linha do cabeçalho inteira será desativada. Consulte InfoWindowOptions.headerDisabled. Valor de retorno:nenhum
setOptions	setOptions([options]) Parâmetros: options:  InfoWindowOptions optional Valor de retorno:nenhum
setPosition	setPosition([position]) Parâmetros: position:  LatLng|LatLngLiteral optional a posição LatLng em que essa InfoWindow será mostrada. Valor de retorno:nenhum
setZIndex	setZIndex(zIndex) Parâmetros: zIndex:  number O índice z para essa InfoWindow. Uma InfoWindow com um Z-index maior será exibida na frente de todas as outras InfoWindows com um Z-index menor. Valor de retorno:nenhum
Herdado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Eventos
close	function() Argumentos:  nenhum Esse evento é acionado sempre que o InfoWindow é fechado. Por exemplo, isso pode ser feito chamando o método InfoWindow.close, pressionando a tecla de escape para fechar a InfoWindow ou clicando no botão de fechar ou movendo a InfoWindow para outro mapa.
closeclick	function() Argumentos:  nenhum Este evento é disparado quando o botão fechar é clicado.
content_changed	function() Argumentos:  nenhum Este evento é disparado quando a propriedade de conteúdo é alterada.
domready	function() Argumentos:  nenhum Esse evento é acionado quando o <div> que contém o conteúdo do InfoWindow é anexado ao DOM. Talvez você queira monitorar este evento se estiver expandindo o conteúdo da sua janela de informações de modo dinâmico.
headercontent_changed	function() Argumentos:  nenhum Esse evento é acionado quando a propriedade headerContent muda.
headerdisabled_changed	function() Argumentos:  nenhum Esse evento é acionado quando a propriedade headerDisabled muda.
position_changed	function() Argumentos:  nenhum Este evento é disparado quando a propriedade de posição é alterada.
visible	function() Argumentos:  nenhum Esse evento é acionado quando o InfoWindow está totalmente visível. Esse evento não é acionado quando InfoWindow é movido para fora e depois de volta para a tela.
zindex_changed	function() Argumentos:  nenhum Esse evento é acionado quando o zIndex do InfoWindow muda.

Interface InfoWindowOptions

Interface google.maps.InfoWindowOptions

Objeto InfoWindowOptions usado para definir as propriedades que podem ser definidas em uma InfoWindow.

Propriedades
ariaLabel optional	Tipo:string optional ARIALabel a ser atribuído à InfoWindow.
content optional	Tipo:string|Element|Text optional Conteúdo a ser exibido na janela de informações. Pode ser um elemento HTML, uma string de texto sem formatação ou uma string contendo HTML. A janela de informações será dimensionada de acordo com o conteúdo. Para definir um tamanho explícito para o conteúdo, defina-o como um elemento HTML com esse tamanho.
disableAutoPan optional	Tipo:boolean optional Padrão:false Desative a movimentação do mapa para que a InfoWindow fique totalmente visível quando for aberta.
headerContent optional	Tipo:string|Element|Text optional O conteúdo a ser mostrado na linha do cabeçalho da InfoWindow. Ele pode ser um elemento HTML ou uma string de texto simples. A janela de informações será dimensionada de acordo com o conteúdo. Para definir um tamanho explícito para o conteúdo do cabeçalho, defina headerContent como um elemento HTML com esse tamanho.
headerDisabled optional	Tipo:boolean optional Desativa toda a linha de cabeçalho no InfoWindow. Quando definido como "true", o cabeçalho é removido para que o conteúdo do cabeçalho e o botão de fechar sejam ocultados.
maxWidth optional	Tipo:number optional Largura máxima da InfoWindow, independentemente da largura do conteúdo. Esse valor só será considerado se for definido antes de uma chamada para open(). Para mudar a largura máxima ao mudar o conteúdo, chame close(), setOptions() e open().
minWidth optional	Tipo:number optional Largura mínima da InfoWindow, independente da largura do conteúdo. Ao usar essa propriedade, é altamente recomendável definir minWidth como um valor menor que a largura do mapa (em pixels). Esse valor só será considerado se for definido antes de uma chamada para open(). Para mudar a largura mínima ao mudar o conteúdo, chame close(), setOptions() e open().
pixelOffset optional	Tipo:Size optional O deslocamento, em pixels, da extremidade da janela de informações a partir do ponto no mapa em cujas coordenadas geográficas está ancorada a janela de informações. Se uma InfoWindow for aberta com uma âncora, o pixelOffset será calculado com base na propriedade anchorPoint da âncora.
position optional	Tipo:LatLng|LatLngLiteral optional A LatLng para exibição dessa janela de informações. Se a InfoWindow for aberta com uma âncora, a posição dela será usada.
zIndex optional	Tipo:number optional Todas as janelas de informações são exibidas no mapa na ordem de seus zIndex, com os valores maiores exibidos na frente de janelas de informações com valores menores. Por padrão, as InfoWindows são mostradas de acordo com a latitude, com as InfoWindows de latitudes mais baixas aparecendo na frente das InfoWindows em latitudes mais altas. As janelas de informações são sempre exibidas na frente dos marcadores.

Interface InfoWindowOpenOptions

Interface google.maps.InfoWindowOpenOptions

Opções para abrir uma InfoWindow

Propriedades
anchor optional	Tipo:MVCObject|AdvancedMarkerElement optional A âncora em que essa InfoWindow será posicionada. Se a âncora não for nula, a InfoWindow será posicionada na parte de cima, no centro da âncora. A InfoWindow será renderizada no mesmo mapa ou panorama que a âncora (quando disponível).
map optional	Tipo:Map|StreetViewPanorama optional O mapa ou panorama em que renderizar essa InfoWindow.
shouldFocus optional	Tipo:boolean optional Define se o foco precisa ou não ser movido na InfoWindow quando ela é aberta. Quando essa propriedade não é definida ou é definida como null ou undefined, uma heurística é usada para decidir se o foco precisa ser movido ou não. Recomendamos definir essa propriedade explicitamente para atender às suas necessidades, já que a heurística está sujeita a mudanças e pode não funcionar bem para todos os casos de uso.