Polygon

Um polígono na superfície da Terra. Um polígono pode ser convexo ou côncavo, pode abranger o meridiano de 180 e ter buracos nã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. Não é necessário que os pontos inicial e final coincidam. Se isso não acontecer, o polígono será fechado automaticamente. Segmentos de linha são desenhados entre pontos consecutivos na menor das duas direções (leste ou oeste).

Buracos

Um buraco é uma região dentro do polígono que não é preenchida. Um buraco é especificado exatamente da mesma forma que o contorno. Um buraco precisa estar totalmente contido no contorno. É possível especificar vários buracos, mas não são aceitos buracos sobrepostos.

Largura do traço

Largura do segmento de linha 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

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

Tipo de junta de traço

O tipo de junção define a forma usada ao unir segmentos de linha adjacentes em todos os vértices do contorno do polígono. Consulte JointType para saber quais são os tipos de junção compatíveis. O valor padrão é DEFAULT.

Padrão de traço

São sólidos (padrão, representados por null) ou uma sequência de objetos PatternItem a serem repetidos ao longo do contorno do polígono. Tipos de PatternItem disponíveis: Gap (definido pelo tamanho 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 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 valor padrão é transparente (0x00000000). Se a geometria do polígono não for especificada corretamente (consulte "Contorno e buracos" acima), nenhum preenchimento será desenhado.

Z-index

É a ordem em que o 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 aquelas com Z-index menores. 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 é 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 precisam ser desenhados como geodésicos, em vez de linhas retas na projeção de Mercator. Uma geodésica é o caminho mais curto entre dois pontos na superfície da Terra. A curva geodésica é construída supondo que a Terra seja uma esfera

Facilidade de clique

Se você quiser processar eventos disparados quando o usuário clicar no polígono, defina essa propriedade como true. É possível alterar esse valor a qualquer momento. O padrão é false. Se ela for definida como true, seu app vai 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. Também é 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 nessa classe precisam ser chamados na linha de execução de interface do Android. Caso contrário, uma IllegalStateException vai 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 o guia do desenvolvedor sobre Formas.