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 objetosPatternItem
sejam repetidos ao longo do contorno do círculo. Tipos dePatternItem
disponíveis:Gap
(definido pelo comprimento da lacuna 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 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
GroundOverlay
s,TileOverlay
s,Polyline
s ePolygon
s, mas e nãoMarker
). 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 umMap<Circle, Object>
separado. Como outro exemplo, é possível associar um IDString
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 | |
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 | |
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 | |
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 ()
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)
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)
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)
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. |
---|