Marker

Classe Marker

Classe google.maps.Marker

Essa classe estende MVCObject.

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

Marker
Marker([opts])
Parâmetros:
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.
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.
getAnimation
getAnimation()
Parâmetros:nenhum
Valor de retorno:  Animation|null|undefined
Acessa a animação em execução no momento.
getClickable
getClickable()
Parâmetros:nenhum
Valor de retorno:  boolean "Verdadeiro" se o marcador for clicável.
Extrai o status clicável da Marker.
getCursor
getCursor()
Parâmetros:nenhum
Valor de retorno:  string|null|undefined
Faz com que o tipo de cursor do mouse seja mostrado ao passar o cursor.
getDraggable
getDraggable()
Parâmetros:nenhum
Valor de retorno:  boolean "True" se o marcador for arrastável.
Acessa o status arrastável da Marker.
getIcon
getIcon()
Parâmetros:nenhum
Valor de retorno:  string|Icon|Symbol|null|undefined
Encontre o ícone da Marker. Consulte os MarkerOptions.icon.
getLabel
getLabel()
Parâmetros:nenhum
Valor de retorno:  MarkerLabel|string|null|undefined
Receba o rótulo da Marker. Consulte os MarkerOptions.label.
getMap
getMap()
Parâmetros:nenhum
Valor de retorno:  Map|StreetViewPanorama
Acesse o mapa ou o panaroama em que o Marker foi renderizado.
getOpacity
getOpacity()
Parâmetros:nenhum
Valor de retorno:  number|null|undefined um número entre 0,0 e 1,0.
Acesse a opacidade da Marker.
getPosition
getPosition()
Parâmetros:nenhum
Valor de retorno:  LatLng|null|undefined
Encontre a posição do Marker.
getShape
getShape()
Parâmetros:nenhum
Valor de retorno:  MarkerShape|null|undefined
Descubra o formato do Marker usado para interação. Consulte MarkerOptions.shape e MarkerShape.
getTitle
getTitle()
Parâmetros:nenhum
Valor de retorno:  string|null|undefined
Encontre o título da dica Marker. Consulte os MarkerOptions.title.
getVisible
getVisible()
Parâmetros:nenhum
Valor de retorno:boolean "true" se o marcador estiver visível.
Conseguir a visibilidade do Marker.
getZIndex
getZIndex()
Parâmetros:nenhum
Valor de retorno:  number|null|undefined zIndex do marcador.
Acessa o zIndex da Marker. Consulte os MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parâmetros:
  • animationAnimation optional a animação a ser reproduzida.
Valor de retorno: nenhum
Inicia uma animação. Qualquer animação em andamento será cancelada. As animações compatíveis no momento são: Animation.BOUNCE, Animation.DROP. Transmitir null fará com que qualquer animação seja interrompida.
setClickable
setClickable(flag)
Parâmetros:
  • flagboolean se true, o marcador poderá ser clicado.
Valor de retorno: nenhum
Defina se o Marker for clicável.
setCursor
setCursor([cursor])
Parâmetros:
  • cursorstring optional tipo de cursor do mouse.
Valor de retorno: nenhum
Defina o tipo de cursor do mouse mostrado ao passar o cursor.
setDraggable
setDraggable(flag)
Parâmetros:
  • flagboolean optional se true, o marcador poderá ser arrastado.
Valor de retorno: nenhum
Defina se o Marker for arrastável.
setIcon
setIcon([icon])
Parâmetros:
Valor de retorno: nenhum
Defina o ícone do Marker. Consulte os MarkerOptions.icon.
setLabel
setLabel([label])
Parâmetros:
Valor de retorno: nenhum
Defina o rótulo do Marker. Consulte os MarkerOptions.label.
setMap
setMap(map)
Parâmetros:
Valor de retorno: nenhum
Renderiza Marker no mapa ou panorama especificado. Se o mapa estiver definido como null, o marcador será removido.
setOpacity
setOpacity([opacity])
Parâmetros:
  • opacitynumber optional um número entre 0,0 (transparente) e 1,0 (opaco).
Valor de retorno: nenhum
Defina a opacidade da Marker.
setOptions
setOptions(options)
Parâmetros:
Valor de retorno: nenhum
Defina as opções do Marker.
setPosition
setPosition([latlng])
Parâmetros:
Valor de retorno: nenhum
Defina a posição da Marker.
setShape
setShape([shape])
Parâmetros:
Valor de retorno: nenhum
Defina a forma do Marker usado para interação. Consulte MarkerOptions.shape e MarkerShape.
setTitle
setTitle([title])
Parâmetros:
  • titlestring optional
Valor de retorno: nenhum
Defina o título da dica Marker. Consulte os MarkerOptions.title.
setVisible
setVisible(visible)
Parâmetros:
  • visibleboolean se true, o marcador fica visível
Valor de retorno: nenhum
Defina se a Marker estiver visível.
setZIndex
setZIndex([zIndex])
Parâmetros:
  • zIndexnumber optional
Valor de retorno: nenhum
Define o zIndex da Marker. Consulte os MarkerOptions.zIndex.
Herdadas:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
animation_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade de animação Marker é alterada.
click
function(event)
Argumentos: 
Este evento é disparado quando o ícone Marker é clicado.
clickable_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade clicável Marker é alterada.
contextmenu
function(event)
Argumentos: 
Este evento é disparado quando o evento contextmenu do DOM é disparado no Marker
cursor_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade de cursor Marker é alterada.
dblclick
function(event)
Argumentos: 
Este evento é disparado quando o ícone Marker é clicado duas vezes.
drag
function(event)
Argumentos: 
Este evento é disparado repetidamente enquanto o usuário arrasta o Marker.
dragend
function(event)
Argumentos: 
Este evento é disparado quando o usuário para de arrastar o Marker.
draggable_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade arrastável Marker é alterada.
dragstart
function(event)
Argumentos: 
Este evento é disparado quando o usuário começa a arrastar o Marker.
flat_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade simples Marker é alterada.
icon_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade do ícone Marker é alterada.
mousedown
function(event)
Argumentos: 
Este evento é disparado para mousedown na Marker.
mouseout
function(event)
Argumentos: 
Este evento é disparado quando o mouse sai da área do ícone Marker.
mouseover
function(event)
Argumentos: 
Este evento é disparado quando o mouse entra na área do ícone Marker.
mouseup
function(event)
Argumentos: 
Este evento é disparado para um mouseup no Marker.
position_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade de posição Marker é alterada.
shape_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade de forma Marker é alterada.
title_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade de título Marker é alterada.
visible_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade visível Marker é alterada.
zindex_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade zIndex Marker é alterada.
rightclick
function(event)
Argumentos: 
Este evento é disparado para um clique com o botão direito do mouse no Marker.

Interface MarkerOptions

Interface google.maps.MarkerOptions

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

anchorPoint optional
Tipo:Point optional
O deslocamento da posição do marcador para a dica de uma janela de informações que foi aberta com o marcador como âncora.
animation optional
Tipo:Animation optional
Padrão:null
Qual animação deve ser reproduzida quando o marcador for adicionado a um mapa.
clickable optional
Tipo:boolean optional
Padrão:true
Se for true, o marcador receberá eventos de mouse e de toque.
BetacollisionBehavior optional
Tipo:string|CollisionBehavior optional
Padrão:null
Defina um comportamento de conflito para marcadores em mapas vetoriais.
crossOnDrag optional
Tipo:boolean optional
Padrão:true
Se o valor for false, desativa a cruz que aparece abaixo do marcador ao arrastar.
cursor optional
Tipo:string optional
Padrão:pointer
Tipo de cursor do mouse a ser exibido ao passar o cursor.
draggable optional
Tipo:boolean optional
Padrão:false
Se definido como true, o marcador poderá ser arrastado.
icon optional
Tipo:string|Icon|Symbol optional
Ícone para o primeiro plano. Se uma string for fornecida, ela será tratada como se fosse um Icon com a string como url.
label optional
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 dele. O rótulo pode ser uma string ou um objeto MarkerLabel. Se fornecido e MarkerOptions.title não, 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 de marcadores não otimizados.
map optional
Tipo:Map|StreetViewPanorama optional
Mapa no qual exibir o marcador. O mapa é necessário para mostrar o marcador e pode receber Marker.setMap se esse valor não for informado na construção.
opacity optional
Tipo:number optional
Padrão: 1,0
Um número entre 0,0 (transparente) e 1,0 (opaco).
optimized optional
Tipo:boolean optional
A otimização melhora a performance, renderizando muitos marcadores como um único elemento estático. Isso é útil quando muitos marcadores são necessários. Leia mais sobre a otimização de marcadores.
position optional
Tipo:LatLng|LatLngLiteral optional
Define a posição do marcador. Um marcador pode ser construído, mas não exibido até que sua posição seja fornecida, por exemplo, por ações ou escolhas do usuário. Uma posição do marcador pode ser fornecida com Marker.setPosition se não for informada na construção.
shape optional
Tipo:MarkerShape optional
Definição da região no mapa de imagem usada para os eventos de arrastar/clicar.
title optional
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 de marcadores não otimizados.
visible optional
Tipo:boolean optional
Padrão:true
Se for true, o marcador ficará visível.
zIndex optional
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

google.maps.CollisionBehavior constantes

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

OPTIONAL_AND_HIDES_LOWER_PRIORITY Mostrar o marcador apenas se ele não se sobrepuser a outros marcadores. Em caso de conflito, o marcador com o zIndex mais alto é mostrado. Se eles tiverem o mesmo zIndex, aquele com a posição vertical mais baixa 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 sobrepuseriam a eles.

Interface Icon

Interface google.maps.Icon

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

url
Tipo:string
O URL da planilha de imagem ou sprite.
anchor optional
Tipo:Point optional
A posição na qual uma imagem deve ser ancorada em correspondência com o local do marcador no mapa. Por padrão, a âncora está localizada ao longo do ponto central da parte inferior da imagem.
labelOrigin optional
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 está localizada no ponto central da imagem.
origin optional
Tipo:Point optional
A posição da imagem em um sprite, se houver. Por padrão, a origem está localizada no canto superior esquerdo da imagem (0, 0).
scaledSize optional
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 optional
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, vai ser possível reposicioná-lo com a propriedade labelOrigin na classe Icon.

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

Interface MarkerShape

Interface google.maps.MarkerShape

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

coords
Tipo:Array<number>
O formato desse atributo depende do valor do type e segue a especificação w3 área coords 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.
type
Tipo:string
Descreve o tipo da forma e pode ser circle, poly ou rect.

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.

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 optional
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 optional
Tipo:string optional
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 optional
Tipo:number optional
Padrão:0
A opacidade de preenchimento do símbolo.
labelOrigin optional
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 optional
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 uma IconSequence em que fixedRotation é false é girado em relação ao ângulo da borda em que ele está.
scale optional
Tipo:number optional
O valor da escala do símbolo em tamanho. Para marcadores de símbolo, o padrão é 1; após a escala, 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 a escala, o símbolo precisa ficar dentro de um quadrado de 22 pixels de tamanho centralizado na âncora do símbolo.
strokeColor optional
Tipo:string optional
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 optional
Tipo:number optional
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 optional
Tipo:number optional
Padrão:o Symbol.scale do símbolo.
A espessura do traço do símbolo.

constantes SymbolPath

google.maps.SymbolPath constantes

Caminhos de símbolos integrados.

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

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 frente.
FORWARD_OPEN_ARROW Uma seta aberta apontando para frente.

Constantes de animação

google.maps.Animation constantes

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

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

BOUNCE O marcador salta até que a animação pare, 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.