Círculo

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.