GroundOverlay

classe final pública GroundOverlay estende Object

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.
É preciso especificar a posição da sobreposição de solo antes de adicioná-la ao mapa. Caso contrário, será gerado um IllegalArgumentException quando a sobreposição for adicionada ao mapa. Além disso, só é preciso especificar a posição usando um desses métodos no objeto GroundOverlayOptions. Caso contrário, um IllegalStateException será gerado ao especificar o uso de um segundo método.
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, um IllegalArgumentException 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 Polylines e TileOverlays, mas não Markers). 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 que 0 significa que a sobreposição é opaca e 1 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 como true, seu app vai receber notificações para o GoogleMap.OnGroundOverlayClickListener registrado pelo setOnGroundOverlayClickListener(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 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.

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
setImage(BitmapDescriptor imageDescriptor)
Define a imagem para a sobreposição de solo.
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, e null 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, retorna false.

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