Info Window

Classe InfoWindow

classe google.maps.InfoWindow estende MVCObject
biblioteca "maps", "streetView"

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

const {InfoWindow} = await google.maps.importLibrary("maps");
 ou 
const {InfoWindow} = await google.maps.importLibrary("streetView");
InfoWindow
InfoWindow([opts])
Parâmetros:
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.
isOpen
somente leitura
Tipo: boolean
Verifica se o InfoWindow está aberto.
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 desta 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 desta InfoWindow. Consulte InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parâmetros: nenhum
Valor de retorno: boolean|undefined se a linha de cabeçalho inteira 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 zIndex desta InfoWindow.
open
open([options, anchor])
Parâmetros:
  • options: InfoWindowOpenOptions|Map|StreetViewPanorama optional Um objeto InfoWindowOpenOptions (recomendado) ou o mapa|panorama em que essa InfoWindow será renderizada.
  • anchor: MVCObject|AdvancedMarkerElement optional: a âncora em que o InfoWindow será posicionado. Se a âncora não for nula, o InfoWindow será posicionado no centro superior dela. 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 exponha uma propriedade LatLng position e, opcionalmente, uma propriedade Point anchorPoint para calcular o pixelOffset (consulte InfoWindowOptions). O anchorPoint é o deslocamento da posição da âncora até a ponta da InfoWindow. Recomendamos usar a interface InfoWindowOpenOptions como o único argumento para esse método. Para evitar que o foco do navegador mude ao abrir, defina InfoWindowOpenOptions.shouldFocus como false.
setContent
setContent([content])
Parâmetros:
  • content: string|Element|Text optional O conteúdo que será exibido por essa InfoWindow.
Valor de retorno: nenhum
setHeaderContent
setHeaderContent([headerContent])
Parâmetros:
Valor de retorno: nenhum
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Parâmetros:
Valor de retorno: nenhum
setOptions
setOptions([options])
Parâmetros:
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 Z-index desta 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
close
function()
Argumentos: nenhum
Esse evento é acionado sempre que o InfoWindow é fechado. Por exemplo, isso pode acontecer ao chamar o método InfoWindow.close, pressionar a tecla Esc para fechar a InfoWindow, clicar no botão de fechar ou mover 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 é disparado quando o InfoWindow está totalmente visível. Esse evento não é acionado quando o InfoWindow é movido para fora e depois de volta para a tela.
zindex_changed
function()
Argumentos: nenhum
Esse evento é disparado quando o zIndex do InfoWindow muda.

Interface InfoWindowOptions

interface google.maps.InfoWindowOptions

Objeto InfoWindowOptions usado para definir as propriedades que podem ser definidas em um InfoWindow.
ariaLabel
opcional
Tipo: string optional
AriaLabel a ser atribuído à InfoWindow.
content
opcional
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
opcional
Tipo: boolean optional
Padrão: false
Desativa o deslocamento do mapa para que a InfoWindow fique totalmente visível quando aberta.
headerContent
opcional
Tipo: string|Element|Text optional
O conteúdo a ser exibido na linha de cabeçalho da InfoWindow. 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
opcional
Tipo: boolean optional
Desativa toda a linha de cabeçalho na InfoWindow. Quando definido como verdadeiro, o cabeçalho é removido para que o conteúdo dele e o botão de fechar fiquem ocultos.
maxWidth
opcional
Tipo: number optional
Largura máxima da InfoWindow, independentemente da largura do conteúdo. Esse valor só é considerado se for definido antes de uma chamada para open(). Para mudar a largura máxima ao alterar o conteúdo, chame close(), setOptions() e open().
minWidth
opcional
Tipo: number optional
Largura mínima da InfoWindow, independentemente 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ó é considerado se for definido antes de uma chamada para open(). Para mudar a largura mínima ao alterar o conteúdo, chame close(), setOptions() e open().
pixelOffset
opcional
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
opcional
Tipo: LatLng|LatLngLiteral optional
A LatLng para exibição dessa janela de informações. Se o InfoWindow for aberto com uma âncora, a posição dela será usada.
zIndex
opcional
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 exibidas de acordo com a latitude, com as de latitudes mais baixas aparecendo na frente das de 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
anchor
opcional
A âncora em que o InfoWindow será posicionado. Se a âncora não for nula, o InfoWindow será posicionado no centro superior dela. A InfoWindow será renderizada no mesmo mapa ou panorama que a âncora (quando disponível).
map
opcional
Tipo: Map|StreetViewPanorama optional
O mapa ou panorama em que essa InfoWindow será renderizada.
shouldFocus
opcional
Tipo: boolean optional
Se o foco precisa ou não ser movido na InfoWindow na abertura. Quando essa propriedade não está definida ou está definida como null ou undefined, uma heurística é usada para decidir se o foco deve 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.