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
LatLngdo marcador. O padrão é 50% da esquerda para a parte inferior da imagem. - Posição
- O valor
LatLngpara 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
Objectassociada ao marcador. Por exemplo,Objectpode conter dados sobre o que o marcador representa. Isso é mais fácil do que armazenar umMap<Marker, Object>separado. Como outro exemplo, é possível associar um IDStringque 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 | |
| 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 | |
| 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 | |
| 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)
públicas flutuar getAlpha ()
Recebe o alfa do marcador.
Retorna
- o alfa do marcador no intervalo [0, 1].
públicas Corda getId ()
Recebe 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
LatLngque 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;nullse 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
truese o marcador for arrastável; caso contrário, retornafalse.
públicas booleano isFlat ()
Recebe a configuração fixa do Marker.
Retorna
truese o marcador for plano em relação ao mapa.falsese 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
|
|---|