Info Window

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Classe Window

Classe google.maps.InfoWindow

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

Essa classe estende MVCObject.

Ao usar v=beta, ele pode ser acessado chamando const {InfoWindow} = await google.map.importLibrary("maps") ou const {InfoWindow} = await google.map.importLibrary("streetView"). Consulte Bibliotecas na API Maps JavaScript.
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.
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. Use esse método com um evento visible para garantir que o InfoWindow esteja visível antes de focar nele. Uma InfoWindow que não está visível não pode ser focada.
getContent
getContent()
Parâmetros: nenhum
Valor de retorno: string|Element|null|Text|undefined o conteúdo dessa janela de informações. O mesmo que foi definido anteriormente para o conteúdo.
getPosition
getPosition()
Parâmetros: nenhum
Valor de retorno: LatLng|null|undefined a posição de GCLID dessa janela de informações.
getZIndex
getZIndex()
Parâmetros: nenhum
Valor de retorno: number O zIndex dessa janela de informações.
open
open([options, anchor])
Parâmetros:
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional um objeto WindowOpenOptions (recomendado) ou o mapa|panorama em que esta janela de informações será renderizada.
  • anchor:  MVCObject|AdvancedMarkerView optional a âncora à qual essa janela de visualização será posicionada. Se a âncora não for nula, a janela de informações será posicionada na parte central superior da âncora. A janela de informações será renderizada no mesmo mapa ou panorama da â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 position do LatLng e, opcionalmente, uma propriedade do ponto anchorPoint para calcular o pixelOffset (consulte TextViewOptions). O anchorPoint é o deslocamento da posição da âncora para a ponta da janela de informações. É recomendável usar a interface InfoWindowOpenOptions como o único argumento para esse método. Para evitar que o foco do navegador seja alterado ao ser aberto, defina InfoWindowOpenOptions.shouldFocus como false.
setContent
setContent([content])
Parâmetros:
  • content: string|Element|Text optional o conteúdo a ser exibido por essa janela de informações.
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 de GCLID em que essa janela de informações será exibida.
Valor de retorno: nenhum
setZIndex
setZIndex(zIndex)
Parâmetros:
  • zIndex: number O Z-index desta janela de informações. Uma janela com um Z-index maior é exibida na frente de todas as outras com um Z-index menor.
Valor de retorno: nenhum
Herdadas: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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
Este evento é acionado quando o <div> que contém o conteúdo da 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.
position_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade de posição é alterada.
visible
function()
Argumentos:  nenhum
Este evento é acionado quando o InfoWindow está totalmente visível. Este evento não é acionado quando o InfoWindow é deslocado e depois retornado à tela.
zindex_changed
function()
Argumentos:  nenhum
Este evento é disparado quando o zIndex do InfoWindow é alterado.

WindowOptions

Interface google.maps.InfoWindowOptions

Objeto TextViewOptions usado para definir as propriedades que podem ser definidas em uma TextView.
ariaLabel optional
Tipo:string optional
AriaLabel para atribuir à janela de informações.
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 tornar a janela de informações totalmente visível quando ela for aberta.
maxWidth optional
Tipo:number optional
Largura máxima da janela de informações, 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 mudar o conteúdo, chame close(), setOptions() e open().
minWidth optional
Tipo: number optional
Largura mínima da janela de informações, independentemente da largura do conteúdo. Ao usar essa propriedade, recomendamos definir o minWidth com 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 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 janela de informações for aberta com uma âncora, o pixelOffset será calculado a partir da propriedade anchorPoint da âncora.
position optional
Tipo:LatLng|LatLngLiteral optional
A LatLng para exibição dessa janela de informações. Se a janela de informações for aberta com uma âncora, a posição da âncora 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 janelas de informações são exibidas de acordo com a latitude, sendo que as mais baixas aparecem na frente daquelas em latitudes mais altas. As janelas de informações são sempre exibidas na frente dos marcadores.

WindowOpenOptions

Interface google.maps.InfoWindowOpenOptions

Opções para abrir uma janela de informações
anchor optional
A âncora à qual essa TextView será posicionada. Se a âncora não for nula, a janela de informações será posicionada na parte central superior da âncora. A janela de informações será renderizada no mesmo mapa ou panorama da âncora (quando disponível).
map optional
Tipo:Map|StreetViewPanorama optional
O mapa ou panorama na qual renderizar essa janela de informações.
shouldFocus optional
Tipo:boolean optional
Define se o foco precisa ser movido dentro da janela de informações quando for aberto. Quando essa propriedade não é definida ou é definida como null ou undefined, uma heurística é usada para decidir se o foco deve ser movido ou não. É recomendável definir essa propriedade de acordo com suas necessidades, já que a heurística está sujeita a mudanças e pode não funcionar bem em todos os casos de uso.