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.
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 objetoGroundOverlayOptions
: De lo contrario, se arrojará unaIllegalStateException
cuando se especifique el uso de un segundo método. - Ubicación: debes proporcionar una imagen de la superposición de suelo, un
- 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á unaIllegalArgumentException
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
yTileOverlay
, pero noMarker
). 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]
, donde0
representa la la superposición es opaca, y1
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 esfalse
. Si esta propiedad se establece comotrue
, tu app recibirá notificaciones para la Se registróGoogleMap.OnGroundOverlayClickListener
hasta elsetOnGroundOverlayClickListener(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 separarMap<GroundOverlay, Object>
. Como otro ejemplo, puedes asociar un ID deString
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 |
hashCode()
|
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 | |
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, muestrafalse
.
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 |
---|