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 objetosPatternItem
que serão repetidos ao longo do contorno do círculo. Tipos dePatternItem
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) eDot
(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
GroundOverlay
s,TileOverlay
s,Polyline
s ePolygon
s, mas nãoMarker
s. 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, aObject
pode conter dados sobre o que o círculo representa. Isso é mais fácil do que armazenar umMap<Circle, Object>
separado. Como outro exemplo, é possível associar um IDString
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 | |
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 | |
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 | |
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
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)
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)
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)
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. |
---|