Marcador

aula final pública Marcador estende o Objeto

Um ícone colocado em um ponto específico na superfície do mapa. Um ícone de marcador está na orientação de desenho na tela do dispositivo e não na superfície do mapa; ou seja, não necessariamente mudará orientação devido a rotações, inclinação ou zoom do mapa.

Um marcador tem as seguintes propriedades:

Alfa
Define a opacidade do marcador. O padrão é 1.0.
Anchor
O ponto na imagem que será colocado na posição LatLng do marcador. O padrão é 50% da esquerda para a parte inferior da imagem.
Posição
O valor LatLng para a posição do marcador no mapa. É possível alterar esse valor a qualquer momento se quiser mover o marcador.
Título
Uma string de texto que aparece em uma janela de informações quando o usuário toca no marcador. Você pode altere esse valor a qualquer momento.
Snippet
O texto adicional que é exibido abaixo do título. É possível alterar esse valor a qualquer momento.
Ícone
Um bitmap que aparece para o marcador. Se o ícone não for definido, um ícone padrão será exibidos. É possível especificar uma cor alternativa para o ícone padrão usando defaultMarker(float).
Status de arrastar
Se você quiser permitir que o usuário arraste o marcador, defina esta propriedade como true. Você pode alterar esse valor a qualquer momento. O padrão é false.
Visibilidade
Por padrão, o marcador fica visível. Para tornar o marcador invisível, defina esta propriedade como false: É possível alterar esse valor a qualquer momento.
Plano ou outdoor
Se o marcador for plano em relação ao mapa, ele vai continuar preso no mapa enquanto a câmera gira e inclina, mas continua com o mesmo tamanho do zoom da câmera, ao contrário de um GroundOverlay. Se o marcador for um outdoor, ele sempre será desenhado de frente para a câmera e vai girar e inclinar com a câmera. O padrão é um outdoor (false)
Rotação
A rotação do marcador em graus no sentido horário em torno do ponto de fixação dele. O eixo de rotação é perpendicular ao marcador. Uma rotação de 0 corresponde ao padrão do marcador. Quando o marcador é plano no mapa, a posição padrão é Norte. alinhado e a rotação faz com que o marcador sempre permaneça plano no mapa. Quando o o marcador é um outdoor, a posição padrão aponta para cima e a rotação é de tal forma o marcador está sempre voltado para a câmera. O valor padrão é 0.
zIndex
A ordem do desenho do marcador. Os marcadores são desenhados na ordem do zIndex, com o marcador zIndex mais alto desenhado na parte superior. Definindo a propriedade zIndex de cada marcador, você pode Controlar qual ponto de toque seu usuário tem maior probabilidade de atingir. O valor padrão é 0.
Tag
Uma Object associada ao marcador. Por exemplo, Object pode conter dados sobre o que o marcador representa. Isso é mais fácil do que armazenar um Map<Marker, Object> separado. Como outro exemplo, é possível associar um ID String que corresponde ao ID de um conjunto de dados. O SDK do Google Maps para Android não lê nem lê grava essa propriedade.

Os métodos dessa classe precisam ser chamados na linha de execução de interface do Android. Caso contrário, uma IllegalStateException será gerada no momento da execução.

Exemplo

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));

Guia do desenvolvedor

Para mais informações, leia a página para desenvolvedores Marcadores. guia.

Resumo de classes aninhadas

@interface Marker.CollisionBehavior Indica como o marcador é tratado se houver uma colisão com outros marcadores ou base marcadores de mapa.

Resumo do método público

booleano
equals(objeto "outro")
Testa se este Marker é igual a outro.
float
getAlpha()
Recebe o alfa do marcador.
String
getId()
Recebe o ID desse marcador.
LatLng
getPosition()
Retorna a posição do marcador.
float
getRotation()
Recebe a rotação do marcador.
String
getSnippet()
Extrai o snippet do marcador.
Objeto
getTag()
Recebe a tag do marcador.
String
getTitle()
Recebe o título do marcador.
float
getZIndex()
Retorna o zIndex do marcador.
int
hashCode()
void
hideInfoWindow()
Oculta a janela de informações se ela for mostrada a partir deste marcador.
booleano
isDraggable()
Recebe a capacidade de arrastar do marcador.
booleano
isFlat()
Recebe a configuração fixa do Marker.
booleano
isInfoWindowShown()
Informa se a janela de informações está sendo exibida acima do marcador no momento.
booleano
isVisible()
Recebe a configuração de visibilidade deste marcador.
void
remove()
Remove este marcador do mapa.
void
setAlpha(alfa flutuante)
Define o alfa (opacidade) do marcador.
void
setAnchor(float anchorU, float anchorV)
Define o ponto de fixação do marcador.
void
setDraggable(boolean draggable)
Define a capacidade de arrastar do marcador.
void
setFlat(booleano simples)
Define se este marcador deve ser plano em relação ao mapa true ou um outdoor voltado para o câmera false.
void
setIcon(iconDescriptor do BitmapDescriptor)
Define o ícone do marcador.
void
setInfoWindowAnchor(float anchorU, float anchorV)
Especifica o ponto na imagem do marcador no qual a janela de informações será ancorada quando ela for exibidos.
void
setPosition(latlng do LatLng)
Define o local do marcador.
void
setRotation(rotação flutuante)
Define a rotação do marcador em graus no sentido horário em relação ao ponto de fixação do marcador.
void
setSnippet(snippet de string)
Define o snippet do marcador.
void
setTag(tag de objeto)
Define a tag do marcador.
void
setTitle(título da string)
Define o título do marcador.
void
setVisible(boolean visible)
Define a visibilidade deste marcador.
void
setZIndex(zIndex flutuante)
Define o zIndex do marcador.
void
showInfoWindow()
Mostra a janela de informações desse marcador no mapa, se o marcador for isVisible().

Resumo do método herdado

Métodos públicos

públicas booleano é igual a (outro objeto)

Testa se este Marker é igual a outro.

Parâmetros
outro um Object.
Retorna
  • verdadeiro se ambos os objetos forem o mesmo, ou seja, este == outro.

públicas flutuar getAlpha ()

Recebe o alfa do marcador.

Retorna
  • o alfa do marcador no intervalo [0, 1].

públicas Corda getId ()

Recupera o ID desse marcador. Esse ID é exclusivo entre todos os marcadores de um mapa.

Retorna
  • ID desse marcador.

públicas LatLng getPosition ()

Retorna a posição do marcador.

Retorna
  • Um objeto LatLng que especifica a posição atual do marcador.

públicas flutuar getRotation ()

Recebe a rotação do marcador.

Retorna
  • a rotação do marcador em graus no sentido horário a partir da posição padrão.

públicas Corda getSnippet ()

Extrai o snippet do marcador.

Retorna
  • String que contém o snippet do marcador.

públicas Objeto getTag ()

Recebe a tag do marcador.

Retorna
  • a tag se ela tiver sido definida com setTag; null se nenhuma tag tiver sido definida.

públicas Corda getTitle ()

Recebe o título do marcador.

Retorna
  • String que contém o título do marcador.

públicas flutuar getZIndex ()

Retorna o zIndex do marcador.

Retorna
  • zIndex desse marcador.

públicas int. hashCode ()

públicas anular hideInfoWindow ()

Oculta a janela de informações se ela for mostrada a partir deste marcador.

Esse método não terá efeito se o marcador não estiver visível.

públicas booleano isDraggable ()

Recebe a capacidade de arrastar do marcador. Quando um marcador é arrastável, ele pode ser movido pelo usuário pressionando longamente o marcador.

Retorna
  • true se o marcador for arrastável; caso contrário, retorna false.

públicas booleano isFlat ()

Recebe a configuração fixa do Marker.

Retorna
  • true se o marcador for plano em relação ao mapa. false se o marcador deve fique de frente para a câmera.

públicas booleano isInfoWindowShown ()

Informa se a janela de informações está sendo exibida acima do marcador no momento. Isso não considera se a janela de informações está realmente visível na tela.

públicas booleano isVisible ()

Recebe a configuração de visibilidade deste marcador. Isso não indica se o marcador está na janela de visualização da tela. Indica se o marcador será desenhado se for na janela de visualização da tela.

Retorna
  • a visibilidade desse marcador.

públicas anular remover ()

Remove este marcador do mapa. Depois que um marcador é removido, o comportamento de todos os é indefinido.

públicas anular setAlpha (alfa flutuante)

Define o alfa (opacidade) do marcador. Este valor vai de 0 a 1, em que 0 significa que o marcador é completamente transparente e 1 significa que o marcador é completamente opaco.

Parâmetros
Alfa

públicas anular setAnchor (float anchorU, float anchorV)

Define o ponto de fixação do marcador.

A âncora especifica o ponto na imagem do ícone que está ancorado na posição do marcador na superfície da Terra.

O ponto de fixação é especificado no espaço contínuo [0,0, 1,0] x [0,0, 1,0], em que (0, 0) é o canto superior esquerdo da imagem e (1, 1) é o canto inferior direito. O ponto de fixação em uma imagem W x H é o ponto discreto mais próximo da grade em uma (W + 1) x (H + 1), obtida ao dimensionar o arredondamento. Por exemplo, em uma imagem 4 x 2, o ponto de fixação (0,7, 0,6) é resolvido para o ponto da grade em (3, 1). 

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

Parâmetros
anchorU Coordenada u da âncora, como uma proporção da largura da imagem (no intervalo [0, 1]).
anchorV coordenada v da âncora, como uma proporção da altura da imagem (no intervalo [0, 1]).

públicas anular setDraggable (booleano arrastável)

Define a capacidade de arrastar do marcador. Quando um marcador é arrastável, ele pode ser movido pelo usuário pressionando longamente o marcador.

Parâmetros
draggable

públicas anular setFlat (booleano simples)

Define se este marcador deve ser plano em relação ao mapa true ou um outdoor voltado para o câmera false.

Parâmetros
fixas

públicas anular setIcon (BitmapDescriptor iconDescriptor)

Define o ícone do marcador.

Parâmetros
iconDescriptor Se nulo, o marcador padrão será usado.

públicas anular setInfoWindowAnchor (float anchorU, float anchorV)

Especifica o ponto na imagem do marcador no qual a janela de informações será ancorada quando ela for exibidos. Isso é especificado no mesmo sistema de coordenadas que a âncora. Consulte setAnchor(float, float) para mais detalhes. O padrão é a parte central superior da imagem.

Parâmetros
anchorU coordenada u da âncora da janela de informações, como uma proporção da largura da imagem (na intervalo [0, 1]).
anchorV coordenada v da âncora da janela de informações, como uma proporção da altura da imagem (na intervalo [0, 1]).

públicas anular setPosition (LatLng latlng)

Define o local do marcador.

Parâmetros
latitude e longitude

públicas anular setRotation (rotação flutuante)

Define a rotação do marcador em graus no sentido horário em relação ao ponto de fixação do marcador. O eixo de rotação é perpendicular ao marcador. Uma rotação de 0 corresponde à posição padrão do marcador.

Parâmetros
rotação

públicas anular setSnippet (Snippet de string)

Define o snippet do marcador.

Parâmetros
snippet Se for nulo, o snippet será apagado.

públicas anular setTag (tag de objeto)

Define a tag do marcador.

Você pode usar essa propriedade para associar um Object arbitrário a esse marcador. Para Por exemplo, Object pode conter dados sobre o que o marcador representa. Esta é mais fácil do que armazenar um Map<Marker, Object> separado. Como outro exemplo, é possível associar uma String ID correspondente ao ID de um conjunto de dados. O SDK do Google Maps para Android também não lê nem grava essa propriedade. Você é responsável por chamar setTag(null) para limpar a tag quando não for mais necessária, para evitar vazamentos de memória no aplicativo.

Parâmetros
tag se nulo, a tag será apagada.

públicas anular setTitle (Título da string)

Define o título do marcador.

Parâmetros
título se nulo, o título será apagado.

públicas anular setVisible (booleano visível)

Define a visibilidade deste marcador. Se definido como false e houver uma janela de informações disponível mostrando este marcador, a janela de informações será ocultada.

Parâmetros
visível

públicas anular setZIndex (zIndex flutuante)

Define o zIndex do marcador.

Parâmetros
zIndex

públicas anular showInfoWindow ()

Mostra a janela de informações desse marcador no mapa, se o marcador for isVisible().

Gera
IllegalArgumentException se marker não estiver no mapa