GroundOverlay

Una superposición de suelo es una imagen que se fija a un mapa. Una superposición de suelo tiene las siguientes propiedades:

Cargo

Existen dos formas de especificar la posición de la superposición de suelo:

• Con una ubicación: Debes proporcionar una imagen de la superposición de suelo, un LatLng en el que se fijará el ancla y el ancho de la superposición (en metros). De forma predeterminada, el anclaje está un 50% desde la parte superior de la imagen y un 50% desde la izquierda de ella. Esto se puede cambiar. De manera opcional, puedes proporcionar la altura de la superposición (en metros). Si no proporcionas la altura de la superposición, se calculará automáticamente para conservar las proporciones de la imagen.
• Usa un límite: Debes proporcionar un LatLngBounds que contendrá la imagen.

Debes especificar la posición de la superposición de suelo antes de agregarla al mapa; de lo contrario, se mostrará una IllegalArgumentException cuando se agregue la superposición de suelo. Además, solo debes especificar la posición usando uno de estos métodos en el objeto GroundOverlayOptions; de lo contrario, se arrojará una IllegalStateException cuando se especifique con un segundo método.

De imagen

La imagen (como BitmapDescriptor) que se usará para esta superposición Se ajustará la escala de la imagen para adaptarla a la posición proporcionada. Debes especificar una imagen antes de agregar la superposición de suelo al mapa; de lo contrario, se mostrará una IllegalArgumentException cuando se agregue al mapa.

Orientación

Cantidad que se debe rotar la imagen en el sentido de las agujas del reloj. El centro de la rotación será el ancla de la imagen. Esto es opcional y el rumbo predeterminado es 0, es decir, la imagen se alinea para que el Norte quede arriba.

Índice Z

Es el orden en el que se dibuja esta superposición de suelo con respecto a otras superposiciones (incluidas Polyline y TileOverlay, pero no Marker). Una superposición con un zIndex más grande se dibuja sobre las superposiciones con zIndexes más pequeños. El orden de las superposiciones con el mismo valor de zIndex es arbitrario. Esto es opcional y el valor predeterminado de zIndex es 0.

Transparencia

La transparencia de la superposición de suelo en el rango [0..1], donde 0 significa que la superposición es opaca y 1 significa que es completamente transparente. Si el mapa de bits especificado ya es parcialmente transparente, se ajustará la transparencia de cada píxel según corresponda (por ejemplo, si un píxel del mapa de bits tiene un valor alfa de 200 y especificas la transparencia de la superposición de suelo como 0.25), se procesará el píxel en la pantalla con un valor alfa de 150. La especificación de esta propiedad es opcional y la transparencia predeterminada es 0 (opaco).

Visibilidad

Indica si la superposición de suelo es visible o invisible, es decir, si se dibuja en el mapa. No se dibuja una superposición de suelo invisible, pero se conservan todas las demás propiedades. Esto es opcional y la visibilidad predeterminada es true, es decir, visible.

Hacer clic

Si deseas controlar los eventos que se activan cuando el usuario hace clic en la superposición de suelo, establece esta propiedad en true. Puedes cambiar este valor en cualquier momento. El valor predeterminado es false. Si esta propiedad se configura como true, tu app recibirá notificaciones para el GoogleMap.OnGroundOverlayClickListener registrado a través de setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Etiqueta

Es un objeto Object asociado con la superposición de suelo. Por ejemplo, Object puede contener datos sobre lo que representa la superposición de suelo. Esto es más fácil que almacenar un Map<GroundOverlay, Object> separado. Como otro ejemplo, puedes asociar un ID de String correspondiente al ID de un conjunto de datos. El SDK de Google Maps para Android no lee ni escribe esta propiedad.

Los métodos de esta clase deben llamarse en el subproceso de la IU de Android. De lo contrario, se arrojará una IllegalStateException en el tiempo de ejecución.

Ejemplo

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