GroundOverlay

classe final pública GroundOverlay estende Objeto

Uma sobreposição de solo é uma imagem fixa em um mapa. Uma sobreposição de solo tem as seguintes propriedades:

Cargo
Há duas maneiras de especificar a posição da sobreposição de solo:
  • Usando um local: é necessário fornecer uma imagem da sobreposição de solo, um LatLng em que a âncora será fixada e a largura da sobreposição (em metros). A âncora é, por padrão, 50% da parte superior 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 especificar esse valor, ele será calculado automaticamente para preservar as proporções.
  • Usando um limite: é preciso fornecer um LatLngBounds que contenha a imagem.
Você precisa especificar a posição da sobreposição de solo antes de adicioná-la ao mapa. Caso contrário, um IllegalArgumentException será gerado 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 usando um segundo método.
Imagem
A imagem (como uma BitmapDescriptor) a ser usada para esta sobreposição. A imagem será dimensionada para se ajustar à posição fornecida. Você precisa especificar uma imagem antes de adicionar a sobreposição de solo ao mapa. Caso contrário, uma IllegalArgumentException será gerada quando for adicionada ao mapa.
Rolamento
É o valor do giro da imagem 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 está alinhada de modo que o norte para cima.
Zindex
A ordem em que essa 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 as sobreposições com zIndexs menores. A ordem das sobreposições com o mesmo valor de zIndex é arbitrá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 a sobreposição é totalmente transparente. Se o bitmap especificado já for parcialmente transparente, a transparência de cada pixel será dimensionada de acordo (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 está visível ou invisível, ou seja, se ela é desenhada no mapa. Uma sobreposição de solo invisível não é desenhada, mas mantém todas as propriedades. Isso é opcional, e a visibilidade padrão é true, ou seja, visível.
Clicabilidade
Se você quiser lidar com eventos acionados 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 a propriedade for definida como true, o app receberá notificações para o GoogleMap.OnGroundOverlayClickListener registrado pelo setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).
Tag
Uma Object associada à sobreposição de solo. Por exemplo, a 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. 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.
 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
equals(outro objeto)
Teste se essa GroundOverlay for igual a outra.
float
getBearing (em inglês)
Recebe o rumo da sobreposição do solo em graus no sentido horário a partir do Norte.
LatLngBounds (em inglês)
getBounds()
Recebe os limites para a sobreposição de solo.
float
getHeight()
Recebe a altura da sobreposição de solo.
String
getId()
Recebe o ID desta sobreposição de solo.
LatLng
getPosition (link em inglês)
Recebe a localização 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 da sobreposição de solo.
int
hashCode().
boolean
isClickable().
Recebe a clicabilidade da sobreposição de solo.
boolean
isVisible()
Recebe a visibilidade da sobreposição de solo.
void
remove()
Remove essa sobreposição de solo do mapa.
void
setBearing(rolamento flutuante)
Define o rumo da sobreposição de solo (a direção em que o eixo vertical do ponto no solo aponta) em graus no sentido horário a partir do Norte.
void
setClickable(booleano clicável)
Define a clicabilidade da sobreposição de solo.
void
setDimensões(largura flutuante, altura flutuante)
Define as dimensões da sobreposição de solo.
void
setDimensões(largura flutuante)
Define a largura da sobreposição de solo.
void
setImage(DescriptorDescriptor imageDescriptor)
Define a imagem da sobreposição de solo.
void
setPosition(LatLng latLng)
Define a posição da sobreposição de solo mudando o local do ponto de fixação.
void
setPositionFromBounds(limites LatLngBounds)
Define a posição da sobreposição de solo, encaixando-a na LatLngBounds especificada.
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

booleano público igual a (outro objeto)

Teste se essa GroundOverlay for igual a outra.

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

flutuante público getBearing ()

Recebe o rumo da sobreposição do solo em graus no sentido horário a partir do Norte.

Retorna
  • o rolamento da sobreposição de solo.

público LatLngBounds getBounds ()

Recebe os limites para a sobreposição de solo. Essa ação ignora a rotação da sobreposição de solo.

Retorna
  • Uma LatLngBounds que contém a sobreposição de solo, ignorando a rotação.

ponto flutuante público getHeight ()

Recebe a altura da sobreposição de solo.

Retorna
  • a altura da sobreposição do solo em metros.

string pública getId ()

Recebe o ID desta sobreposição de solo. O ID será exclusivo entre todas as GroundOverlays em um mapa.

Retorna
  • este ID de sobreposição de solo.

LatLng getPosition ()

Recebe a localização 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 uma tag tiver sido definida com setTag; null se nenhuma tag tiver sido definida.

flutuante público getTransparency ()

Recebe a transparência dessa sobreposição de solo.

Retorna
  • a transparência da sobreposição de solo.

ponto flutuante público getWidth ()

Recebe a largura da sobreposição de solo.

Retorna
  • a largura da sobreposição do solo em metros.

ponto flutuante público getZIndex ()

Recebe o zIndex da sobreposição de solo.

Retorna
  • o zIndex da sobreposição de solo.

int público hashCode ()

booleano público isClickable ()

Recebe a clicabilidade da sobreposição de solo. Se a sobreposição de solo for clicável, o app receberá notificações para o GoogleMap.OnGroundOverlayClickListener quando o usuário clicar na sobreposição de solo. O listener de eventos é registrado pelo setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Retorna
  • true: se a sobreposição de solo for clicável, caso contrário, retorna false.

booleano público isVisible ()

Recebe a visibilidade da sobreposição de solo. Isso não retorna se a sobreposição de solo está realmente na tela, mas se ela será desenhada se estiver na janela de visualização da câmera.

Retorna
  • a visibilidade desta sobreposição de solo.

public void remove ()

Remove essa sobreposição de solo do mapa. Após a remoção de uma sobreposição de solo, o comportamento de todos os métodos dele será indefinido.

public void setBearing (rolamento flutuante)

Define o rumo da sobreposição de solo (a direção em que o eixo vertical do ponto no solo aponta) em graus no sentido horário a partir do Norte. A rotação é realizada sobre o 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 clicabilidade da sobreposição de solo. Se a sobreposição de solo for clicável, o app receberá notificações para o GoogleMap.OnGroundOverlayClickListener quando o usuário clicar na sobreposição de solo. O listener de eventos é registrado pelo setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Parâmetros
clicável Nova configuração de clicabilidade para a sobreposição de solo.

void void setDimensões (largura do flutuante, altura do 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 setDimensões (largura flutuante)

Define a largura da sobreposição de solo. A altura da sobreposição de solo será adaptada de acordo com a proporção.

Parâmetros
largura largura em metros

public void setImage (BitmapDescriptor imageDescriptor)

Define a imagem da sobreposição de solo. A nova imagem ocupará os mesmos limites da imagem antiga.

Parâmetros
imageDescriptor o BitmapDescriptor que será usado na sobreposição de solo.

public void setPosition (LatLng latLng)

Define a posição da sobreposição de solo mudando o local do ponto de fixação. Preserva todas as outras propriedades da imagem.

Parâmetros
latlng Um LatLng que é o novo local para colocar o ponto de fixação.

void public setPositionFromBounds (LatLngBounds limites)

Define a posição da sobreposição de solo, encaixando-a na LatLngBounds especificada. Esse método ignora a rotação (rolamento) da sobreposição de solo ao posicioná-la, mas o rolamento ainda será usado ao desenhar.

Parâmetros
limites Uma 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, a 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. 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. É sua responsabilidade chamar setTag(null) para limpar a tag quando ela não for mais necessária, evitando vazamentos de memória no app.

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

public void setTransparency (float 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 (booleano visível)

Define a visibilidade desta sobreposição de solo. Quando não visível, uma sobreposição de solo não é desenhada, mas mantém todas as propriedades dela.

Parâmetros
visível se true, a sobreposição de solo ficará visível. Caso false, 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