Marker (deprecated)

Classe Marker

classe google.maps.Marker estende MVCObject
biblioteca "marker"

Descontinuado: o google.maps.Marker foi descontinuado em 21 de fevereiro de 2024. Use AdvancedMarkerElement. No momento, não há previsão para desativar o google.maps.Marker, mas recomendamos usar AdvancedMarkerElement em vez dele. Embora o google.maps.Marker continue recebendo correções de bugs para regressões importantes, os bugs atuais não serão resolvidos. Haverá um aviso prévio de pelo menos 12 meses antes que o suporte seja descontinuado. Acesse https://developers.google.com/maps/deprecations para mais detalhes e https://developers.google.com/maps/documentation/javascript/advanced-markers/migration para conferir o guia de migração.

const {Marker} = await google.maps.importLibrary("marker");

Construtor
Marker	Marker([opts]) Parâmetros: opts: MarkerOptions optional Cria um marcador com as opções especificadas. Se um mapa for especificado, o marcador será adicionado ao mapa na construção. A posição precisa ser definida para o marcador ser exibido.

Constantes
MAX_ZINDEX	O índice z padrão máximo que a API designará a um marcador. Você pode definir um índice z mais alto para trazer o marcador para a frente.

Métodos
getAnimation	getAnimation() Parâmetros: nenhum Valor de retorno: Animation|null|undefined Recebe a animação em execução no momento.
getClickable	getClickable() Parâmetros: nenhum Valor de retorno: boolean True se o marcador for clicável. Verifica se o Marker é clicável.
getCursor	getCursor() Parâmetros: nenhum Valor de retorno: string|null|undefined Recebe o tipo de cursor do mouse mostrado ao passar o cursor.
getDraggable	getDraggable() Parâmetros: nenhum Valor de retorno: boolean True se o marcador for arrastável. Recebe o status de arrastável do Marker.
getIcon	getIcon() Parâmetros: nenhum Valor de retorno: string|Icon|Symbol|null|undefined Acesse o ícone do Marker. Consulte os MarkerOptions.icon.
getLabel	getLabel() Parâmetros: nenhum Valor de retorno: MarkerLabel|string|null|undefined Encontre o rótulo do Marker. Consulte os MarkerOptions.label.
getMap	getMap() Parâmetros: nenhum Valor de retorno: Map|StreetViewPanorama|null Acessar o mapa ou o panorama em que o Marker é renderizado.
getOpacity	getOpacity() Parâmetros: nenhum Valor de retorno: number|null|undefined um número entre 0,0 e 1,0. Recebe a opacidade do Marker.
getPosition	getPosition() Parâmetros: nenhum Valor de retorno: LatLng|null|undefined Acesse a posição do Marker.
getShape	getShape() Parâmetros: nenhum Valor de retorno: MarkerShape|null|undefined Recebe o formato do Marker usado para interação. Consulte os MarkerOptions.shape e o MarkerShape.
getTitle	getTitle() Parâmetros: nenhum Valor de retorno: string|null|undefined Recebe o título da dica de Marker. Consulte os MarkerOptions.title.
getVisible	getVisible() Parâmetros: nenhum Valor de retorno: boolean True se o marcador estiver visível. Confira a visibilidade do Marker.
getZIndex	getZIndex() Parâmetros: nenhum Valor de retorno: number|null|undefined zIndex do marcador. Recebe o zIndex do Marker. Consulte os MarkerOptions.zIndex.
setAnimation	setAnimation([animation]) Parâmetros: animation: Animation optional: a animação a ser mostrada. Valor de retorno: nenhum Inicia uma animação. Qualquer animação em andamento será cancelada. As animações atualmente aceitas são: Animation.BOUNCE, Animation.DROP. Transmitir null vai interromper qualquer animação.
setClickable	setClickable(flag) Parâmetros: flag: boolean Se for true, o marcador poderá ser clicado. Valor de retorno: nenhum Define se o Marker é clicável.
setCursor	setCursor([cursor]) Parâmetros: cursor: string optional Tipo de cursor do mouse. Valor de retorno: nenhum Define o tipo de cursor do mouse mostrado ao passar o cursor.
setDraggable	setDraggable(flag) Parâmetros: flag: boolean optional Se for true, o marcador poderá ser arrastado. Valor de retorno: nenhum Define se o Marker é arrastável.
setIcon	setIcon([icon]) Parâmetros: icon: string|Icon|Symbol optional Valor de retorno: nenhum Defina o ícone para o Marker. Consulte os MarkerOptions.icon.
setLabel	setLabel([label]) Parâmetros: label: string|MarkerLabel optional O rótulo pode ser uma string de caracteres ou um objeto MarkerLabel. Valor de retorno: nenhum Defina o rótulo para o Marker. Consulte os MarkerOptions.label.
setMap	setMap(map) Parâmetros: map: Map|StreetViewPanorama optional Valor de retorno: nenhum Renderiza o Marker no mapa ou panorama especificado. Se o mapa estiver definido como null, o marcador será removido.
setOpacity	setOpacity([opacity]) Parâmetros: opacity: number optional Um número entre 0,0 (transparente) e 1,0 (opaco). Valor de retorno: nenhum Defina a opacidade do Marker.
setOptions	setOptions(options) Parâmetros: options: MarkerOptions optional Valor de retorno: nenhum Defina as opções para o Marker.
setPosition	setPosition([latlng]) Parâmetros: latlng: LatLng|LatLngLiteral optional: a nova posição. Valor de retorno: nenhum Defina a posição do Marker.
setShape	setShape([shape]) Parâmetros: shape: MarkerShape optional Valor de retorno: nenhum Defina o formato do Marker usado para interação. Consulte os MarkerOptions.shape e o MarkerShape.
setTitle	setTitle([title]) Parâmetros: title: string optional Valor de retorno: nenhum Defina o título da dica de Marker. Consulte os MarkerOptions.title.
setVisible	setVisible(visible) Parâmetros: visible: boolean Se for true, o marcador vai ficar visível. Valor de retorno: nenhum Defina se o Marker está visível.
setZIndex	setZIndex([zIndex]) Parâmetros: zIndex: number optional Valor de retorno: nenhum Defina o zIndex do Marker. Consulte os MarkerOptions.zIndex.
Herdado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Eventos
animation_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade de animação Marker muda.
click	function(event) Argumentos: event: MapMouseEvent optional Esse evento é acionado quando o ícone Marker é clicado.
clickable_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade clicável Marker muda.
contextmenu	function(event) Argumentos: event: MapMouseEvent optional Esse evento é acionado quando o evento contextmenu do DOM é acionado no Marker.
cursor_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade do cursor Marker muda.
dblclick	function(event) Argumentos: event: MapMouseEvent optional Este evento é acionado quando o ícone Marker é clicado duas vezes.
drag	function(event) Argumentos: event: MapMouseEvent optional Esse evento é disparado repetidamente enquanto o usuário arrasta o Marker.
dragend	function(event) Argumentos: event: MapMouseEvent optional Esse evento é disparado quando o usuário para de arrastar o Marker.
draggable_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade arrastável Marker muda.
dragstart	function(event) Argumentos: event: MapMouseEvent optional Esse evento é disparado quando o usuário começa a arrastar o Marker.
flat_changed	function() Argumentos: nenhum Esse evento é acionado quando a propriedade simples Marker muda.
icon_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade do ícone Marker muda.
mousedown	function(event) Argumentos: event: MapMouseEvent optional Esse evento é acionado para um mousedown no Marker.
mouseout	function(event) Argumentos: event: MapMouseEvent optional Esse evento é acionado quando o mouse sai da área do ícone Marker.
mouseover	function(event) Argumentos: event: MapMouseEvent optional Esse evento é acionado quando o mouse entra na área do ícone Marker.
mouseup	function(event) Argumentos: event: MapMouseEvent optional Esse evento é acionado para um mouseup no Marker.
position_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade de posição Marker muda.
shape_changed	function() Argumentos: nenhum Esse evento é acionado quando a propriedade de forma Marker muda.
title_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade de título Marker muda.
visible_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade visível Marker muda.
zindex_changed	function() Argumentos: nenhum Esse evento é disparado quando a propriedade zIndex do Marker muda.
rightclick	Descontinuado: use o evento Marker.contextmenu para oferecer suporte a padrões de uso, como Control + clique no macOS. function(event) Argumentos: event: MapMouseEvent optional Esse evento é disparado quando o usuário clica com o botão direito do mouse no Marker.

Interface MarkerOptions

interface google.maps.MarkerOptions

Descontinuado: o google.maps.Marker foi descontinuado em 21 de fevereiro de 2024. No lugar, use google.maps.marker.AdvancedMarkerElement. Acesse https://developers.google.com/maps/deprecations para mais detalhes sobre a descontinuação e https://developers.google.com/maps/documentation/javascript/advanced-markers/migration para conferir o guia de migração.

Objeto MarkerOptions usado para definir as propriedades que podem ser definidas em um marcador.

Propriedades
anchorPoint opcional	Tipo: Point optional O deslocamento da posição do marcador até a ponta de um InfoWindow que foi aberto com o marcador como âncora.
animation opcional	Tipo: Animation optional Padrão: null Qual animação deve ser reproduzida quando o marcador for adicionado a um mapa.
clickable opcional	Tipo: boolean optional Padrão: true Se true, o marcador recebe eventos de mouse e de toque.
collisionBehavior opcional	Descontinuado: o collisionBehavior foi descontinuado em julho de 2023. Em vez dela, use AdvancedMarkerElement.collisionBehavior. Aviso: disponível apenas no canal v=beta. Tipo: string|CollisionBehavior optional Padrão: null Defina um comportamento em caso de conflito para marcadores em mapas vetoriais.
crossOnDrag opcional	Tipo: boolean optional Padrão: true Se for false, desativa a cruz que aparece abaixo do marcador ao arrastar.
cursor opcional	Tipo: string optional Padrão: pointer Tipo de cursor do mouse que aparece na focalização.
draggable opcional	Tipo: boolean optional Padrão: false Se for true, o marcador poderá ser arrastado. Observação: se você definir como true, o marcador será clicável mesmo que clickable esteja definido como false.
icon opcional	Tipo: string|Icon|Symbol optional Ícone do primeiro plano. Se uma string for fornecida, ela será tratada como se fosse um Icon com a string como url.
label opcional	Tipo: string|MarkerLabel optional Padrão: null Adiciona um rótulo ao marcador. Um rótulo de marcador é um número ou uma letra que aparece dentro de um marcador. O rótulo pode ser uma string ou um objeto MarkerLabel. Se fornecido e MarkerOptions.title não for fornecido, um texto de acessibilidade (por exemplo, para uso com leitores de tela) será adicionado ao marcador com o texto do rótulo fornecido. No momento, o label é usado apenas para texto de acessibilidade em marcadores não otimizados.
map opcional	Tipo: Map|StreetViewPanorama optional Mapa no qual exibir o marcador. O mapa é necessário para mostrar o marcador e pode ser fornecido com Marker.setMap se não for fornecido na construção do marcador.
opacity opcional	Tipo: number optional Padrão: 1.0 Um número entre 0,0 (transparente) e 1,0 (opaco).
optimized opcional	Tipo: boolean optional A otimização melhora a performance ao renderizar vários marcadores como um único elemento estático. Isso é útil quando muitos marcadores são necessários. Leia mais sobre a otimização de marcadores. Observação: essa otimização não tem efeito para marcadores em mapas vetoriais.
position opcional	Tipo: LatLng|LatLngLiteral optional Define a posição do marcador. Um marcador pode ser construído, mas não exibido até que a posição dele seja fornecida, por exemplo, pelas ações ou escolhas de um usuário. Uma posição de marcador pode ser fornecida com Marker.setPosition se não for fornecida na construção do marcador.
shape opcional	Tipo: MarkerShape optional Definição da região no mapa de imagem usada para os eventos de arrastar/clicar.
title opcional	Tipo: string optional Padrão: undefined texto da sobreposição. Se fornecido, um texto de acessibilidade (por exemplo, para uso com leitores de tela) será adicionado ao marcador com o valor fornecido. No momento, o title é usado apenas para texto de acessibilidade em marcadores não otimizados.
visible opcional	Tipo: boolean optional Padrão: true Se for true, o marcador ficará visível.
zIndex opcional	Tipo: number optional Todos os marcadores são exibidos no mapa na ordem de seus zIndex, com os valores maiores exibidos na frente dos marcadores com valores menores. Por padrão, os marcadores são exibidos de acordo com sua posição vertical na tela, com marcadores inferiores sendo exibidos na frente de marcadores posicionados acima na tela.

Constantes CollisionBehavior

constantes google.maps.CollisionBehavior
biblioteca "marker"

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo CollisionBehaviorString.

const {CollisionBehavior} = await google.maps.importLibrary("marker");

Constantes
OPTIONAL_AND_HIDES_LOWER_PRIORITY	Só mostrar o marcador se ele não se sobrepuser a outros elementos. Em caso de conflito, o marcador com o maior zIndex vai aparecer. Se eles tiverem o mesmo zIndex, aquele com a posição vertical mais abaixo na tela será mostrado.
REQUIRED	Sempre mostrar o marcador, independentemente do conflito. Esse é o comportamento padrão.
REQUIRED_AND_HIDES_OPTIONAL	Sempre mostrar o marcador, independentemente do conflito, e ocultar todos os marcadores OPTIONAL_AND_HIDES_LOWER_PRIORITY ou rótulos que se sobrepuserem a ele.

Interface Icon

interface google.maps.Icon

Uma estrutura que representa uma imagem de ícone de marcador.

Propriedades
url	Tipo: string O URL da planilha de imagem ou sprite.
anchor opcional	Tipo: Point optional A posição em que uma imagem será fixada em relação ao local do marcador no mapa. Por padrão, a âncora está localizada ao longo do ponto central da parte inferior da imagem.
labelOrigin opcional	Tipo: Point optional A origem do rótulo em relação ao canto superior esquerdo da imagem do ícone, se um rótulo for fornecido pelo marcador. Por padrão, a origem fica no ponto central da imagem.
origin opcional	Tipo: Point optional A posição da imagem em um sprite, se houver. Por padrão, a origem fica no canto superior esquerdo da imagem (0, 0).
scaledSize opcional	Tipo: Size optional O tamanho da imagem inteira após o dimensionamento, se houver. Use esta propriedade para aumentar/reduzir uma imagem ou um sprite.
size opcional	Tipo: Size optional O tamanho de exibição da imagem ou do sprite. Quando você usa sprites, deve especificar o tamanho do sprite. Se o tamanho não for fornecido, ele será definido quando a imagem for carregada.

Interface MarkerLabel

interface google.maps.MarkerLabel

Essas opções especificam a aparência de um rótulo de marcador. Um rótulo de marcador é uma string (geralmente um único caractere) que aparece dentro do marcador. Se você estiver usando um marcador personalizado, poderá reposicioná-lo com a propriedade labelOrigin na classe Icon.

Propriedades
text	Tipo: string O texto que será exibido no rótulo.
className opcional	Tipo: string optional Padrão: '' (string vazia) A propriedade className do elemento do rótulo (equivalente ao atributo de classe do elemento). É possível adicionar várias classes CSS separadas por espaços. A cor, o tamanho, o peso e a família da fonte só podem ser definidos pelas outras propriedades de MarkerLabel. As classes CSS não devem ser usadas para mudar a posição ou a orientação do marcador (por exemplo, usando translações e rotações) se você também estiver usando o gerenciamento de colisão de marcadores.
color opcional	Tipo: string optional Padrão: 'black' A cor do texto do rótulo.
fontFamily opcional	Tipo: string optional A família de fontes do texto do rótulo (equivalente à propriedade CSS font-family).
fontSize opcional	Tipo: string optional Padrão: '14px' O tamanho da fonte do texto do rótulo (equivalente à propriedade CSS font-size).
fontWeight opcional	Tipo: string optional A espessura da fonte do texto do rótulo (equivalente à propriedade CSS font-weight).

Interface MarkerShape

interface google.maps.MarkerShape

Esse objeto define a região clicável de uma imagem de marcador. A forma consiste em duas propriedades, type e coord, que definem a região não transparente de uma imagem.

Propriedades
type	Tipo: string Descreve o tipo da forma e pode ser circle, poly ou rect.
coords opcional	Tipo: Array<number> optional O formato desse atributo depende do valor de type e segue a especificação AREA coords do W3, que pode ser encontrada em http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. O atributo coords é uma matriz de números inteiros que especifica a posição em pixels da forma em relação ao canto superior esquerdo da imagem de destino. As coordenadas dependem do valor de type da seguinte maneira:   - circle: coords é [x1,y1,r], em que x1, y2 são as coordenadas do centro do círculo e r é o raio do círculo.   - poly: coords é [x1,y1,x2,y2...xn,yn], em que cada par x,y contém as coordenadas de um vértice do polígono.   - rect: coords é [x1,y1,x2,y2], em que x1,y1 são as coordenadas do canto superior esquerdo do retângulo e x2,y2 são as coordenadas do canto inferior direito do retângulo.

Interface Symbol

interface google.maps.Symbol

Descreve um símbolo, que consiste em um caminho vetorial com estilo. Um símbolo pode ser usado como o ícone de um marcador ou colocado em uma polilinha.

Propriedades
path	Tipo: SymbolPath|string O caminho do símbolo, que é um caminho de símbolo integrado ou um caminho personalizado expresso usando a notação de caminho SVG. Obrigatório.
anchor opcional	Tipo: Point optional Padrão: google.maps.Point(0,0) A posição do símbolo em relação ao marcador ou à polilinha. As coordenadas do caminho do símbolo são convertidas para a esquerda e para cima pelas coordenadas x e y da âncora, respectivamente. A posição é expressa no mesmo sistema de coordenadas que o caminho do símbolo.
fillColor opcional	Tipo: string optional A cor de preenchimento do símbolo. Todas as cores CSS3 são permitidas, exceto cores nomeadas estendidas. Para marcadores de símbolo, o padrão é "preto". Para símbolos em polilinhas, o padrão é a cor do traço da polilinha correspondente.
fillOpacity opcional	Tipo: number optional Padrão: 0 A opacidade do preenchimento do símbolo.
labelOrigin opcional	Tipo: Point optional Padrão: google.maps.Point(0,0) A origem do rótulo em relação à origem do caminho, se o rótulo for fornecido pelo marcador. A origem é expressa no mesmo sistema de coordenadas que o caminho do símbolo. Essa propriedade não é usada para símbolos em polilinhas.
rotation opcional	Tipo: number optional Padrão: 0 O ângulo pelo qual o símbolo deve ser girado, expresso em graus no sentido horário. Um símbolo em um IconSequence em que fixedRotation é false é girado em relação ao ângulo da borda em que está posicionado.
scale opcional	Tipo: number optional O valor da escala do símbolo em tamanho. Para marcadores de símbolo, o padrão é 1. Após o dimensionamento, o símbolo pode ter qualquer tamanho. Para símbolos em uma polilinha, o padrão é a espessura do traço da polilinha. Após o dimensionamento, o símbolo precisa ficar dentro de um quadrado de 22 pixels centralizado na âncora do símbolo.
strokeColor opcional	Tipo: string optional A cor do traço do símbolo. Todas as cores CSS3 são permitidas, exceto cores nomeadas estendidas. Para marcadores de símbolo, o padrão é "preto". Para símbolos em uma polilinha, o padrão é a cor do traço da polilinha.
strokeOpacity opcional	Tipo: number optional A opacidade do traço do símbolo. Para marcadores de símbolo, o padrão é 1. Para símbolos em uma polilinha, o padrão é a opacidade do traço da polilinha.
strokeWeight opcional	Tipo: number optional Padrão: o Symbol.scale do símbolo. A espessura do traço do símbolo.

Constantes SymbolPath

constantes google.maps.SymbolPath
biblioteca "core"

Caminhos de símbolos integrados.

const {SymbolPath} = await google.maps.importLibrary("core");

Constantes
BACKWARD_CLOSED_ARROW	Uma seta fechada apontando para trás.
BACKWARD_OPEN_ARROW	Uma seta aberta apontando para trás.
CIRCLE	Um círculo.
FORWARD_CLOSED_ARROW	Uma seta fechada apontando para a frente.
FORWARD_OPEN_ARROW	Uma seta aberta apontando para a frente.

Constantes de animação

constantes google.maps.Animation
biblioteca "marker"

Animações que podem ser executadas em um marcador. Use o método Marker.setAnimation em Marker ou a opção MarkerOptions.animation para reproduzir uma animação.

const {Animation} = await google.maps.importLibrary("marker");

Constantes
BOUNCE	O marcador salta até que a animação seja interrompida chamando Marker.setAnimation com null.
DROP	O marcador cai da parte de cima do mapa até o local final. A animação termina quando o marcador para de se mover, e Marker.getAnimation retorna null. Geralmente, esse tipo de animação é especificado durante a criação do marcador.