Anúncio:em breve, a Plataforma Google Maps vai ter um novo estilo de mapa de base. Essa atualização inclui uma nova paleta de cores padrão, pinos modernizados e melhorias nas experiências de mapa e na usabilidade. Todos os estilos de mapa serão atualizados automaticamente em março de 2025. Para mais informações sobre a disponibilidade e como ativar logo, consulte Novo estilo de mapa para a Plataforma Google Maps.

Esta página foi traduzida pela API Cloud Translation.

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.

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.

Info Window

Classe InfoWindow

Construtor

Propriedades

Métodos

Eventos

Interface InfoWindowOptions

Propriedades

Interface InfoWindowOpenOptions

Propriedades