Polyline

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

Pontos

Os vértices da linha. Segmentos de reta são desenhados entre pontos consecutivos. Uma polilinha é não são fechadas por padrão; para formar uma polilinha fechada, os pontos inicial e final devem ser a mesma coisa.

Largura

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

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

Limite inicial/final

Define a forma a ser usada no início ou no fim de uma polilinha. Tipos de limite com suporte: ButtCap, SquareCap, RoundCap (aplicável a um 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 reta adjacentes vértices da polilinha, exceto os vértices inicial e final. Consulte JointType para tipos de junção suportados. 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 da linha. Tipos de PatternItem disponíveis: Gap (definido por comprimento 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 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 a polilinha fica visível ou invisível, ou seja, desenhada no mapa. Um a polilinha invisível não é desenhada, mas mantém todas as suas propriedades. O padrão é true, ou seja, visível.

Status geodésico

Indica se os segmentos da polilinha 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 na polilinha, 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.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 que corresponde ao ID de um conjunto de dados. O SDK do Google Maps para Android não lê nem lê grava essa propriedade.

Períodos

Define os períodos com estilos diferentes usados para renderizar essa polilinha. Você pode usar isso para criar uma polilinha com diferentes StrokeStyle em diferentes segmentos de a polilinha.

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 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 a página do desenvolvedor de Shapes guia.