GroundOverlay

clase final pública GroundOverlay extiende el objeto

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

Posición
Existen dos maneras de especificar la posición de la superposición de suelo:
  • Ubicación: debes proporcionar una imagen de la superposición de suelo, un LatLng al que se fijará el anclaje y el ancho de la superposición (en metros). El el anclaje está, de forma predeterminada, a un 50% de la parte superior de la imagen y a un 50% de la izquierda imagen. 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, esta se calculadas para preservar las proporciones de la imagen.
  • Usa límites: 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 arrojará una IllegalArgumentException cuando la superposición de suelo esté agregado al mapa. Además, solo debes especificar la posición usando una de estas métodos en el objeto GroundOverlayOptions: De lo contrario, se arrojará una IllegalStateException cuando se especifique el uso de un segundo método.
Imagen
Es la imagen (como BitmapDescriptor) que se usará para esta superposición. La imagen será ajustada para que se adapte a la posición proporcionada. Debes especificar una imagen antes de agregar el suelo superponer en el mapa; De lo contrario, se arrojará una IllegalArgumentException cuando se cumpla lo siguiente: agregado al mapa.
Rumbo
Es la cantidad de rotación de la imagen en el sentido de las manecillas 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, que la imagen esté alineada de forma que quede hacia arriba que quede hacia el norte.
zIndex
Es el orden en el que se dibuja esta superposición de suelo respecto de otras superposiciones (incluidas las Polyline y TileOverlay, pero no Marker). Una superposición con una El zIndex mayor se dibuja sobre las superposiciones con zIndexes más pequeños. El orden de las superposiciones con el mismo valor zIndex es arbitrario. Esto es opcional, y el zIndex predeterminado es 0.
Transparencia
Transparencia de la superposición de suelo en el rango [0..1], donde 0 representa la la superposición es opaca, y 1 significa que es completamente transparente. Si el estado especificado mapa de bits ya es parcialmente transparente, se ajustará la transparencia de cada píxel en consecuencia (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 en 0.25, entonces el píxel se renderizará la pantalla con un valor alfa de 150). La especificación de esta propiedad es opcional, y la 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. Las superposiciones de suelo invisibles no se dibujan, pero conservan todas las demás propiedades. Esto es opcional y la visibilidad predeterminada es true, es decir, visible.
Posibilidad de hacer clics
Si deseas controlar los eventos que se activan cuando el usuario hace clic en la superposición de suelo, establece esta propiedad a true. Puedes cambiar este valor en cualquier momento. El valor predeterminado es false. Si esta propiedad se establece como true, tu app recibirá notificaciones para la Se registró GoogleMap.OnGroundOverlayClickListener hasta el setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).
Etiqueta
Es un objeto Object asociado con la superposición de suelo. Por ejemplo, Object puede contienen datos sobre lo que representa la superposición de suelo. Esto es más fácil que almacenar separar Map<GroundOverlay, Object>. Como otro ejemplo, puedes asociar un ID de String correspondiente al ID de un conjunto de datos. SDK de Google Maps para Android lee ni escribe esta propiedad.

Se debe llamar a los métodos de esta clase en el subproceso de IU de Android. De lo contrario, se arrojará una IllegalStateException durante 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));
 

Resumen de métodos públicos

boolean
es igual a(Otro objeto)
Comprueba si este GroundOverlay es igual a otro.
float
getBearing()
Obtiene el rumbo de la superposición de suelo en grados en el sentido de las manecillas del reloj desde el norte.
LatLngBounds
getBounds()
Obtiene los límites de la superposición de suelo.
float
getHeight()
Obtiene la altura de la superposición de suelo.
String
getId()
Obtiene el ID de esta superposición de suelo.
LatLng
getPosition()
Obtiene la ubicación del punto de anclaje.
Objeto
getTag()
Obtiene la etiqueta del círculo.
float
getTransparency()
Obtiene la transparencia de esta superposición de suelo.
float
getWidth()
Obtiene el ancho de la superposición de suelo.
float
getZIndex()
Obtiene el zIndex de esta superposición de suelo.
int
boolean
isClickable()
Obtiene la posibilidad de hacer clics en la superposición de suelo.
boolean
isVisible()
Obtiene la visibilidad de esta superposición de suelo.
void
remove()
Elimina esta superposición de suelo del mapa.
void
setBearing(rumbo flotante)
Establece el rumbo de la superposición de suelo (la dirección en la que el eje vertical del suelo puntos de superposición) en grados en el sentido de las manecillas del reloj desde el norte.
void
setClickable(booleano en el que se puede hacer clic)
Permite establecer la posibilidad de hacer clics en la superposición de suelo.
void
setDimensions(ancho de número de punto flotante, altura de número de punto flotante)
Establece las dimensiones de la superposición de suelo.
void
setDimensions(ancho flotante)
Establece el ancho de la superposición de suelo.
void
setImage(BitmapDescriptor imageDescriptor)
Establece la imagen para la superposición de suelo.
void
setPosition(latLng LatLng)
Establece la posición de la superposición de suelo cambiando la ubicación del punto de anclaje.
void
setPositionFromBounds(límites LatLngBounds)
Establece la posición de la superposición de suelo ajustándola a un objeto LatLngBounds determinado.
void
setTag(etiqueta de objeto)
Establece la etiqueta para la superposición de suelo.
void
setTransparency(transparencia de número de punto flotante)
Establece la transparencia de esta superposición de suelo.
void
setVisible(boolean visible)
Establece la visibilidad de esta superposición de suelo.
void
setZIndex(Índice z de número de punto flotante)
Establece el zIndex de esta superposición de suelo.

Resumen de métodos heredados

Métodos públicos

público booleano es igual a (Otro objeto)

Comprueba si este GroundOverlay es igual a otro.

Parámetros
otro un objeto Object.
Muestra
  • true si ambos objetos son el mismo objeto, es decir, this == other.

público número de punto flotante getBearing ()

Obtiene el rumbo de la superposición de suelo en grados en el sentido de las manecillas del reloj desde el norte.

Muestra
  • el rumbo de la superposición de suelo.

público LatLngBounds . getBounds ()

Obtiene los límites de la superposición de suelo. Esto ignora la rotación de la superposición de suelo.

Muestra
  • Un objeto LatLngBounds que contiene la superposición de suelo, sin tener en cuenta la rotación

público número de punto flotante getHeight ()

Obtiene la altura de la superposición de suelo.

Muestra
  • la altura de la superposición de suelo en metros.

público Cadena getId ()

Obtiene el ID de esta superposición de suelo. El ID será único entre todas las superposiciones de suelo de un mapa.

Muestra
  • ID de esta superposición de suelo.

público LatLng . getPosition ()

Obtiene la ubicación del punto de anclaje.

Muestra
  • la posición en el mapa (un LatLng).

público Objeto getTag ()

Obtiene la etiqueta del círculo.

Muestra
  • la etiqueta si se configuró con setTag; null si no se estableció ninguna etiqueta.

público número de punto flotante getTransparency ()

Obtiene la transparencia de esta superposición de suelo.

Muestra
  • la transparencia de esta superposición de suelo.

público número de punto flotante getWidth ()

Obtiene el ancho de la superposición de suelo.

Muestra
  • el ancho de la superposición de suelo en metros.

público número de punto flotante getZIndex ()

Obtiene el zIndex de esta superposición de suelo.

Muestra
  • el zIndex de la superposición de suelo.

público número entero hashCode ()

público booleano isClickable ()

Obtiene la posibilidad de hacer clics en la superposición de suelo. Si se puede hacer clic en la superposición de suelo, la app recibirá notificaciones al GoogleMap.OnGroundOverlayClickListener cuando el usuario hace clic en la superposición de suelo. El objeto de escucha de eventos se registra a través de setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Muestra
  • true si se puede hacer clic en la superposición de suelo; De lo contrario, muestra false.

público booleano isVisible ()

Obtiene la visibilidad de esta superposición de suelo. Ten en cuenta que esto no devuelve la superposición está realmente en la pantalla, pero si se dibujará si está contenida en el viewport.

Muestra
  • la visibilidad de esta superposición de suelo.

público anular quitar ()

Elimina esta superposición de suelo del mapa. Después de quitar una superposición de suelo, el comportamiento de todos sus métodos es indefinido.

público anular setBearing (rumbo flotante)

Establece el rumbo de la superposición de suelo (la dirección en la que el eje vertical del suelo puntos de superposición) en grados en el sentido de las manecillas del reloj desde el norte. La rotación se realiza sobre el ancla punto.

Parámetros
bearing rumbo en grados en sentido horario desde el norte

público anular setClickable (booleano en el que se puede hacer clic)

Permite establecer la posibilidad de hacer clics en la superposición de suelo. Si se puede hacer clic en la superposición de suelo, la app recibirá notificaciones al GoogleMap.OnGroundOverlayClickListener cuando el usuario hace clic en la superposición de suelo. El objeto de escucha de eventos se registra a través de setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Parámetros
se le puede hacer clic Nueva configuración de posibilidad de hacer clics para la superposición de suelo.

público anular setDimensions (ancho de número de punto flotante, altura de número de punto flotante)

Establece las dimensiones de la superposición de suelo. La imagen se estirará para ajustarse a las dimensiones.

Parámetros
ancho ancho en metros
alto altura en metros

público anular setDimensions (ancho de número de punto flotante)

Establece el ancho de la superposición de suelo. Se adaptará la altura de la superposición de suelo. según corresponda para conservar la relación de aspecto.

Parámetros
ancho ancho en metros

público anular setImage (BitmapDescriptor imageDescriptor)

Establece la imagen para la superposición de suelo. La imagen nueva ocupará los mismos límites que la anterior. imagen.

Parámetros
imageDescriptor el objeto BitmapDescriptor que se usará para esta superposición de suelo.

público anular setPosition (latLng de LatLng)

Establece la posición de la superposición de suelo cambiando la ubicación del punto de anclaje. Conservas todas las demás propiedades de la imagen.

Parámetros
latLng un objeto LatLng, que es la nueva ubicación para colocar el punto de anclaje.

público anular setPositionFromBounds (límites de LatLngBounds)

Establece la posición de la superposición de suelo ajustándola a un objeto LatLngBounds determinado. Esta ignorará la rotación (rumbo) de la superposición de suelo al posicionarla, pero mientras se dibuja.

Parámetros
límites un objeto LatLngBounds en el que se debe colocar la superposición de suelo.

público anular setTag (Etiqueta de objeto)

Establece la etiqueta para la superposición de suelo.

Puedes usar esta propiedad para asociar un objeto Object arbitrario con esta superposición de suelo. Por ejemplo, el objeto Object puede contener datos sobre lo que representa la superposición de suelo. Esta 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. SDK de Google Maps para Android no lee ni escribe esta propiedad. Es tu responsabilidad llamar a setTag(null) para borrar la etiqueta cuando ya no la necesites y, así, evitar fugas de memoria en tu app.

Parámetros
etiqueta si es nulo, se borra la etiqueta.

público anular setTransparency (transparencia de número de punto flotante)

Establece la transparencia de esta superposición de suelo. Consulta la documentación al principio de esta clase para obtener más información.

Parámetros
transparencia un número de punto flotante en el rango [0..1], donde 0 significa que el suelo superposición es opaca, y 1 significa que la superposición de suelo es transparente.

público anular setVisible (booleano visible)

Establece la visibilidad de esta superposición de suelo. Cuando no está visible, no se dibuja una superposición de suelo, pero conserva todas sus demás propiedades.

Parámetros
visible si es true, la superposición de suelo es visible; si es false, no es

público anular setZIndex (Índice z de número de punto flotante)

Establece el zIndex de esta superposición de suelo. Consulta la documentación al principio de esta clase para obtener más información información.

Parámetros
zIndex el zIndex de esta superposición de suelo