Advanced Markers

AdvancedMarkerElement

Classe google.maps.marker.AdvancedMarkerElement

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

Observação:o uso como componente da Web (por exemplo, o uso do elemento HTML <gmp-advanced-marker> personalizado, só está disponível no canal v=beta).

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

Essa classe estende HTMLElement.

Essa classe implementa AdvancedMarkerElementOptions.

Acesse chamando 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, a AdvancedMarkerElement será adicionada ao mapa durante a construção.
collisionBehavior
Tipo:  CollisionBehavior optional
Consulte os AdvancedMarkerElementOptions.collisionBehavior.
content
Tipo:  Element optional
Consulte os AdvancedMarkerElementOptions.content.
element
Tipo:  HTMLElement
Este campo é somente leitura. O elemento DOM que sustenta a visualização.
gmpDraggable
Tipo:  boolean optional
Consulte os AdvancedMarkerElementOptions.gmpDraggable.
map
Tipo:  Map optional
Consulte os AdvancedMarkerElementOptions.map.
position
Consulte os AdvancedMarkerElementOptions.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
Consulte os AdvancedMarkerElementOptions.title.
Atributo HTML:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Tipo:  number optional
Consulte os AdvancedMarkerElementOptions.zIndex.
BetaaddEventListener
addEventListener(type, listener[, options])
Parâmetros: 
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent
  • options:  boolean|AddEventListenerOptions optional Veja as opções. Os eventos personalizados são compatíveis apenas com capture e passive.
Valor de retorno:  void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Veja o addEventListener
addListener
addListener(eventName, handler)
Parâmetros: 
  • eventName:  string evento observado.
  • handler:  função Function para gerenciar eventos.
Valor de retorno:  MapsEventListener Listener de evento resultante.
Adiciona a função de escuta especificada ao nome de evento especificado no sistema de eventos do Google Maps.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parâmetros: 
Valor de retorno:  void
Remove do ouvinte do evento um listener de evento registrado anteriormente com addEventListener. Consulte removeEventListener
click
function(event)
Argumentos: 
Este evento é acionado quando o elemento AdvancedMarkerElement é clicado.

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

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

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

Não disponível com o addEventListener().
Betagmp-click
function(event)
Argumentos: 
Este evento é acionado quando o elemento AdvancedMarkerElement é clicado. Melhor utilização com addEventListener() (em vez de addListener()).

AdvancedMarkerElementOptions.

Interface google.maps.marker.AdvancedMarkerElementOptions

Opções para construir um AdvancedMarkerElement.
collisionBehavior optional
Tipo:  CollisionBehavior optional
Uma enumeração que especifica como uma AdvancedMarkerElement precisa se comportar ao colidir com outra AdvancedMarkerElement ou com as etiquetas do mapa básico em um mapa vetorial.

Observação: a colisão de AdvancedMarkerElement com AdvancedMarkerElement funciona em mapas vetoriais e de varredura. No entanto, a colisão de rótulos com base em AdvancedMarkerElement para mapas básicos só funciona em mapas vetoriais.
content optional
Tipo:  Element 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 move o elemento DOM e faz com que o AdvancedMarkerElement anterior pareça vazio.
gmpDraggable optional
Tipo:  boolean optional
Padrão: false
Se true, o AdvancedMarkerElement poderá ser arrastado.

Observação: AdvancedMarkerElement com altitude não é arrastável.
map optional
Tipo:  Map optional
Mapa no qual exibir AdvancedMarkerElement. O mapa é necessário para exibir 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. Uma AdvancedMarkerElement pode ser construída sem uma posição, mas não será exibida até que a posição seja fornecida, por exemplo, por ações ou escolhas do usuário. Para informar a posição de AdvancedMarkerElement, defina AdvancedMarkerElement.position se ele não for fornecido na construção.

Observação: AdvancedMarkerElement com altitude é compatível apenas 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 exibidos no mapa na ordem de zIndex, com os valores maiores exibidos na frente de AdvancedMarkerElements com valores menores. Por padrão, AdvancedMarkerElements são exibidos de acordo com a posição vertical na tela, com AdvancedMarkerElements menores aparecendo na frente de AdvancedMarkerElements mais acima na tela. zIndex também é usado para ajudar a determinar a prioridade relativa entre CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY marcadores avançados. Um valor zIndex maior indica maior prioridade.

AdvancedMarkerClickEvent

Classe google.maps.marker.AdvancedMarkerClickEvent

Este evento é criado a partir do clique em um marcador avançado. Acesse a posição do marcador com event.target.position.

Essa classe estende Event.

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

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 do balão, como mostrado no AdvancedMarkerElement padrão. O glifo é um elemento DOM opcional exibido na forma de balão. Um PinElement pode ter uma proporção diferente dependendo do PinElement.scale.

Observação:ainda não há suporte para o uso como um componente da Web (por exemplo, como uma subclasse do HTMLElement ou via HTML).

Essa classe estende HTMLElement.

Essa classe implementa PinElementOptions.

Acesse chamando const {PinElement} = await google.maps.importLibrary("marker"). Consulte Bibliotecas na API Maps JavaScript.
PinElement
PinElement([options])
Parâmetros: 
background
Tipo:  string optional
Consulte os PinElementOptions.background.
borderColor
Tipo:  string optional
Consulte os PinElementOptions.borderColor.
element
Tipo:  HTMLElement
Este campo é somente leitura. O elemento DOM que sustenta a visualização.
glyph
Tipo:  string|Element|URL optional
Consulte os PinElementOptions.glyph.
glyphColor
Tipo:  string optional
Consulte os PinElementOptions.glyphColor.
scale
Tipo:  number optional
Consulte os PinElementOptions.scale.
BetaaddEventListener
addEventListener(type, listener[, options])
Parâmetros: 
Valor de retorno:  void
Esta função ainda não está disponível para uso.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parâmetros: 
Valor de retorno:  void
Remove do ouvinte do evento um listener de evento registrado anteriormente com addEventListener. Consulte removeEventListener

PinElementOptions.

Interface google.maps.marker.PinElementOptions

Opções para criar um PinElement.
background optional
Tipo:  string optional
A cor do plano de fundo da forma do alfinete. Compatível com qualquer valor de cor CSS.
borderColor optional
Tipo:  string optional
A cor da borda da forma do alfinete. Compatível com qualquer valor de cor CSS.
glyph optional
Tipo:  string|Element|URL optional
O elemento DOM exibido no alfinete.
glyphColor optional
Tipo:  string optional
A cor do glifo. Compatível com qualquer valor de cor CSS.
scale optional
Tipo:  number optional
Padrão: 1
A escala do alfinete.