Círculo

classe final pública Circle estende o objeto

Círculo na superfície da Terra (capa esférica).

Um círculo tem as seguintes propriedades.

Ajuda
O centro do círculo é especificado como um LatLng.
Radius
O raio do círculo, especificado em metros. Deve ser zero ou maior.
Largura do traço
A largura do contorno do círculo em pixels da tela. A largura é constante e independente do nível de zoom da câmera. O valor padrão é 10.
Cor do traço
A cor do contorno do círculo no formato ARGB, o mesmo formato usado por Color. O valor padrão é preto (0xff000000).
Padrão de traço
Sinalizado (padrão, representado por null) ou uma sequência de objetos PatternItem que serão repetidos ao longo do contorno do círculo. Tipos de PatternItem disponíveis: Gap (definido pela duração do intervalo em pixels), Dash (definido pela largura do traço e comprimento do traço em pixels) e Dot (circular, centralizado no contorno do círculo, diâmetro definido pela largura do traço em pixels).
Cor de preenchimento
A cor do círculo preenche o formato ARGB, o mesmo formato usado por Color. O valor padrão é transparente (0x00000000).
Z-index
A ordem em que essa sobreposição de blocos é desenhada em relação a outras sobreposições, incluindo GroundOverlays, TileOverlays, Polylines e Polygons, mas não Markers. Uma sobreposição com um Z-index maior é desenhada sobre as sobreposições com índices Z menores. A ordem das sobreposições que têm o mesmo índice z é aleatória. O zIndex padrão é 0.
Visibilidade
Indica se o círculo está visível ou invisível, ou seja, se ele está desenhado no mapa. Um círculo invisível não é desenhado, mas mantém todas as outras propriedades dele. O padrão é true, ou seja, visível.
Tag
Uma Object associada ao círculo. Por exemplo, a Object pode conter dados sobre o que o círculo representa. Isso é mais fácil do que armazenar um Map<Circle, Object> separado. Como outro exemplo, é possível associar um ID String correspondente ao ID de um conjunto de dados. O SDK do Google Maps para Android não lê nem grava essa propriedade.

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

Exemplo

GoogleMap map;
 // ... get a map.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

O renderizador de mapa atual não pode desenhar o preenchimento do círculo se o círculo abranger o polo norte ou sul. No entanto, o contorno ainda será desenhado corretamente.

Guia do desenvolvedor

Para mais informações, leia o guia de desenvolvedores sobre Formas.

Resumo do método público

LatLng
getCenter().
Retorna o centro como um LatLng.
int
getFillColor()
Retorna a cor de preenchimento desse círculo.
String
getId ()
Recebe o ID deste círculo.
double
getRadius()
Retorna o raio do círculo em metros.
int
getStrokeColor()
Retorna a cor do traço.
Lista<PatternItem>
getStrokePattern()
Retorna o padrão de traço do contorno deste círculo.
float
getStrokeWidth()
Retorna a largura do traço.
Objeto
getTag
Recebe a tag do círculo.
float
getZIndex()
Retorna o zIndex.
boolean
isClickable().
Recebe a clicabilidade do círculo.
boolean
isVisible()
Verifica se o círculo está visível.
void
remove()
Remove este círculo do mapa.
void
setCenter(centro LatLng)
Define o centro usando um LatLng.
void
setClickable(booleano clicável)
Define a clicabilidade do círculo.
void
setFillColor(cor colorida)
Define a cor de preenchimento.
void
setRadius(raio duplo)
Define o raio em metros.
void
setStrokeColor (em cores)
Define a cor do traço.
void
setStrokePattern(List<PatternItem> padrão)
Define o padrão de traço do contorno do círculo.
void
setStrokeWidth(largura flutuante)
Define a largura do traço.
void
setTag(tag de objeto)
Define a tag do círculo.
void
setVisible(booleano visível)
Define a visibilidade do círculo.
void
setZIndex (zIndex flutuante)
Define o zIndex.

Resumo do método herdado

Métodos públicos

LatLng getCenter ()

Retorna o centro como um LatLng.

Retorna
  • O centro geográfico como uma LatLng.

int público getFillColor ()

Retorna a cor de preenchimento desse círculo.

Retorna
  • É a cor de preenchimento do círculo no formato ARGB.

string pública getId ()

Recebe o ID deste círculo. O ID será exclusivo entre todos os círculos em um mapa.

double double getRadius ()

Retorna o raio do círculo em metros.

Retorna
  • É o raio em metros.

int público getStrokeColor ()

Retorna a cor do traço.

Retorna
  • É a cor do círculo no formato ARGB.

public List<PatternItem> getStrokePattern ()

Retorna o padrão de traço do contorno deste círculo.

Retorna
  • o padrão do traço.

ponto flutuante público getStrokeWidth ()

Retorna a largura do traço.

Retorna
  • É a largura em pixels da tela.

Objeto público getTag ()

Recebe a tag do círculo.

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

ponto flutuante público getZIndex ()

Retorna o zIndex.

Retorna
  • O zIndex deste círculo.

booleano público isClickable ()

Recebe a clicabilidade do círculo. Se o círculo for clicável, seu app receberá notificações para o GoogleMap.OnCircleClickListener quando o usuário clicar no círculo. O listener de eventos é registrado pelo setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Retorna
  • true se o círculo for clicável, false se não for clicável.

booleano público isVisible ()

Verifica se o círculo está visível.

Retorna
  • true se o círculo estiver visível. false se estiver invisível.

public void remove ()

Remove este círculo do mapa. Depois que um círculo é removido, o comportamento de todos os métodos dele é indefinido.

public void setCenter (LatLng central)

Define o centro usando um LatLng.

O centro não pode ser nulo, já que não há um valor padrão.

Parâmetros
centro Centro geográfico do círculo, especificado como uma LatLng.
Gera
NullPointerException se o centro for nulo

public void setClickable (booleano clicável)

Define a clicabilidade do círculo. Se o círculo for clicável, seu app receberá notificações para o GoogleMap.OnCircleClickListener quando o usuário clicar no círculo. O listener de eventos é registrado pelo setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Parâmetros
clicável Nova configuração de cliques para o círculo.

public void setFillColor (int color)

Define a cor de preenchimento.

A cor de preenchimento é a cor dentro do círculo, no formato de número inteiro especificado por Color. Se TRANSPARENT é usada, nenhum preenchimento é desenhado.

Parâmetros
cor É a cor no formato Color.

public void setRadius (raio duplo)

Define o raio em metros.

O raio deve ser zero ou maior.

Parâmetros
raio O raio, em metros.
Gera
IllegalArgumentException se o raio for negativo

public void setStrokeColor (int color)

Define a cor do traço.

A cor do traço é a cor deste contorno do círculo, no formato de número inteiro especificado por Color. Se TRANSPARENT é usada, nenhum contorno é desenhado.

Parâmetros
cor A cor do traço no formato Color.

void void setStrokePattern (List<PatternItem> padrão)

Define o padrão de traço do contorno do círculo. O padrão do traço padrão é sólido, representado por null.

Parâmetros
padrão o padrão do traço.

public void setStrokeWidth (largura flutuante)

Define a largura do traço.

A largura do traço é a largura (em pixels da tela) do contorno do círculo. Precisa ser zero ou maior. Se for zero, nenhum contorno será desenhado. O valor padrão é 10.

Parâmetros
largura É a largura do traço em pixels da tela.
Gera
IllegalArgumentException se a largura for negativa

public void setTag (tag de objeto)

Define a tag do círculo.

Você pode usar essa propriedade para associar um Object arbitrário a esse círculo. Por exemplo, a Object pode conter dados sobre o que o círculo representa. Isso é mais fácil do que armazenar um Map<Circle, 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 grava essa propriedade. É sua responsabilidade chamar setTag(null) para limpar a tag quando ela não for mais necessária, para evitar vazamentos de memória no seu app.

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

public void setVisible (booleano visível)

Define a visibilidade do círculo.

Se esse círculo não estiver visível, ele não será desenhado. Todos os outros estados são preservados. Os círculos são visíveis por padrão.

Parâmetros
visível Use true para tornar este círculo visível e false para que ele fique invisível.

public void setZIndex (float zIndex)

Define o zIndex.

As sobreposições (como círculos) com zIndices mais altos são desenhadas acima daquelas com índices mais baixos.

Parâmetros
Zindex O valor de zIndex.