Advanced Markers

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 componente da Web (por exemplo, o elemento HTML personalizado <gmp-advanced-marker>) está disponível apenas 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 ao mapa durante a construção.

Propriedades
collisionBehavior	Tipo:CollisionBehavior optional Consulte os AdvancedMarkerElementOptions.collisionBehavior.
content	Tipo:Node optional Consulte os AdvancedMarkerElementOptions.content.
element	Tipo:HTMLElement Este campo é somente leitura. O elemento DOM que apoia a visualização.
gmpClickable	Aviso:disponível apenas no canal v=beta. Tipo:boolean optional Consulte os AdvancedMarkerElementOptions.gmpClickable.
gmpDraggable	Tipo:boolean optional Consulte os AdvancedMarkerElementOptions.gmpDraggable.
map	Tipo:Map optional Consulte os AdvancedMarkerElementOptions.map.
position	Tipo:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 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.

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 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 Consulte 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. 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 fornecida ao nome de evento especificado no sistema de eventos do Google 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 de que um listener de eventos será removido. listener:  EventListener|EventListenerObject o listener de eventos do manipulador 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 Este evento é disparado quando o elemento AdvancedMarkerElement é clicado. Indisponível com addEventListener() (use gmp-click).
drag	function(event) Argumentos:  event:  MapMouseEvent Este evento é disparado repetidamente enquanto o usuário arrasta o AdvancedMarkerElement. Indisponível com addEventListener().
dragend	function(event) Argumentos:  event:  MapMouseEvent Este evento é disparado quando o usuário para de arrastar o AdvancedMarkerElement. Indisponível com addEventListener().
dragstart	function(event) Argumentos:  event:  MapMouseEvent Este evento é disparado quando o usuário começa a arrastar o AdvancedMarkerElement. Indisponível com addEventListener().
gmp-click	Aviso:disponível apenas no canal v=beta. function(event) Argumentos:  event:  AdvancedMarkerClickEvent Este evento é disparado quando o elemento AdvancedMarkerElement é clicado. Melhor usado com 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 uma AdvancedMarkerElement precisa se comportar quando colide com outra AdvancedMarkerElement ou com os rótulos do mapa básico em um mapa vetorial. Observação: a colisão de AdvancedMarkerElement a AdvancedMarkerElement funciona em mapas vetoriais e rasterizados. No entanto, AdvancedMarkerElement para a colisão de rótulos do mapa básico só funciona em mapas vetoriais.
content optional	Tipo:Node optional Padrão:PinElement.element O elemento DOM que apoia o visual de uma AdvancedMarkerElement. Observação: AdvancedMarkerElement não clona o elemento DOM transmitido. Depois que o elemento DOM é transmitido para um AdvancedMarkerElement, a transmissão do mesmo elemento DOM para outro AdvancedMarkerElement move o elemento DOM e faz 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 vai ser clicável e acionar o evento gmp-click, além de ser interativo para fins de acessibilidade (por exemplo, permitir a navegação pelo teclado usando as teclas de seta).
gmpDraggable optional	Tipo:boolean optional Padrão:false Se for true, a AdvancedMarkerElement poderá ser arrastada. Observação: AdvancedMarkerElement com altitude não é arrastável.
map optional	Tipo:Map optional Mapa em que o AdvancedMarkerElement será exibido. O mapa é necessário para exibir o AdvancedMarkerElement e pode ser fornecido definindo AdvancedMarkerElement.map se não for informado na construção.
position optional	Tipo:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Define a posição do AdvancedMarkerElement. Uma AdvancedMarkerElement pode ser construída sem uma posição, mas não vai ser mostrada até que a posição 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 esse valor não for informado 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 exibidos no mapa na ordem do zIndex. Os valores mais altos são exibidos na frente de AdvancedMarkerElements com valores menores. Por padrão, as AdvancedMarkerElements são mostradas de acordo com a posição vertical na tela, com AdvancedMarkerElements menores aparecendo à frente de AdvancedMarkerElements mais acima na tela. zIndex também é usado para ajudar a determinar a prioridade relativa entre os Marcadores Avançados do 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 clicando 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. O formato tem o mesmo estilo de balão mostrado no AdvancedMarkerElement padrão. O glifo é um elemento DOM opcional exibido no formato 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 HTMLElement ou por HTML).

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 os PinElementOptions.background.
borderColor	Tipo:string optional Consulte os PinElementOptions.borderColor.
element	Tipo:HTMLElement Este campo é somente leitura. O elemento DOM que apoia 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.

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 Esta 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 de que um listener de eventos será removido. listener:  EventListener|EventListenerObject o listener de eventos do manipulador 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

PinElementOptions

Interface google.maps.marker.PinElementOptions

Opções para criar um PinElement.

Propriedades
background optional	Tipo:string optional A cor 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 pin.
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.