Marker

clase final pública Marcador extiende el objeto

Es un ícono ubicado en un punto específico de la superficie del mapa. Los íconos de marcador se dibujan orientados en la pantalla del dispositivo y no en la superficie del mapa; es decir, no necesariamente cambiarán debido a las rotaciones, la inclinación o el zoom del mapa.

Un marcador tiene las siguientes propiedades:

Alfa
Establece la opacidad del marcador. El valor predeterminado es 1.0.
Anclaje
Es el punto de la imagen que se colocará en la posición LatLng del marcador. El valor predeterminado es un 50% desde la izquierda y en la parte inferior de la imagen.
Posición
Es el valor LatLng correspondiente a la posición del marcador en el mapa. Puedes cambiar este valor en en cualquier momento si deseas mover el marcador.
Título
Es una cadena de texto que se muestra en una ventana de información cuando el usuario presiona el marcador. Puedes cambiar este valor en cualquier momento.
Fragmento
Es el texto adicional que se muestra debajo del título. Puedes cambiar este valor en cualquier momento.
Ícono
Es un mapa de bits que se muestra para el marcador. Si no se configura el ícono, se mostrará el predeterminado que se muestra. Puedes especificar un color alternativo para el ícono predeterminado mediante defaultMarker(float).
Estado de arrastre
Si deseas permitir que el usuario arrastre el marcador, establece esta propiedad en true. Tú este valor puede cambiar en cualquier momento. El valor predeterminado es false.
Visibilidad
De forma predeterminada, el marcador es visible. Para que el marcador sea invisible, establece esta propiedad en false Puedes cambiar este valor en cualquier momento.
Plano o billboard
Si el marcador se encuentra plano respecto del mapa, permanecerá fijo en él mientras la cámara gira y se inclina, pero se mantiene del mismo tamaño que la cámara, a diferencia de GroundOverlay. Si el marcador es una valla publicitaria, siempre se dibujará de frente a la cámara y girará y se inclinará con la cámara. El valor predeterminado es una valla publicitaria (false).
Rotación
Es la rotación del marcador en grados en el sentido de las manecillas del reloj alrededor del punto de anclaje del marcador. El eje de rotación es perpendicular al marcador. Una rotación de 0 corresponde al valor predeterminado del marcador. Cuando el marcador se encuentra plano en el mapa, la posición predeterminada es el norte. alineado, y la rotación hace que el marcador siempre permanezca plano en el mapa. Cuando es una valla publicitaria, la posición predeterminada es hacia arriba y la rotación hace que el marcador siempre debe apuntar hacia la cámara. El valor predeterminado es 0.
zIndex
Es el orden de dibujo del marcador. Los marcadores se dibujan en el orden del zIndex, con el marcador con el zIndex más alto dibujado en la parte superior. Al establecer la propiedad zIndex para cada marcador, puedes controlar a qué objetivo de presión es más probable que el usuario alcance. El valor predeterminado es 0.
Etiqueta
Es un Object asociado con el marcador. Por ejemplo, Object puede contener datos sobre lo que representa el marcador. Esto es más fácil que almacenar un Map<Marker, 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.

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.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));

Guía para desarrolladores

Para obtener más información, consulta el artículo Marcadores. .

Resumen de clases anidadas

Interfaz Marker.CollisionBehavior Indica cómo se trata el marcador cuando está involucrado en una colisión con otros marcadores o bases. etiquetas del mapa.

Resumen de métodos públicos

boolean
es igual a(Otro objeto)
Comprueba si este Marker es igual a otro.
float
getAlpha()
Obtiene el alfa del marcador.
String
getId()
Obtiene el ID de este marcador.
LatLng
getPosition()
Muestra la posición del marcador.
float
getRotation()
Obtiene la rotación del marcador.
String
getSnippet()
Obtiene el fragmento del marcador.
Objeto
getTag()
Obtiene la etiqueta del marcador.
String
getTitle()
Obtiene el título del marcador.
float
getZIndex()
Muestra el zIndex del marcador.
int
hashCode()
void
hideInfoWindow()
Oculta la ventana de información si se muestra desde este marcador.
boolean
isDraggable()
Obtiene la capacidad de arrastrar del marcador.
boolean
isFlat()
Obtiene la configuración plana del marcador.
boolean
isInfoWindowShown()
Indica si la ventana de información se muestra actualmente sobre este marcador.
boolean
isVisible()
Obtiene la configuración de visibilidad de este marcador.
void
remove()
Elimina este marcador del mapa.
void
setAlpha(alfa de número de punto flotante)
Establece el alfa (opacidad) del marcador.
void
setAnchor(flotante ancla, flotante ancla)
Establece el punto de anclaje del marcador.
void
setDraggable(boolean draggable)
Permite establecer la capacidad de arrastre del marcador.
void
setFlat(booleano)
Establece si este marcador debe quedar plano respecto del true del mapa o una valla publicitaria orientada al cámara false.
void
setIcon(BitmapDescriptor iconDescriptor)
Establece el ícono del marcador.
void
setInfoWindowAnchor(float AnchoU, float AnchorV)
Especifica el punto de la imagen del marcador en el que se debe anclar la ventana de información cuando está que se muestra.
void
setPosition(latlng LatLng)
Establece la ubicación del marcador.
void
setRotation(rotación de número de punto flotante)
Establece la rotación del marcador en grados en el sentido de las manecillas del reloj alrededor del punto de anclaje del marcador.
void
setSnippet(fragmento de cadena)
Establece el fragmento del marcador.
void
setTag(etiqueta de objeto)
Establece la etiqueta del marcador.
void
setTitle(título de cadena)
Establece el título del marcador.
void
setVisible(boolean visible)
Establece la visibilidad de este marcador.
void
setZIndex(Índice z de número de punto flotante)
Establece el zIndex del marcador.
void
showInfoWindow()
Muestra la ventana de información de este marcador en el mapa si este marcador es isVisible().

Resumen de métodos heredados

Métodos públicos

público booleano es igual a (Otro objeto)

Comprueba si este Marker 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 getAlpha ()

Obtiene el alfa del marcador.

Muestra
  • el alfa del marcador en el rango [0, 1].

público Cadena getId ()

Obtiene el ID de este marcador. El ID será único entre todos los marcadores de un mapa.

Muestra
  • el ID de este marcador.

público LatLng . getPosition ()

Muestra la posición del marcador.

Muestra
  • Un objeto LatLng que especifica la posición actual del marcador.

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

Obtiene la rotación del marcador.

Muestra
  • la rotación del marcador en grados en el sentido de las manecillas del reloj desde la posición predeterminada.

público Cadena getSnippet ()

Obtiene el fragmento del marcador.

Muestra
  • Es una cadena que contiene el fragmento del marcador.

público Objeto getTag ()

Obtiene la etiqueta del marcador.

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

público Cadena getTitle ()

Obtiene el título del marcador.

Muestra
  • Es una cadena que contiene el título del marcador.

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

Muestra el zIndex del marcador.

Muestra
  • el zIndex de este marcador.

público número entero hashCode ()

público anular hideInfoWindow ()

Oculta la ventana de información si se muestra desde este marcador.

Este método no tiene efecto si el marcador no está visible.

público booleano isDraggable ()

Obtiene la capacidad de arrastrar del marcador. Cuando un marcador es arrastrable, el usuario puede moverlo mantener presionado el marcador.

Muestra
  • true si el marcador es arrastrable; De lo contrario, muestra false.

público booleano isFlat ()

Obtiene la configuración plana del marcador.

Muestra
  • true si el marcador es plano respecto del mapa; false si el marcador debe frente a la cámara.

público booleano isInfoWindowShown ()

Indica si la ventana de información se muestra actualmente sobre este marcador. Esto no considera si la ventana de información se ve o no en la pantalla.

público booleano isVisible ()

Obtiene la configuración de visibilidad de este marcador. Ten en cuenta que esto no indica si el marcador está dentro del viewport de la pantalla. Indica si el marcador se dibujará si se contenidos en el viewport de la pantalla.

Muestra
  • la visibilidad de este marcador.

público anular quitar ()

Elimina este marcador del mapa. Una vez que se quita un marcador, el comportamiento de todos sus no está definido.

público anular setAlpha (alfa del punto flotante)

Establece el alfa (opacidad) del marcador. Valor de 0 a 1, donde 0 significa que el marcador es completamente transparente, mientras que 1 significa que el marcador es completamente opaco.

Parámetros
alfa

público anular setAnchor (flotante AnchoU, float AnchoV)

Establece el punto de anclaje del marcador.

El anclaje especifica el punto en la imagen del ícono que se ancla a la posición del marcador en la superficie de la Tierra.

El punto de anclaje se especifica en el espacio continuo [0.0, 1.0] x [0.0, 1.0], donde (0, 0) es la esquina superior izquierda de la imagen y (1, 1) es la esquina inferior derecha. El punto de anclaje en una imagen de A x Alto es el punto discreto de cuadrícula más cercano en un eje (W + 1) x. Cuadrícula (H + 1), que se obtiene escalando y redondeando después. Por ejemplo, en una imagen de 4 x 2, el punto de anclaje (0.7, 0.6) se resuelve en el punto de cuadrícula en (3, 1). 

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

Parámetros
anchorU Coordenada u del anclaje, como una proporción del ancho de la imagen (dentro del rango [0, 1]).
anchorV coordenada v del anclaje, como una proporción de la altura de la imagen (en el rango [0, 1]).

público anular setDraggable (booleano arrastrable)

Permite establecer la capacidad de arrastre del marcador. Cuando un marcador es arrastrable, el usuario puede moverlo mantener presionado el marcador.

Parámetros
arrastrable

público anular setFlat (booleano plano)

Establece si este marcador debe quedar plano respecto del true del mapa o una valla publicitaria orientada al cámara false.

Parámetros
fijas

público anular setIcon (BitmapDescriptor iconDescriptor)

Establece el ícono del marcador.

Parámetros
iconDescriptor si es nulo, se usa el marcador predeterminado.

público anular setInfoWindowAnchor (flotante AnchoU, float AnchoV)

Especifica el punto de la imagen del marcador en el que se debe anclar la ventana de información cuando está que se muestra. Se especifica en el mismo sistema de coordenadas que el ancla. Consulta setAnchor(float, float) para obtener más información. El valor predeterminado es la parte superior central de la imagen.

Parámetros
anchorU Coordenada u del anclaje de la ventana de información, como relación del ancho de la imagen (en el rango [0, 1]).
anchorV coordenada v del anclaje de la ventana de información, como una proporción de la altura de la imagen (en el rango [0, 1]).

público anular setPosition (latlng LatLng)

Establece la ubicación del marcador.

Parámetros
latlng

público anular setRotation (rotación de número de punto flotante)

Establece la rotación del marcador en grados en el sentido de las manecillas del reloj alrededor del punto de anclaje del marcador. El eje de rotación es perpendicular al marcador. Una rotación de 0 corresponde a la posición predeterminada del marcador.

Parámetros
rotación

público anular setSnippet (Fragmento de cadena)

Establece el fragmento del marcador.

Parámetros
resumen si es nulo, se borra el fragmento.

público anular setTag (Etiqueta de objeto)

Establece la etiqueta del marcador.

Puedes usar esta propiedad para asociar un Object arbitrario con este marcador. Para Por ejemplo, Object puede contener datos sobre lo que representa el marcador. Es más fácil que almacenar un Map<Marker, Object> independiente. Como otro ejemplo, puedes asociar un String: Es el ID que corresponde al ID de un conjunto de datos. SDK de Google Maps para Android lee ni escribe esta propiedad. Es tu responsabilidad llamar a setTag(null) para borrar la etiqueta cuando ya no la necesites, para evitar fugas de memoria en tu aplicación.

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

público anular setTitle (Título de cadena)

Establece el título del marcador.

Parámetros
título si es nulo, se borra el título.

público anular setVisible (booleano visible)

Establece la visibilidad de este marcador. Si se establece en false y actualmente hay una ventana de información que se muestra para este marcador, se ocultará la ventana de información.

Parámetros
visible

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

Establece el zIndex del marcador.

Parámetros
zIndex

público anular showInfoWindow ()

Muestra la ventana de información de este marcador en el mapa si este marcador es isVisible().

Arroja
IllegalArgumentException si marker no está en este mapa