Superposição de solo

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));