GroundOverlay

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