Advanced Markers

Classe AdvancedMarkerElement

Classe google.maps.marker.AdvancedMarkerElement

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

Observação:o uso como um componente da Web (por exemplo, o 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.

Construtor
AdvancedMarkerElement	AdvancedMarkerElement([options]) Parâmetros: options:  AdvancedMarkerElementOptions optional Cria um AdvancedMarkerElement com as opções especificadas. Se um mapa for especificado, o AdvancedMarkerElement será adicionado a ele durante a construção.

Propriedades
collisionBehavior	Tipo:CollisionBehavior optional Consulte AdvancedMarkerElementOptions.collisionBehavior.
content	Tipo:Node optional Consulte AdvancedMarkerElementOptions.content.
element	Tipo:HTMLElement Este campo é somente leitura. O elemento DOM que oferece suporte à visualização.
gmpClickable	Aviso:disponível apenas no canal v=beta. Tipo:boolean optional Consulte AdvancedMarkerElementOptions.gmpClickable.
gmpDraggable	Tipo:boolean optional Consulte AdvancedMarkerElementOptions.gmpDraggable.
map	Tipo:Map optional Consulte AdvancedMarkerElementOptions.map.
position	Tipo:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Consulte 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 AdvancedMarkerElementOptions.title. Atributo HTML: <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	Tipo:number optional Consulte AdvancedMarkerElementOptions.zIndex.

Métodos
addEventListener	Aviso:disponível apenas no canal v=beta. addEventListener(type, listener[, options]) Parâmetros: type:  string uma string que diferencia maiúsculas de minúsculas que 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 Consulte as 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: eventName:  string 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 de evento especificado no sistema de eventos do Maps.
removeEventListener	Aviso:disponível apenas no canal v=beta. removeEventListener(type, listener[, options]) Parâmetros: type:  string Uma string que especifica o tipo de evento para remover um listener de eventos. listener:  EventListener|EventListenerObject O listener de eventos do gerenciador de eventos a ser removido do destino do evento. options:  boolean|EventListenerOptions optional Consulte as opções. Valor de retorno:void Remove um listener de eventos registrado anteriormente com addEventListener do destino. Consulte removeEventListener.

Eventos
click	function(event) Argumentos:  event:  MapMouseEvent Esse evento é acionado quando o elemento AdvancedMarkerElement é clicado. Não disponível com addEventListener(). Use gmp-click.
drag	function(event) Argumentos:  event:  MapMouseEvent Esse evento é acionado repetidamente enquanto o usuário arrasta o AdvancedMarkerElement. Não disponível com addEventListener().
dragend	function(event) Argumentos:  event:  MapMouseEvent Esse evento é acionado quando o usuário para de arrastar o AdvancedMarkerElement. Não disponível com addEventListener().
dragstart	function(event) Argumentos:  event:  MapMouseEvent Esse evento é acionado quando o usuário começa a arrastar o AdvancedMarkerElement. Não disponível com addEventListener().
gmp-click	Aviso:disponível apenas no canal v=beta. function(event) Argumentos:  event:  AdvancedMarkerClickEvent Esse evento é acionado quando o elemento AdvancedMarkerElement é clicado. É melhor usar addEventListener() (em vez de addListener()).

Interface AdvancedMarkerElementOptions

Interface google.maps.marker.AdvancedMarkerElementOptions

Opções para criar um AdvancedMarkerElement.

Propriedades
collisionBehavior optional	Tipo:CollisionBehavior optional Uma enumeração que especifica como um AdvancedMarkerElement deve se comportar quando entrar em conflito com outro AdvancedMarkerElement ou com os rótulos do mapa base em um mapa vetorial. Observação: o conflito de AdvancedMarkerElement com AdvancedMarkerElement funciona em mapas raster e vetoriais, mas o conflito de AdvancedMarkerElement com o rótulo do mapa de base só funciona em mapas vetoriais.
content optional	Tipo:Node optional Padrão:PinElement.element O elemento DOM que oferece 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.
gmpClickable optional	Aviso:disponível apenas no canal v=beta. Tipo:boolean optional Padrão:false Se true, o AdvancedMarkerElement será clicável e vai acionar o evento gmp-click, com interações pensando na acessibilidade, como permitir a navegação pelo teclado usando as teclas de seta.
gmpDraggable optional	Tipo:boolean optional Padrão:false Se true, o AdvancedMarkerElement pode ser arrastado. Observação: o AdvancedMarkerElement com altitude não é arrastável.
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	Tipo:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Define a posição do AdvancedMarkerElement. Um AdvancedMarkerElement pode ser construído sem uma posição, mas não será exibido até que a posição seja fornecida, por exemplo, por ações ou escolhas do 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 z-index, com valores mais altos aparecendo na frente de AdvancedMarkerElements com valores mais baixos. Por padrão, os AdvancedMarkerElements são mostrados de acordo com a posição vertical na tela, com AdvancedMarkerElements mais baixos aparecendo na frente de AdvancedMarkerElements mais altos na tela. 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 prioridade mais alta.

Classe AdvancedMarkerClickEvent

Classe google.maps.marker.AdvancedMarkerClickEvent

Aviso:disponível apenas no canal v=beta.

Esse evento é criado ao clicar 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.

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 que o 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:o uso como um componente da Web (por exemplo, como uma subclasse HTMLElement ou via HTML) ainda não é aceito.

Essa classe estende HTMLElement.

Essa classe implementa PinElementOptions.

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

Construtor
PinElement	PinElement([options]) Parâmetros: options:  PinElementOptions optional

Propriedades
background	Tipo:string optional Consulte PinElementOptions.background.
borderColor	Tipo:string optional Consulte PinElementOptions.borderColor.
element	Tipo:HTMLElement Este campo é somente leitura. O elemento DOM que oferece suporte à visualização.
glyph	Tipo:string|Element|URL optional Consulte PinElementOptions.glyph.
glyphColor	Tipo:string optional Consulte PinElementOptions.glyphColor.
scale	Tipo:number optional Consulte PinElementOptions.scale.

Métodos
addEventListener	Aviso:disponível apenas no canal v=beta. addEventListener(type, listener[, options]) Parâmetros: type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional Valor de retorno:void Essa função ainda não está disponível para uso.
removeEventListener	Aviso:disponível apenas no canal v=beta. removeEventListener(type, listener[, options]) Parâmetros: type:  string Uma string que especifica o tipo de evento para remover um listener de eventos. listener:  EventListener|EventListenerObject O listener de eventos do gerenciador de eventos a ser removido do destino do evento. options:  boolean|EventListenerOptions optional Consulte as opções. Valor de retorno:void Remove um listener de eventos registrado anteriormente com addEventListener do destino. Consulte removeEventListener.

Interface PinElementOptions

Interface google.maps.marker.PinElementOptions

Opções para criar um PinElement.

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