Polilinha

Uma polilinha é uma lista de pontos, em que os segmentos de linha são desenhados entre pontos consecutivos. Uma polilinha tem as seguintes propriedades:

Pontos

Os vértices da linha. Segmentos de linha são desenhados entre pontos consecutivos. Uma polilinha não é fechada por padrão. Para formar uma polilinha fechada, os pontos de início e término precisam ser os mesmos.

Largura

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

Cor

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

Limite de início/término

Define a forma a ser usada no início ou no fim de uma polilinha. Tipos de limite compatíveis: ButtCap, SquareCap, RoundCap (aplicáveis para padrão de traço sólido) e CustomCap (aplicável a qualquer padrão de traço). Padrão para início e fim: ButtCap.

Tipo de junção

O tipo de junção define a forma a ser usada ao unir segmentos de linha adjacentes em todos os vértices da polilinha, exceto os vértices de início e fim. Consulte JointType para ver os tipos de junção compatíveis. O valor padrão é DEFAULT.

Padrão de traço

contínua (padrão, representada por null) ou uma sequência de objetos PatternItem a ser repetida ao longo da linha. Tipos de PatternItem disponíveis: Gap (definido pelo tamanho da lacuna em pixels), Dash (definido pela largura da linha e comprimento do traço em pixels) e Dot (circular, centralizado na linha, diâmetro definido pela largura da linha em pixels).

Z-index

A ordem em que essa sobreposição de blocos é desenhada em relação a outras sobreposições, incluindo GroundOverlays, TileOverlays, Circles 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 a polilinha está visível ou invisível, ou seja, se ela está desenhada no mapa. Uma polilinha invisível não é desenhada, mas mantém todas as propriedades dela. O padrão é true, ou seja, visível.

Status geodésico

Indica se os segmentos da polilinha 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 considerando que a Terra é uma esfera

Clicabilidade

Se você quiser processar eventos acionados quando o usuário clica na polilinha, defina essa propriedade como true. É possível alterar esse valor a qualquer momento. O padrão é false. Se essa propriedade for definida como true, o app receberá notificações para o GoogleMap.OnPolylineClickListener registrado pelo setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Tag

É um Object associado à polilinha. Por exemplo, Object pode conter dados sobre o que a polilinha representa. Isso é mais fácil do que armazenar um Map<Polyline, 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.

Períodos

Define os períodos com estilos diferentes usados para renderizar essa polilinha. Você pode usar essa propriedade para criar uma polilinha com StrokeStyle diferentes em segmentos distintos da polilinha.

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 thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));
 

Guia do desenvolvedor

Para mais informações, leia o guia de desenvolvedores sobre Formas.