Referencia de clase GMSMarker


Descripción general

Un marcador es un ícono colocado en un punto determinado de la superficie del mapa.

El ícono de un marcador se dibuja orientado respecto de la pantalla del dispositivo en lugar de la superficie del mapa; es decir, no necesariamente cambiará la orientación debido a las rotaciones, la inclinación o el zoom del mapa.

Hereda GMSOverlay.

Lo hereda GMSAdvancedMarker.

Funciones de miembro públicas estáticas

(tipo de instancia)+ markerWithPosition:
 Es un constructor de conveniencia para un marcador predeterminado.
(Imagen de la IU *)+ markerImageWithColor:
 Crea una versión matizada de la imagen predeterminada del marcador para usarla como ícono.

Propiedades

CLLocationCoordinate2Dposition
 Posición del marcador.
NSString * fragmento
 Texto del fragmento, que se muestra debajo del título en la ventana de información cuando se selecciona.
UIImage * ícono
 Ícono de marcador para renderizar.
UIView * iconView
 Vista de marcador para renderizar.
BOOLtracksViewChanges.
 Controla si se debe volver a dibujar el ícono de este marcador en cada fotograma.
BOOLtracksInfoWindowChanges.
 Controla si se debe volver a dibujar la ventana de información de este marcador en cada fotograma.
CGPointgroundAnchor
 El anclaje de suelo especifica el punto en la imagen del ícono que está anclado a la posición del marcador en la superficie terrestre.
CGPointinfoWindowAnchor
 El anclaje de la ventana de información especifica el punto de la imagen del icono en el que se debe anclar la ventana de información, el cual se mostrará justo arriba de este punto.
GMSMarkerAnimationaparecenAnimation
 Controla la animación utilizada cuando se coloca este marcador en una GMSMapView (el valor predeterminado es kGMSMarkerAnimationNone, sin animación).
BOOLarrastrables
 Controla si se puede arrastrar este marcador de forma interactiva (NO predeterminado).
BOOLplana
 Controla si este marcador debe mostrarse plano respecto de la superficie terrestre (SÍ) o una valla publicitaria frente a la cámara (NO, predeterminado).
CLLocationDegreesrotación
 Establece la rotación del marcador en grados en el sentido de las manecillas del reloj sobre su punto de anclaje.
número de punto flotanteopacidad
 Establece la opacidad del marcador, entre 0 (completamente transparente) y 1 (predeterminado), inclusive.
GMSMarkerLayercapa
 Proporciona la capa Core Animation para este GMSMarker.
GMSPanoramaViewpanoramaView
 panoramaView especifica qué vista panorámica intentará mostrar este marcador.
NSString * title
 Es el título, una descripción breve de la superposición.
GMSMapViewmapa
 El mapa en el que se encuentra esta superposición
BOOLque se puede presionar
 Si esta superposición genera notificaciones de presión.
número enterozIndex
 Las superposiciones con un valor de zIndex más alto se dibujarán sobre las capas y superposiciones de mosaicos de valores zIndex más bajos.
IDDatos del usuario
 Datos de superposición.

Documentación de las funciones de los miembros

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D) position

Es un constructor de conveniencia para un marcador predeterminado.

+ (UIImage *) markerImageWithColor: (IUColor * anulable) color

Crea una versión matizada de la imagen predeterminada del marcador para usarla como ícono.


Documentación de la propiedad

- (CLLocationCoordinate2D) position [read, write, assign]

Posición del marcador.

Animado.

- (NSString*) snippet [read, write, copy]

Texto del fragmento, que se muestra debajo del título en la ventana de información cuando se selecciona.

- (UIImage*) ícono [read, write, assign]

Ícono de marcador para renderizar.

Si se muestra un valor nulo, se usa un marcador de lugar predeterminado del SDK.

Admite imágenes animadas, pero cada fotograma debe tener el mismo tamaño o el comportamiento es indefinido.

Se admite el uso de AlignmentRectInsets para especificar un área de presión reducida. Esto también redefine la forma en que se especifican las anclas. Para una imagen animada, se utiliza el valor de la animación, no los fotogramas individuales.

- (UIView*) iconView [read, write, assign]

Vista de marcador para renderizar.

Si se deja "nil", recurre a la propiedad icon en su lugar.

Admite la animación de todas las propiedades de UIView que se pueden animar, excepto frame y center. No se admite el cambio de estas propiedades ni de su versión de CALayer correspondiente, incluida position.

Ten en cuenta que la vista se comporta como si clipsToBounds estuviera configurado en YES, independientemente de su valor real.

- (BOOL) tracksViewChanges [read, write, assign]

Controla si se debe volver a dibujar el ícono de este marcador en cada fotograma.

Ten en cuenta que cuando cambia de NO a SÍ, se garantiza que el ícono se volverá a dibujar en el siguiente fotograma.

La configuración predeterminada es YES. No tiene efecto si iconView es nulo.

- (BOOL) tracksInfoWindowChanges [read, write, assign]

Controla si se debe volver a dibujar la ventana de información de este marcador en cada fotograma.

Ten en cuenta que, cuando cambia de NO a SÍ, se garantiza que la ventana de información se vuelva a dibujar en el siguiente fotograma.

La configuración predeterminada es NO.

- (CGPoint) groundAnchor [read, write, assign]

El anclaje de suelo especifica el punto en la imagen del ícono que está anclado a la posición del marcador en la superficie terrestre.

Este punto se especifica dentro del 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.

Si la imagen tiene AlignmentRectInsets distinto de cero, las partes superior izquierda e inferior derecha mencionadas anteriormente hacen referencia a la sección de inserción de la imagen.

- (CGPoint) infoWindowAnchor [read, write, assign]

El anclaje de la ventana de información especifica el punto de la imagen del icono en el que se debe anclar la ventana de información, el cual se mostrará justo arriba de este punto.

Este punto se especifica dentro del mismo espacio quegroundAnchor.

- (GMSMarkerAnimation) AppearanceAnimation [read, write, assign]

Controla la animación utilizada cuando se coloca este marcador en una GMSMapView (el valor predeterminado es kGMSMarkerAnimationNone, sin animación).

- (BOOL) arrastrable [read, write, assign]

Controla si se puede arrastrar este marcador de forma interactiva (NO predeterminado).

- (BOOL) plana [read, write, assign]

Controla si este marcador debe mostrarse plano respecto de la superficie terrestre (SÍ) o una valla publicitaria frente a la cámara (NO, predeterminado).

- (CLLocationDegrees) rotation [read, write, assign]

Establece la rotación del marcador en grados en el sentido de las manecillas del reloj sobre su punto de anclaje.

El eje de rotación es perpendicular al marcador. Una rotación con valor 0 corresponde a la posición predeterminada del marcador. Animado.

Si se utiliza un marcador plano en el mapa, la posición predeterminada se alinea respecto del norte y la rotación hace que siempre permanezca plano en el mapa. Si se trata de una valla publicitaria, la posición predeterminada es hacia arriba y la rotación hace que siempre apunte hacia la cámara.

- (flotante) opacidad [read, write, assign]

Establece la opacidad del marcador, entre 0 (completamente transparente) y 1 (predeterminado), inclusive.

- (GMSMarkerLayer*) capa [read, assign]

Proporciona la capa Core Animation para este GMSMarker.

- (GMSPanoramaView*) panoramaView [read, write, assign]

panoramaView especifica qué vista panorámica intentará mostrar este marcador.

Ten en cuenta que el objeto position del marcador se encuentra demasiado lejos de la ubicación actual de la panorámica del panoramaView, ya que no se mostrará porque será demasiado pequeño.

Se puede establecer en nulo para eliminar el marcador de cualquier vista panorámica actual a la que esté conectado.

Se puede mostrar un marcador en una panorámica y en un mapa al mismo tiempo.

- (NSString*) title [read, write, copy, inherited]

Es el título, una descripción breve de la superposición.

En algunas superposiciones, como los marcadores, se muestra el título en el mapa. El título también es el texto de accesibilidad predeterminado.

- (GMSMapView*) mapa [read, write, assign, inherited]

El mapa en el que se encuentra esta superposición

Si estableces esta propiedad, se agregará la superposición al mapa. Si se establece en nulo, se quitará esta superposición del mapa. Una superposición puede estar activa como máximo en un mapa por vez.

- (BOOL) presionable [read, write, assign, inherited]

Si esta superposición genera notificaciones de presión.

De forma predeterminada, algunas superposiciones, como los marcadores, se pueden presionar.

- (int) zIndex [read, write, assign, inherited]

Las superposiciones con un valor de zIndex más alto se dibujarán sobre las capas y superposiciones de mosaicos de valores zIndex más bajos.

Los mismos valores dan como resultado un orden de dibujo indefinido. Los marcadores son una excepción de que, independientemente del valor de zIndex, siempre se dibujarán encima de las capas de mosaicos y otras superposiciones que no sean marcadores. De hecho, se considera que pertenecen a un grupo de índice z separado en comparación con otras superposiciones.

- (id) userData [read, write, assign, inherited]

Datos de superposición.

Puedes usar esta propiedad para asociar un objeto arbitrario con esta superposición. El SDK de Google Maps para iOS no lee ni escribe esta propiedad.

Ten en cuenta que userData no debe contener ninguna referencia fuerte a ningún objeto de Maps. De lo contrario, se puede crear un ciclo de retención (que evita que se liberen objetos).