GroundOverlay

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

Posição

Há duas maneiras de especificar a posição da sobreposição de solo:

• Usando um local: você deve fornecer uma imagem da sobreposição de solo, um LatLng no qual a âncora será fixada e a largura da sobreposição (em metros). A âncora está, por padrão, 50% da parte superior da imagem e 50% da esquerda do imagem. Isso pode ser alterado. Como opção, é possível fornecer a altura da sobreposição (em metros). Se você não fornecer a altura da sobreposição, ela será automaticamente calculada para preservar as proporções da imagem.
• Usando limites: você precisa fornecer um LatLngBounds que contenha a imagem.

. Você deve especificar a posição da sobreposição de solo antes de adicioná-la ao mapa, Caso contrário, uma IllegalArgumentException será gerada quando a sobreposição de solo for adicionados ao mapa. Além disso, você só deve especificar a posição usando um dos no objeto GroundOverlayOptions. Caso contrário, uma IllegalStateException será gerada ao especificar usando um segundo método.

Imagem

A imagem (como um BitmapDescriptor) a ser usada para a sobreposição. A imagem será dimensionado para se ajustar à posição fornecida. Você deve especificar uma imagem antes de adicionar o solo sobreposição ao mapa; Caso contrário, uma IllegalArgumentException será gerada adicionados ao mapa.

Procedimento

A quantidade em que a imagem precisa ser girada no sentido horário. O centro da será a âncora da imagem. Isso é opcional, e o rumo padrão é 0, ou seja, que a imagem fique alinhada com o norte.

zIndex

A ordem em que esta sobreposição de solo é desenhada em relação a outras sobreposições (incluindo Polylines e TileOverlays, mas não Markers). Uma sobreposição com zIndex maior é desenhado sobre sobreposições com zindex menores. A ordem das sobreposições com o mesmo valor de zIndex é arbitrário. É opcional, e o zIndex padrão é 0.

Transparência

Transparência da sobreposição de solo no intervalo [0..1], em que 0 significa o "Sobreposição" é opaca e 1 significa que ela é totalmente transparente. Se o valor especificado o bitmap já é 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 desta propriedade é opcional, e o a transparência padrão é 0 (opaca).

Visibilidade

Indica se a sobreposição de solo está visível ou invisível, ou seja, se foi desenhada sobre mapa. Uma sobreposição de solo invisível não é desenhada, mas mantém todas as suas propriedades. Isso é opcional, e a visibilidade padrão é true, ou seja, visível.

Clicabilidade

Para gerenciar eventos disparados quando o usuário clica na sobreposição de solo, defina este como true. É possível alterar esse valor a qualquer momento. O padrão é false. Se esta propriedade for definida como true, seu aplicativo receberá notificações para o GoogleMap.OnGroundOverlayClickListener registrado(a) pelo setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Tag

Uma Object associada à sobreposição de solo. Por exemplo, a Object pode contêm dados sobre o que a sobreposição de solo representa. Isso é mais fácil do que armazenar separar Map<GroundOverlay, Object>. Como outro exemplo, você pode associar um ID String correspondente ao ID de um conjunto de dados. O SDK do Google Maps para Android também não lê nem grava essa propriedade.

Os métodos dessa classe precisam ser chamados na linha de execução de interface do Android. Caso contrário, uma IllegalStateException 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));