Uma sobreposição de solo é uma imagem fixa em um mapa. Ela tem as seguintes propriedades:
- Cargo
- Há duas maneiras de especificar a posição da sobreposição de solo:
- Usando um local: forneça uma imagem da sobreposição de solo, um
LatLng
em que a âncora será fixada e a largura da sobreposição (em metros). Por padrão, a âncora fica a 50% do topo da imagem e 50% da esquerda da imagem. Isso pode ser alterado. Também é possível informar a altura da sobreposição (em metros). Se você não informar a altura da sobreposição, ela será calculada automaticamente para preservar as proporções. - Usando limites: você precisa fornecer um
LatLngBounds
que conterá a imagem.
IllegalArgumentException
quando a sobreposição for adicionada ao mapa. Além disso, só é preciso especificar a posição usando um desses métodos no objetoGroundOverlayOptions
. Caso contrário, umIllegalStateException
será gerado ao especificar o uso de um segundo método. - Usando um local: forneça uma imagem da sobreposição de solo, um
- Imagem
- A imagem (como um
BitmapDescriptor
) a ser usada para a sobreposição. A imagem será redimensionada para se ajustar à posição fornecida. Você precisa especificar uma imagem antes de adicionar a sobreposição de solo ao mapa. Se não, umIllegalArgumentException
será gerado quando ela for adicionada ao mapa. - Rolamento
- O valor em que a imagem precisa ser girada no sentido horário. O centro da rotação será a âncora da imagem. Isso é opcional e o rolamento padrão é 0, ou seja, a imagem esteja alinhada de forma que para cima esteja ao norte.
- zIndex
- A ordem em que a sobreposição de solo é desenhada em relação a outras sobreposições (incluindo
Polyline
s eTileOverlay
s, mas nãoMarker
s). Uma sobreposição com um zIndex maior é desenhada sobre sobreposições com zÍndices menores. A ordem das sobreposições com o mesmo valor de zIndex é aleatória. Isso é opcional, e o zIndex padrão é 0. - Transparência
- Transparência da sobreposição de solo no intervalo
[0..1]
, em que0
significa que a sobreposição é opaca e1
significa que ela é totalmente transparente. Se o bitmap especificado já estiver parcialmente transparente, a transparência de cada pixel será dimensionada corretamente.Por exemplo, se um pixel no bitmap tiver um valor Alfa de 200 e você especificar a transparência da sobreposição de solo como 0,25, o pixel será renderizado na tela com um valor Alfa de 150. A especificação dessa propriedade é opcional e a transparência padrão é 0 (opaca). - Visibilidade
- Indica se a sobreposição de solo é visível ou invisível, ou seja, se é desenhada no mapa. Uma sobreposição de solo invisível não é desenhada, mas mantém todas as outras propriedades.
Isso é opcional, e a visibilidade padrão é
true
, ou seja, visível. - Facilidade de clique
- Se você quiser processar eventos disparados quando o usuário clicar na sobreposição de solo, defina essa propriedade como
true
. É possível alterar esse valor a qualquer momento. O padrão éfalse
. Se essa propriedade estiver definida comotrue
, seu app vai receber notificações para oGoogleMap.OnGroundOverlayClickListener
registrado pelosetOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
. - Tag
- Um
Object
associado à sobreposição de solo. Por exemplo,Object
pode conter dados sobre o que a sobreposição de solo representa. Isso é mais fácil do que armazenar umMap<GroundOverlay, Object>
separado. Também é 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 nessa classe precisam ser chamados na linha de execução de interface do Android. Caso contrário, uma IllegalStateException
vai ser gerada no momento da execução.
Exemplo
GoogleMap map = ...; // get a map.
BitmapDescriptor imageDescriptor = ...; // get an image.
LatLngBounds bounds = ...; // get a bounds
// Adds a ground overlay with 50% transparency.
GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
.image(imageDescriptor)
.positionFromBounds(bounds)
.transparency(0.5));
Resumo do método público
boolean |
igual a(objeto "outro")
Testa se esse
GroundOverlay é igual a outro. |
float |
getBearing()
Define o rolamento da sobreposição de solo em graus no sentido horário a partir do norte.
|
LatLngBounds |
getBounds()
Recupera os limites da sobreposição de solo.
|
float |
getHeight()
Recebe a altura da sobreposição de solo.
|
String |
getId()
Recebe o ID dessa sobreposição de solo.
|
LatLng |
getPosition()
Recebe o local do ponto de fixação.
|
Objeto |
getTag()
Recebe a tag do círculo.
|
float |
getTransparency()
Recebe a transparência dessa sobreposição de solo.
|
float |
getWidth()
Recebe a largura da sobreposição de solo.
|
float |
getZIndex()
Recebe o zIndex desta sobreposição de solo.
|
int |
hashCode()
|
boolean |
isClickable()
Recebe a capacidade de receber cliques da sobreposição de solo.
|
boolean |
isVisible()
Recebe a visibilidade desta sobreposição de solo.
|
void |
remove()
Remove a sobreposição de solo do mapa.
|
void |
setBearing(rolamento de flutuação)
Define o rumo da sobreposição de solo (a direção que o eixo vertical da sobreposição do solo aponta) em graus no sentido horário a partir do Norte.
|
void |
setClickable(booleano clicável)
Define a capacidade de receber cliques da sobreposição de solo.
|
void |
setDimensions(largura do ponto flutuante, altura do ponto flutuante)
Define as dimensões da sobreposição de solo.
|
void |
setDimensions(largura flutuante)
Define a largura da sobreposição de solo.
|
void | |
void |
setPosition(LatLng latLng)
Define a posição da sobreposição de solo alterando o local do ponto de fixação.
|
void |
setPositionFromBounds(limites de LatLngBounds)
Define a posição da sobreposição de solo ajustando-a ao
LatLngBounds especificado. |
void |
setTag(tag de objeto)
Define a tag para a sobreposição de solo.
|
void |
setTransparency(transparência flutuante)
Define a transparência dessa sobreposição de solo.
|
void |
setVisible(booleano visível)
Define a visibilidade desta sobreposição de solo.
|
void |
setZIndex(zIndex flutuante)
Define o zIndex desta sobreposição de solo.
|
Resumo do método herdado
Métodos públicos
public booleano é igual a (Outro objeto)
Testa se esse GroundOverlay
é igual a outro.
Parâmetros
Outras | um Object . |
---|
Retorna
- true se os dois objetos forem o mesmo, ou seja, == other.
public float getBearing ()
Define o rolamento da sobreposição de solo em graus no sentido horário a partir do norte.
Retorna
- o rolamento da sobreposição de solo.
public LatLngBounds getBounds ()
Recupera os limites da sobreposição de solo. Isso ignora a rotação da sobreposição de solo.
Retorna
- uma
LatLngBounds
que contém a sobreposição de solo, ignorando a rotação.
public float getHeight ()
Recebe a altura da sobreposição de solo.
Retorna
- a altura da sobreposição de solo em metros.
public String getId ()
Recebe o ID dessa sobreposição de solo. O ID será exclusivo entre todos os GroundOverlays em um mapa.
Retorna
- o ID desta sobreposição de solo.
public LatLng getPosition ()
Recebe o local do ponto de fixação.
Retorna
- a posição no mapa (um
LatLng
).
Objeto público getTag ()
Recebe a tag do círculo.
Retorna
- a tag se ela tiver sido definida com
setTag
, enull
se nenhuma tag tiver sido definida.
public float getTransparency ()
Recebe a transparência dessa sobreposição de solo.
Retorna
- a transparência dessa sobreposição de solo.
public float getWidth ()
Recebe a largura da sobreposição de solo.
Retorna
- a largura da sobreposição de solo em metros.
public float getZIndex ()
Recebe o zIndex desta sobreposição de solo.
Retorna
- o zIndex da sobreposição de solo.
public int hashCode ()
public boolean isClickable ()
Recebe a capacidade de receber cliques da sobreposição de solo. Se a sobreposição de solo for clicável, seu app receberá notificações para GoogleMap.OnGroundOverlayClickListener
quando o usuário clicar nela. O listener de eventos é registrado usando setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
.
Retorna
true
se a sobreposição de solo for clicável. Caso contrário, retornafalse
.
public boolean isVisible ()
Recebe a visibilidade desta sobreposição de solo. Esse método não indica se a sobreposição de solo está realmente na tela, mas se ela será desenhada se estiver contida na janela de visualização da câmera.
Retorna
- a visibilidade desta sobreposição de solo.
public void remover ()
Remove a sobreposição de solo do mapa. Depois que uma sobreposição desse tipo é removida, o comportamento de todos os métodos dela fica indefinido.
public void setBearing (flutuante)
Define o rumo da sobreposição de solo (a direção que o eixo vertical da sobreposição do solo aponta) em graus no sentido horário a partir do Norte. A rotação é realizada em torno do ponto de fixação.
Parâmetros
bearing | rumo em graus no sentido horário a partir do Norte |
---|
public void setClickable (booleano clicável)
Define a capacidade de receber cliques da sobreposição de solo. Se a sobreposição de solo for clicável, seu app receberá notificações para GoogleMap.OnGroundOverlayClickListener
quando o usuário clicar nela. O listener de eventos é registrado usando setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
.
Parâmetros
clicável | Nova configuração de clicabilidade para a sobreposição de solo. |
---|
public void setDimensions (largura do ponto flutuante, altura do ponto flutuante)
Define as dimensões da sobreposição de solo. A imagem será esticada para se ajustar às dimensões.
Parâmetros
largura | largura em metros |
---|---|
altura | altura em metros |
public void setDimensions (largura do ponto flutuante)
Define a largura da sobreposição de solo. A altura da sobreposição de solo será adaptada para preservar a proporção.
Parâmetros
largura | largura em metros |
---|
public void setImage (BitmapDescriptor imageDescriptor)
Define a imagem para a sobreposição de solo. A nova imagem ocupará os mesmos limites que a antiga.
Parâmetros
imageDescriptor | o BitmapDescriptor que será usado nessa sobreposição de solo.
|
---|
public void setPosition (LatLng latLng)
Define a posição da sobreposição de solo alterando o local do ponto de fixação. Preserva todas as outras propriedades da imagem.
Parâmetros
latLng | uma LatLng , que é o novo local para colocar o ponto de fixação.
|
---|
public void setPositionFromBounds (limites de LatLngBounds)
Define a posição da sobreposição de solo ajustando-a ao LatLngBounds
especificado. Esse método ignora a rotação (rolamento) da sobreposição de solo durante o posicionamento, mas o rolamento ainda é usado ao desenhá-la.
Parâmetros
limites | um LatLngBounds em que a sobreposição de solo será colocada.
|
---|
public void setTag (tag de objeto)
Define a tag para a sobreposição de solo.
Você pode usar essa propriedade para associar um Object
arbitrário a essa sobreposição de solo.
Por exemplo, Object
pode conter dados sobre o que a sobreposição de solo representa. Isso é mais fácil do que armazenar um Map<GroundOverlay, Object>
separado. Também é 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. É sua responsabilidade chamar setTag(null)
para limpar a tag quando você não precisar mais dela e evitar vazamentos de memória no app.
Parâmetros
tag | se nulo, a tag é apagada. |
---|
public void setTransparency (transparência flutuante)
Define a transparência dessa sobreposição de solo. Consulte a documentação na parte superior desta classe para mais informações.
Parâmetros
transparência | um ponto flutuante no intervalo [0..1] , em que 0 significa que a sobreposição de solo é opaca e 1 significa que ela é transparente.
|
---|
public void setVisible (boolean visible)
Define a visibilidade desta sobreposição de solo. Quando não está visível, uma sobreposição de solo não é desenhada, mas mantém todas as outras propriedades.
Parâmetros
visível | se for true , a sobreposição de solo será visível; se false , ela não será
|
---|
public void setZIndex (float zIndex)
Define o zIndex desta sobreposição de solo. Consulte a documentação na parte superior desta classe para mais informações.
Parâmetros
zIndex | o zIndex desta sobreposição de solo |
---|