Polyline

aula final pública Polyline estende o Objeto

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.

Resumo do método público

booleano
equals(objeto "outro")
Testa se este Polyline é igual a outro.
int
getColor()
Recebe a cor desta polilinha.
Cap
getEndCap()
Recebe o limite no vértice final desta polilinha.
String
getId()
Recebe o ID dessa polilinha.
int
getJointType()
Recebe o tipo de junção usado em todos os vértices da polilinha, exceto os vértices inicial e final.
List<PatternItem>
getPattern()
Extrai o padrão de traço dessa polilinha.
Lista<LatLng>
getPoints()
Retorna um instantâneo dos vértices desta polilinha no momento .
Cap
getStartCap()
Recebe o limite no vértice inicial desta polilinha.
Objeto
getTag()
Recebe a tag da polilinha.
float
getWidth()
Recebe a largura dessa polilinha.
float
getZIndex()
Retorna o zIndex desta polilinha.
int
hashCode()
booleano
isClickable()
Recebe a capacidade de receber cliques da polilinha.
booleano
isGeodesic()
Descobre se cada segmento da linha é desenhado como geodésico ou não.
booleano
isVisible()
Recebe a visibilidade desta polilinha.
void
remove()
Remove a polilinha do mapa.
void
setClickable(booleano clicável)
Define a capacidade de receber cliques da polilinha.
void
setColor(int color)
Define a cor desta polilinha.
void
setEndCap(Cap endCap)
Define o limite no vértice final desta polilinha.
void
setGeodesic(boolean geodesic)
Define se cada segmento da linha deve ser desenhado como geodésico ou não.
void
setJointType(int jointType)
Define o tipo de junção de todos os vértices da polilinha, exceto os vértices inicial e final.
void
setPattern(padrão List<PatternItem>)
Define o padrão de traço da polilinha.
void
setPoints(List<LatLng> pontos)
Define os pontos desta polilinha.
void
setSpans(períodos List<StyleSpan>)
Define os períodos da polilinha.
void
setStartCap(Cap startCap)
Define o limite no vértice inicial desta polilinha.
void
setTag(tag de objeto)
Define a tag da polilinha.
void
setVisible(boolean visible)
Define a visibilidade desta polilinha.
void
setWidth(largura flutuante)
Define a largura da polilinha.
void
setZIndex(zIndex flutuante)
Define o zIndex desta polilinha.

Resumo do método herdado

Métodos públicos

públicas booleano é igual a (outro objeto)

Testa se este Polyline é igual a outro.

Parâmetros
outro um Object.
Retorna
  • verdadeiro se ambos os objetos forem o mesmo, ou seja, este == outro.

públicas int. getColor ()

Recebe a cor desta polilinha.

Retorna
  • a cor em formato ARGB.

públicas Limite getEndCap ()

Recebe o limite no vértice final desta polilinha.

Retorna
  • o tipo de limite final.

públicas Corda getId ()

Recebe o ID dessa polilinha. O ID será exclusivo entre todas as polilinhas de um mapa.

Retorna
  • o ID desta polilinha.

públicas int. getJointType ()

Recebe o tipo de junção usado em todos os vértices da polilinha, exceto os vértices inicial e final. Consulte JointType para possíveis valores.

Retorna
  • o tipo de junção.

públicas List<PatternItem> getPattern ()

Extrai o padrão de traço dessa polilinha.

Retorna
  • o padrão de traço.

públicas Lista<LatLng> getPoints ()

Retorna um instantâneo dos vértices desta polilinha no momento . A lista retornada é uma cópia da lista de vértices. Portanto, as alterações nos vértices da polilinha não serão refletidas por este lista, nem as alterações feitas nesta lista serão refletidas pela polilinha. Para alterar os vértices da polilinha, chame setPoints(List).

públicas Limite getStartCap ()

Recebe o limite no vértice inicial desta polilinha.

Retorna
  • do limite inicial.

públicas Objeto getTag ()

Recebe a tag da polilinha.

Retorna
  • a tag se ela tiver sido definida com setTag; null se nenhuma tag tiver sido definida.

públicas flutuar getWidth ()

Recebe a largura dessa polilinha.

Retorna
  • a largura em pixels da tela.

públicas flutuar getZIndex ()

Retorna o zIndex desta polilinha.

Retorna
  • o zIndex da polilinha.

públicas int. hashCode ()

públicas booleano isClickable ()

Recebe a capacidade de receber cliques da polilinha. Se a polilinha for clicável, seu aplicativo receberá notificações ao GoogleMap.OnPolylineClickListener quando o usuário clica no polilinha. O listener de eventos é registrado pelo setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Retorna
  • true se a polilinha for clicável; caso contrário, retorna false.

públicas booleano isGeodesic ()

Descobre se cada segmento da linha é desenhado como geodésico ou não.

Retorna
  • true se cada segmento for desenhado como geodésico; false se cada segmento for desenhada como uma linha reta na projeção de Mercator.

públicas booleano isVisible ()

Recebe a visibilidade desta polilinha.

Retorna
  • a visibilidade desta polilinha.

públicas anular remover ()

Remove a polilinha do mapa. Depois que uma polilinha é removida, o comportamento de todos os é indefinido.

públicas anular setClickable (booleano clicável)

Define a capacidade de receber cliques da polilinha. Se a polilinha for clicável, seu aplicativo receberá notificações ao GoogleMap.OnPolylineClickListener quando o usuário clica no polilinha. O listener de eventos é registrado pelo setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Parâmetros
clicável Nova configuração de clicabilidade para a polilinha.

públicas anular setColor (int color)

Define a cor desta polilinha.

Parâmetros
cor a cor em formato ARGB

públicas anular setEndCap (Limite endCap)

Define o limite no vértice final desta polilinha. O limite final padrão é ButtCap.

Parâmetros
endCap da imagem final. Não pode ser null.

públicas anular setGeodesic (geodésica booleana)

Define se cada segmento da linha deve ser desenhado como geodésico ou não.

Parâmetros
geodesic se for true, cada segmento será desenhado como geodésico; se for false, cada segmento é desenhado como uma linha reta na projeção de Mercator.

públicas anular setJointType (int jointType)

Define o tipo de junção de todos os vértices da polilinha, exceto os vértices inicial e final.

Consulte JointType para conferir os valores permitidos. O valor padrão DEFAULT ser usado se o tipo de junção for indefinido ou não for um dos valores permitidos.

Parâmetros
jointType o tipo de junção.

públicas anular setPattern (Padrão List<PatternItem>)

Define o padrão de traço da polilinha. O padrão de traço padrão é sólido, representado por null:

Parâmetros
padrão o padrão de traço.

públicas anular setPoints (List<LatLng> pontos)

Define os pontos desta polilinha. Esse método faz uma cópia dos pontos, então mutações para points não terão efeito nesta polilinha.

Parâmetros
pontos uma lista de LatLngs que são os vértices da polilinha.

públicas anular setSpans (List<StyleSpan> de períodos)

Define os períodos da polilinha.

Parâmetros
se estendem

públicas anular setStartCap (Limite startCap)

Define o limite no vértice inicial desta polilinha. O limite inicial padrão é ButtCap.

Parâmetros
startCap do limite inicial. Não pode ser null.

públicas anular setTag (tag de objeto)

Define a tag da polilinha.

Você pode usar essa propriedade para associar um Object arbitrário a essa polilinha. Para Por exemplo, a Object pode conter dados sobre o que a polilinha representa. Esta é mais fácil do que armazenar um Map<Polyline, Object> separado. Como outro exemplo, é possível associar uma String ID correspondente ao ID de um conjunto de dados. O SDK do Google Maps para Android também não lê nem grava essa propriedade. Você é responsável por chamar setTag(null) para limpar a tag quando não for mais necessária, para evitar vazamentos de memória no aplicativo.

Parâmetros
tag se nulo, a tag será apagada.

públicas anular setVisible (booleano visível)

Define a visibilidade desta polilinha. Quando não está visível, uma polilinha não é desenhada, mas mantém todas as outras propriedades dele.

Parâmetros
visível Se for true, a polilinha será visível. se false, não será.

públicas anular setWidth (largura flutuante)

Define a largura da polilinha.

Parâmetros
largura a largura em pixels da tela

públicas anular setZIndex (zIndex flutuante)

Define o zIndex desta polilinha. Polilinhas com zIndices maiores são desenhadas acima daquelas com índices mais baixos.

Parâmetros
zIndex o zIndex dessa polilinha.