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 objetosPatternItem
que serão repetidos no contorno do polígono. Tipos dePatternItem
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) eDot
(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
Polyline
s,Circle
s,GroundOverlay
s eTileOverlay
s, mas nãoMarker
s. 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 comotrue
, o app receberá notificações para oGoogleMap.OnPolygonClickListener
registrado pelosetOnPolygonClickListener(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 umMap<Polygon, Object>
separado. Como outro exemplo, é possível associar um IDString
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 | |
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 |
hashCode().
|
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 | |
void | |
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 | |
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)
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, retornafalse
.
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 LatLng s.
|
---|
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 LatLng s 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)
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. |
---|