Advanced Markers

Classe AdvancedMarkerElement

Classe google.maps.marker.AdvancedMarkerElement

Mostra uma posição em um mapa. O position precisa ser definido para que o AdvancedMarkerElement apareça.

Elemento personalizado:
<gmp-advanced-marker gmp-clickable position="lat,lng" title="string"></gmp-advanced-marker>

Essa classe estende HTMLElement.

Essa classe implementa AdvancedMarkerElementOptions.

Acesse ligando para const {AdvancedMarkerElement} = await google.maps.importLibrary("marker").
Consulte Bibliotecas na API Maps JavaScript.

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parâmetros:
Cria um AdvancedMarkerElement com as opções especificadas. Se um mapa for especificado, o AdvancedMarkerElement será adicionado a ele na construção.
collisionBehavior
Tipo:CollisionBehavior optional
gmpClickable
Tipo:boolean optional
Atributo HTML:
  • <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
gmpDraggable
Tipo:boolean optional
map
Tipo:Map optional
position
Atributo HTML:
  • <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker>
  • <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title
Tipo:string
Atributo HTML:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Tipo:number optional
element
Este campo é somente leitura. O elemento DOM que apoia a visualização.
content
Tipo:Node optional
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • typestring uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listenerEventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • optionsboolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener
addListener
addListener(eventName, handler)
Parâmetros:
  • eventNamestring evento observado.
  • handler:  função Function para processar eventos.
Valor de retorno:MapsEventListener listener de eventos resultante.
Adiciona a função de listener especificada ao nome do evento especificado no sistema de eventos do Maps.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • typestring uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listenerEventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • optionsboolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.
click
function(event)
Argumentos: 
Esse evento é acionado quando o elemento AdvancedMarkerElement é clicado.

Não disponível com addEventListener(). Use gmp-click.
drag
function(event)
Argumentos: 
Esse evento é disparado repetidamente enquanto o usuário arrasta o AdvancedMarkerElement.

Não disponível com addEventListener().
dragend
function(event)
Argumentos: 
Esse evento é disparado quando o usuário para de arrastar o AdvancedMarkerElement.

Não disponível com addEventListener().
dragstart
function(event)
Argumentos: 
Esse evento é disparado quando o usuário começa a arrastar o AdvancedMarkerElement.

Não disponível com addEventListener().
Betagmp-click
function(event)
Argumentos: 
Esse evento é acionado quando o elemento AdvancedMarkerElement é clicado. É melhor usar com addEventListener() (em vez de addListener()).

Interface AdvancedMarkerElementOptions

Interface google.maps.marker.AdvancedMarkerElementOptions

Opções para construir um AdvancedMarkerElement.

collisionBehavior optional
Tipo:CollisionBehavior optional
Uma enumeração que especifica como um AdvancedMarkerElement deve se comportar quando entra em conflito com outro AdvancedMarkerElement ou com os rótulos do mapa básico em um mapa vetorial.

Observação: a detecção de conflitos de AdvancedMarkerElement para AdvancedMarkerElement funciona em mapas rasterizados e vetoriais. No entanto, a detecção de conflitos de AdvancedMarkerElement para rótulos do mapa básico funciona apenas em mapas vetoriais.

content optional
Tipo:Node optional
O elemento DOM que dá suporte ao visual de um AdvancedMarkerElement.

Observação: AdvancedMarkerElement não clona o elemento DOM transmitido. Depois que o elemento DOM é transmitido para um AdvancedMarkerElement, transmitir o mesmo elemento DOM para outro AdvancedMarkerElement vai mover o elemento DOM e fazer com que o AdvancedMarkerElement anterior pareça vazio.

BetagmpClickable optional
Tipo:boolean optional
Padrão:false
Se true, será possível clicar no AdvancedMarkerElement, o que vai acionar o evento gmp-click, com interações pensando na acessibilidade, por exemplo, permitindo a navegação pelo teclado usando as teclas de seta.
gmpDraggable optional
Tipo:boolean optional
Padrão:false
Se true, o AdvancedMarkerElement poderá ser arrastado.

Observação: AdvancedMarkerElement com altitude não pode ser arrastado.

map optional
Tipo:Map optional
Mapa em que o AdvancedMarkerElement será mostrado. O mapa é necessário para mostrar o AdvancedMarkerElement e pode ser fornecido definindo AdvancedMarkerElement.map se não for fornecido na construção.
position optional
Define a posição do AdvancedMarkerElement. Um AdvancedMarkerElement pode ser construído sem uma posição, mas não será exibido até que ela seja fornecida, por exemplo, pelas ações ou escolhas de um usuário. A posição de um AdvancedMarkerElement pode ser fornecida definindo AdvancedMarkerElement.position se não for fornecida na construção.

Observação: AdvancedMarkerElement com altitude só é compatível com mapas vetoriais.

title optional
Tipo:string optional
texto da sobreposição. Se fornecido, um texto de acessibilidade (por exemplo, para uso com leitores de tela) será adicionado ao AdvancedMarkerElement com o valor fornecido.
zIndex optional
Tipo:number optional
Todos os AdvancedMarkerElements são mostrados no mapa na ordem do zIndex. Os valores mais altos aparecem na frente dos AdvancedMarkerElements com valores mais baixos. Por padrão, os AdvancedMarkerElements são mostrados de acordo com a posição vertical na tela. Os AdvancedMarkerElements mais baixos aparecem na frente dos AdvancedMarkerElements mais altos. O zIndex também é usado para determinar a prioridade relativa entre os Marcadores Avançados CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY. Um valor zIndex mais alto indica maior prioridade.

Classe AdvancedMarkerClickEvent

Classe google.maps.marker.AdvancedMarkerClickEvent

Esse evento é criado quando um marcador avançado é clicado. Acesse a posição do marcador com event.target.position.

Essa classe estende Event.

Acesse ligando para const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker").
Consulte Bibliotecas na API Maps JavaScript.

Classe PinElement

Classe google.maps.marker.PinElement

Um PinElement representa um elemento DOM que consiste em uma forma e um glifo. A forma tem o mesmo estilo de balão visto no AdvancedMarkerElement padrão. O glifo é um elemento DOM opcional exibido em forma de balão. Uma PinElement pode ter uma proporção diferente, dependendo da PinElement.scale.

Observação:o uso como um componente da Web (por exemplo, como uma subclasse HTMLElement ou via HTML) ainda não é compatível.

Essa classe estende HTMLElement.

Essa classe implementa PinElementOptions.

Acesse ligando para const {PinElement} = await google.maps.importLibrary("marker").
Consulte Bibliotecas na API Maps JavaScript.

PinElement
PinElement([options])
Parâmetros:
background
Tipo:string optional
borderColor
Tipo:string optional
element
Este campo é somente leitura. O elemento DOM que apoia a visualização.
glyph
Tipo:string|Element|URL optional
glyphColor
Tipo:string optional
scale
Tipo:number optional
BetaaddEventListener
addEventListener(type, listener[, options])
Parâmetros:
Valor de retorno:void
Essa função ainda não está disponível para uso.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • typestring uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listenerEventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • optionsboolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.

Interface PinElementOptions

Interface google.maps.marker.PinElementOptions

Opções para criar um PinElement.

background optional
Tipo:string optional
A cor de fundo da forma do alfinete. Aceita qualquer valor de cor CSS.
borderColor optional
Tipo:string optional
A cor da borda da forma do marcador. Aceita qualquer valor de cor CSS.
glyph optional
Tipo:string|Element|URL optional
O elemento DOM exibido no marcador.
glyphColor optional
Tipo:string optional
É a cor do glifo. Aceita qualquer valor de cor CSS.
scale optional
Tipo:number optional
Padrão:1
A escala do alfinete.