Polygon

aula final pública Polígono estende o Objeto

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.

Resumo do método público

booleano
equals(objeto "outro")
Testa se este Polygon é igual a outro.
int
getFillColor()
Extrai a cor de preenchimento deste polígono.
List<List<LatLng>>
getHoles()
Retorna um instantâneo dos buracos deste polígono no momento .
String
getId()
Recebe o ID desse polígono.
Lista<LatLng>
getPoints()
Retorna um instantâneo dos vértices deste polígono no momento .
int
getStrokeColor()
Extrai a cor do traço deste polígono.
int
getStrokeJointType()
Recebe o tipo de junção do traço usado em todos os vértices do contorno do polígono.
List<PatternItem>
getStrokePattern()
Extrai o padrão do traço do contorno deste polígono.
float
getStrokeWidth()
Extrai a largura do traço desse polígono.
Objeto
getTag()
Recebe a tag do polígono.
float
getZIndex()
Extrai o zIndex deste polígono.
int
hashCode()
booleano
isClickable()
Recebe a capacidade de receber cliques do polígono.
booleano
isGeodesic()
Descobre se cada segmento da linha é desenhado como geodésico ou não.
booleano
isVisible()
Recebe a visibilidade deste polígono.
void
remove()
Remove o polígono do mapa.
void
setClickable(booleano clicável)
Define a capacidade de receber cliques do polígono.
void
setFillColor(int color)
Define a cor de preenchimento do polígono.
void
setGeodesic(boolean geodesic)
Define se cada segmento da linha deve ser desenhado como geodésico ou não.
void
setHoles(List<? estend List<LatLng>> buracos)
Define os buracos do polígono.
void
setPoints(List<LatLng> pontos)
Define os pontos do polígono.
void
setStrokeColor(int color)
Define a cor do traço deste polígono.
void
setStrokeJointType(int jointType)
Define o tipo de junção para todos os vértices do contorno do polígono.
void
setStrokePattern(padrão List<PatternItem>)
Define o padrão do traço do contorno do polígono.
void
setStrokeWidth(largura flutuante)
Define a largura do traço deste polígono.
void
setTag(tag de objeto)
Define a tag do polígono.
void
setVisible(boolean visible)
Define a visibilidade deste polígono.
void
setZIndex(zIndex flutuante)
Define o zIndex deste polígono.

Resumo do método herdado

Métodos públicos

públicas booleano é igual a (outro objeto)

Testa se este Polygon é igual a outro.

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

públicas int. getFillColor ()

Extrai a cor de preenchimento deste polígono.

Retorna
  • a cor em formato ARGB.

públicas List<List<LatLng>> getHoles ()

Retorna um instantâneo dos buracos deste polígono no momento . A lista retornada é uma cópia a lista de buracos e, portanto, as alterações nos buracos do polígono não serão refletidas por essa lista, nem as alterações nesta lista serão refletidas pelo polígono.

públicas Corda getId ()

Recebe o ID desse polígono. O ID será exclusivo entre todos os polígonos de um mapa.

públicas Lista<LatLng> getPoints ()

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

públicas int. getStrokeColor ()

Extrai a cor do traço deste polígono.

Retorna
  • a cor em formato ARGB.

públicas int. getStrokeJointType ()

Recebe o tipo de junção do traço usado em todos os vértices do contorno do polígono. Consulte JointType para possíveis valores.

Retorna
  • o tipo de junção de traço.

públicas List<PatternItem> getStrokePattern ()

Extrai o padrão do traço do contorno deste polígono.

Retorna
  • o padrão de traço.

públicas flutuar getStrokeWidth ()

Extrai a largura do traço desse polígono.

Retorna
  • a largura em pixels da tela.

públicas Objeto getTag ()

Recebe a tag do polígono.

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

públicas flutuar getZIndex ()

Extrai o zIndex deste polígono.

Retorna
  • o zIndex do polígono.

públicas int. hashCode ()

públicas booleano isClickable ()

Recebe a capacidade de receber cliques do polígono. Se o polígono for clicável, seu aplicativo receberá notificações ao GoogleMap.OnPolygonClickListener quando o usuário clica no polígono. O listener de eventos é registrado pelo setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Retorna
  • true se o polígono 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 deste polígono.

Retorna
  • a visibilidade do polígono.

públicas anular remover ()

Remove o polígono do mapa. Depois que um polígono é removido, o comportamento de todos os é indefinido.

públicas anular setClickable (booleano clicável)

Define a capacidade de receber cliques do polígono. Se o polígono for clicável, seu aplicativo receberá notificações ao GoogleMap.OnPolygonClickListener quando o usuário clica no polígono. O listener de eventos é registrado pelo setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Parâmetros
clicável Nova configuração de clicabilidade para o polígono.

públicas anular setFillColor (int color)

Define a cor de preenchimento do polígono.

Parâmetros
cor a cor em formato ARGB

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 setHoles (List<? estenda List<LatLng>> buracos)

Define os buracos do polígono. Esse método recebe uma cópia dos orifícios, portanto, outras mutações como holes não terão efeito neste polígono.

Parâmetros
buracos uma lista de buracos, em que um buraco é uma lista de LatLngs.

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

Define os pontos do polígono. Esse método faz uma cópia dos pontos, então mutações para points não terão efeito neste polígono.

Parâmetros
pontos uma lista de LatLngs que são os vértices do polígono.

públicas anular setStrokeColor (int color)

Define a cor do traço deste polígono.

Parâmetros
cor a cor em formato ARGB

públicas anular setStrokeJointType (int jointType)

Define o tipo de junção para todos os vértices do contorno do polígono.

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 de traço.

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

Define o padrão do traço do contorno do polígono. 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 setStrokeWidth (largura flutuante)

Define a largura do traço deste polígono.

Parâmetros
largura a largura em pixels de exibição.

públicas anular setTag (tag de objeto)

Define a tag do polígono.

Você pode usar essa propriedade para associar um Object arbitrário a esse polígono. Para Por exemplo, Object pode conter dados sobre o que o polígono representa. Esta é mais fácil do que armazenar um Map<Polygon, 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 deste polígono. Quando não está visível, um polígono não é desenhado, mas mantém todos as outras propriedades.

Parâmetros
visível se for true, o polígono será visível. se false, não será.

públicas anular setZIndex (zIndex flutuante)

Define o zIndex deste polígono. Polígonos com índices mais altos são desenhados sobre aqueles com valores menores índices.

Parâmetros
zIndex o zIndex desse polígono.