Polygon

Um polígono na superfície da Terra. Um polígono pode ser convexo ou côncavo, podendo abranger 180 meridiano e pode ter buracos que não estão preenchidos. Ele tem as seguintes propriedades:

Contorno

O contorno é especificado por uma lista de vértices em sentido horário ou anti-horário. Ela não é necessário que os pontos inicial e final coincidam; caso contrário, o polígono serão fechados automaticamente. Os segmentos de reta são desenhados entre pontos consecutivos no das duas direções (leste ou oeste).

Buracos

Um buraco é uma região dentro do polígono que não está preenchida. Um buraco é especificado exatamente da mesma forma que o contorno. Um buraco precisa estar totalmente contido no contorno. Vários status buracos podem ser especificados, porém buracos sobrepostos não são permitidos.

Largura do traço

Largura do segmento de linha em pixels da tela. A largura é constante e independente da o nível de zoom. O valor padrão é 10.

Cor do traço

Cor do segmento de linha no formato ARGB, o mesmo formato usado por Color. O valor padrão é preto (0xff000000).

Tipo de junção do traço

O tipo de junção define a forma a ser usada ao unir segmentos de reta adjacentes vértices do contorno do polígono. Consulte JointType para ver os tipos de junção compatíveis. O o valor padrão é DEFAULT.

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 polígono. Tipos de PatternItem disponíveis: Gap (definido pelo comprimento da lacuna em pixels), Dash (definido pela largura do traço e traço comprimento em pixels) e Dot (circular, centralizado no contorno do polígono, diâmetro) definido pela largura do traço em pixels).

Cor de preenchimento

Cor de preenchimento em formato ARGB, o mesmo formato usado por Color. O o valor padrão é transparente (0x00000000). Se a geometria do polígono não for especificada corretamente (veja acima para contorno e buraco), nenhum preenchimento será desenhado.

Z-index

A ordem em que esse polígono é desenhado em relação a outras sobreposições, incluindo Polylines, Circles, GroundOverlays e TileOverlays, mas não Markers. 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 valor de Z-index é aleatória. O padrão é 0.

Visibilidade

Indica se o polígono é visível ou invisível, ou seja, se foi desenhado no mapa. Um polígono invisível não é desenhado, mas mantém todas as outras propriedades. O padrão é true, ou seja, visível.

Status geodésico

Indica se os segmentos do polígono serão desenhados como geodésicos, e não linhas retas na projeção Mercator. Uma geodésica é o caminho mais curto entre duas na superfície da Terra. A curva geodésica é construída considerando que a Terra é uma esfera

Clicabilidade

Se você quiser gerenciar eventos disparados quando o usuário clica no polígono, defina esta propriedade como true. É possível alterar esse valor a qualquer momento. O padrão é false. Se esse estiver definida como true, seu app receberá notificações para o GoogleMap.OnPolygonClickListener registrado pelo setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Tag

Um Object associado ao polígono. Por exemplo, Object pode conter dados sobre o que o polígono representa. Isso é mais fácil do que armazenar um Map<Polygon, 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 triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

Guia do desenvolvedor

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