Circle

aula final pública Círculo estende o Objeto

Um círculo na superfície da Terra (limite esférico).

Um círculo tem as seguintes propriedades.

Centro
O centro do círculo é especificado como uma LatLng.
Radius
O raio do círculo, especificado em metros. Ele 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 usado pelo Color. O valor padrão é preto (0xff000000).
Padrão de traço
Sólido (padrão, representado por null) ou uma sequência de objetos PatternItem sejam repetidos ao longo do contorno do círculo. Tipos de PatternItem disponíveis: Gap (definido pelo comprimento da lacuna 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 por largura do traço em pixels).
Cor de preenchimento
A cor do preenchimento do círculo no 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 e não Marker). Uma sobreposição com um Z-index maior é desenhada sobre sobreposições com valores menores índices z. 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 fica visível ou invisível, ou seja, se foi desenhado no mapa. Um o círculo invisível não é desenhado, mas mantém todas as outras propriedades. O padrão é true, ou seja, visível.
Tag
Uma Object associada ao círculo. Por exemplo, 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 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 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 de círculo se o círculo abrange o Polo Norte ou o Polo Sul. No entanto, o contorno ainda será desenhado corretamente.

Guia do desenvolvedor

Para mais informações, leia a página do desenvolvedor de Shapes guia.

Resumo do método público

LatLng
getCenter()
Retorna o centro como uma 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.
List<PatternItem>
getStrokePattern()
Retorna o padrão de traço do contorno desse círculo.
float
getStrokeWidth()
Retorna a largura do traço.
Objeto
getTag()
Recebe a tag do círculo.
float
getZIndex()
Retorna o zIndex.
booleano
isClickable()
Recebe a capacidade de receber cliques do círculo.
booleano
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 capacidade de receber cliques do círculo.
void
setFillColor(int color)
Define a cor de preenchimento.
void
setRadius(raio duplo)
Define o raio em metros.
void
setStrokeColor(int color)
Define a cor do traço.
void
setStrokePattern(padrão List<PatternItem>)
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(boolean visible)
Define a visibilidade do círculo.
void
setZIndex(zIndex flutuante)
Define o zIndex.

Resumo do método herdado

Métodos públicos

públicas LatLng getCenter ()

Retorna o centro como uma LatLng.

Retorna
  • É o centro geográfico como um LatLng.

públicas int. getFillColor ()

Retorna a cor de preenchimento desse círculo.

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

públicas Corda getId ()

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

públicas dupla getRadius ()

Retorna o raio do círculo, em metros.

Retorna
  • O raio em metros.

públicas int. getStrokeColor ()

Retorna a cor do traço.

Retorna
  • A cor do círculo no formato ARGB.

públicas List<PatternItem> getStrokePattern ()

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

Retorna
  • o padrão de traço.

públicas flutuar getStrokeWidth ()

Retorna a largura do traço.

Retorna
  • A largura em pixels da tela.

públicas Objeto getTag ()

Recebe a tag do círculo.

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

públicas flutuar getZIndex ()

Retorna o zIndex.

Retorna
  • O zIndex deste círculo.

públicas booleano isClickable ()

Recebe a capacidade de receber cliques do círculo. Se o círculo for clicável, seu aplicativo receberá notificações para o GoogleMap.OnCircleClickListener quando o usuário clica 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.

públicas booleano isVisible ()

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

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

públicas anular remover ()

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

públicas anular setCenter (Central de LatLng)

Define o centro usando um LatLng.

O centro não pode ser nulo, porque não há valor padrão.

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

públicas anular setClickable (booleano clicável)

Define a capacidade de receber cliques do círculo. Se o círculo for clicável, seu aplicativo receberá notificações para o GoogleMap.OnCircleClickListener quando o usuário clica no círculo. O listener de eventos é registrado por meio de setOnCircleClickListener(GoogleMap.OnCircleClickListener).

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

públicas anular setFillColor (int color)

Define a cor de preenchimento.

A cor de preenchimento é a cor dentro do círculo, no formato inteiro especificado por Color. Se TRANSPARENT for usado, nenhum preenchimento será desenhado.

Parâmetros
cor A cor no formato Color.

públicas anular setRadius (raio duplo)

Define o raio em metros.

O raio precisa ser zero ou maior.

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

públicas anular setStrokeColor (int color)

Define a cor do traço.

A cor do traço é a cor do contorno deste círculo, no formato inteiro especificado por Color: Se TRANSPARENT for usado, nenhum contorno será desenhado.

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

públicas anular setStrokePattern (Padrão List<PatternItem>)

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

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

públicas anular 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. Deve 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

públicas anular setTag (tag de objeto)

Define a tag do círculo.

É possível usar essa propriedade para associar um Object arbitrário a esse círculo. Para Por exemplo, a Object pode conter dados sobre o que o círculo representa. Esta é mais fácil do que armazenar um Map<Circle, 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 setVisible (booleano visível)

Define a visibilidade do círculo.

Se o círculo não estiver visível, 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 true para tornar este círculo visível; false para ficar invisível.

públicas anular setZIndex (zIndex flutuante)

Define o zIndex.

As sobreposições (como círculos) com índices z mais altos são desenhadas acima das que têm índices mais baixos.

Parâmetros
zIndex O valor de zIndex.