Polígono

classe final pública Polygon estende o objeto

Um polígono na superfície da Terra. Um polígono pode ser convexo ou cônico, ele pode abranger o meridiano 180 e pode ter buracos não preenchidos. Ela tem as seguintes propriedades:

Resumo
O contorno é especificado por uma lista de vértices no sentido horário ou anti-horário. Não é necessário coincidir os pontos de início e término. Caso contrário, o polígono será fechado automaticamente. Segmentos de linha são desenhados entre pontos consecutivos no menor dos dois sentidos (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 furo precisa estar totalmente incluído no contorno. É possível especificar vários buracos, mas não é possível usar buracos sobrepostos.
Largura do traço
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 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 linha adjacentes em todos os vértices do contorno do polígono. Consulte os tipos de junção compatíveis em JointType. O valor padrão é DEFAULT.
Padrão de traço
Resolvido (padrão, representado por null) ou uma sequência de objetos PatternItem que serão repetidos no contorno do polígono. Tipos de PatternItem disponíveis: Gap (definido pela duração 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), no diâmetro definido pela largura do traço em pixels.
Cor de preenchimento
Preencha a cor no 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 (veja esboço e furos acima), 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 as sobreposições com índices Z menores. A ordem das sobreposições que têm o mesmo valor de Z-index é arbitrária. O padrão é 0.
Visibilidade
Indica se o polígono está visível ou invisível, ou seja, se ele está 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 considerando que a Terra é uma esfera
Clicabilidade
Se você quiser processar eventos acionados 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 essa propriedade for definida como true, o 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 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 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 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 de desenvolvedores sobre Formas.

Resumo do método público

boolean
equals(outro objeto)
Teste se essa Polygon for igual a outra.
int
getFillColor()
Recebe a cor de preenchimento do polígono.
Lista<Lista<LatLng>>
getHoles (em inglês)
Retorna um snapshot dos buracos deste polígono neste momento .
String
getId ()
Recebe este ID de polígono.
Lista<LatLng>
getPoints()
Retorna um snapshot dos vértices deste polígono neste momento .
int
getStrokeColor()
Recebe a cor do traço do polígono.
int
getStrokeJointType()
Recebe o tipo de junção do traço usado em todos os vértices do contorno do polígono.
Lista<PatternItem>
getStrokePattern()
Recebe o padrão de traço do contorno desse polígono.
float
getStrokeWidth()
Recebe a largura do traço do polígono.
Objeto
getTag
Acessa a tag do polígono.
float
getZIndex()
Recebe o zIndex desse polígono.
int
boolean
isClickable().
Recebe a clicabilidade do polígono.
boolean
isGeodesic()
Determina se cada segmento da linha é desenhado como um geodésico ou não.
boolean
isVisible()
Recebe a visibilidade deste polígono.
void
remove()
Remove o polígono do mapa.
void
setClickable(booleano clicável)
Define a clicabilidade do polígono.
void
setFillColor (cor colorida)
Define a cor de preenchimento do polígono.
void
setGeodesic (geodésico booleano)
Define se é necessário desenhar cada segmento da linha como geodésica ou não.
void
setHoles(Lista<? estende o início da Lista<LatLng>>)
Define os buracos do polígono.
void
setPoints(lista<LatLng> pontos)
Define os pontos desse polígono.
void
setStrokeColor(em cores)
Define a cor do traço do polígono.
void
setStrokeJointType(intJoinType)
Define o tipo de junção para todos os vértices do contorno do polígono.
void
setStrokePattern(List<PatternItem> padrão)
Define o padrão de 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(booleano visível)
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

booleano público igual a (outro objeto)

Teste se essa Polygon for igual a outra.

Parâmetros
Outras um Object.
Retorna
  • true se os dois objetos forem o mesmo objeto, ou seja, este == other.

int público getFillColor ()

Recebe a cor de preenchimento do polígono.

Retorna
  • a cor no formato ARGB.

public List<List<LatLng>> getHoles ()

Retorna um snapshot dos buracos deste polígono neste momento . A lista retornada é uma cópia da 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 nessa lista serão refletidas pelo polígono.

string pública getId ()

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

public List<LatLng> getPoints ()

Retorna um snapshot dos vértices deste polígono neste momento . A lista retornada é uma cópia da lista de vértices. Portanto, as mudanças nos vértices do polígono e da lista não serão refletidas por essa lista, nem as alterações nessa lista serão refletidas pelo polígono. Para mudar os vértices do polígono, chame setPoints(List).

int público getStrokeColor ()

Recebe a cor do traço do polígono.

Retorna
  • a cor no formato ARGB.

int público getStrokeJointType ()

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

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

public List<PatternItem> getStrokePattern ()

Recebe o padrão de traço do contorno desse polígono.

Retorna
  • o padrão do traço.

ponto flutuante público getStrokeWidth ()

Recebe a largura do traço do polígono.

Retorna
  • a largura em pixels da tela.

Objeto público getTag ()

Acessa a tag do polígono.

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

ponto flutuante público getZIndex ()

Recebe o zIndex desse polígono.

Retorna
  • o zIndex do polígono.

int público hashCode ()

booleano público isClickable ()

Recebe a clicabilidade do polígono. Se o polígono for clicável, o app recebe notificações no GoogleMap.OnPolygonClickListener quando o usuário clica nele. O listener de eventos é registrado pelo setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Retorna
  • true, se o polígono for clicável. Caso contrário, retorna false.

booleano público isGeodesic ()

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

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

booleano público isVisible ()

Recebe a visibilidade deste polígono.

Retorna
  • essa visibilidade do polígono.

public void remove ()

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

public void setClickable (booleano clicável)

Define a clicabilidade do polígono. Se o polígono for clicável, o app recebe notificações no GoogleMap.OnPolygonClickListener quando o usuário clica nele. O listener de eventos é registrado pelo setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

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

public void setFillColor (int color)

Define a cor de preenchimento do polígono.

Parâmetros
cor A cor no formato ARGB

public void setGeodesic (booleano geodésico)

Define se é necessário desenhar cada segmento da linha como geodésica ou não.

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

void public setHoles (List<? estende List<LatLng>> buracos)

Define os buracos do polígono. Esse método usará uma cópia dos orifícios. Portanto, outras mutações para holes não terão efeito nesse polígono.

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

public void setPoints (List<LatLng> pontos)

Define os pontos desse polígono. Esse método usará uma cópia dos pontos. Portanto, outras mutações para points não terão efeito nesse polígono.

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

public void setStrokeColor (int color)

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

Parâmetros
cor A cor no formato ARGB

public void setStrokeJointType (int JoinType)

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

Consulte os valores permitidos em JointType. 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
Tipo de junção o tipo de junção do traço.

void void setStrokePattern (List<PatternItem> padrão)

Define o padrão de traço do contorno do polígono. O padrão do traço padrão é sólido, representado por null.

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

public void setStrokeWidth (largura flutuante)

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

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

public void 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. 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 grava essa propriedade. É sua responsabilidade chamar setTag(null) para limpar a tag quando ela não for mais necessária, para evitar vazamentos de memória no seu app.

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

public void 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 todas as propriedades dele.

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

public void setZIndex (float zIndex)

Define o zIndex deste polígono. Polígonos com zIndices mais altos são desenhados acima daqueles com índices mais baixos.

Parâmetros
Zindex o zIndex deste polígono.