Descripción general
Un marcador es un ícono ubicado 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 cambiará necesariamente 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. | |
(UIImage *) | + markerImageWithColor: |
Crea una versión con tono de la imagen predeterminada del marcador para usarla como ícono. | |
Propiedades | |
CLLocationCoordinate2D | position |
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. | |
Imagen de la IU * | ícono |
Ícono de marcador que se renderizará. | |
UIView * | iconView |
Vista de marcador para renderizar. | |
BOOL | tracksViewChanges |
Controla si se debe volver a dibujar el ícono de este marcador en cada marco. | |
BOOL | tracksInfoWindowChanges |
Controla si se debe volver a dibujar la ventana de información de este marcador en cada fotograma. | |
CGPoint | groundAnchor |
El anclaje de suelo especifica el punto de la imagen del ícono que está anclado en la posición del marcador en la superficie terrestre. | |
CGPoint | infoWindowAnchor |
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, que se mostrará directamente encima de este punto. | |
GMSMarkerAnimation | appearAnimation |
Controla la animación que se usa cuando se coloca este marcador en un GMSMapView (el predeterminado es kGMSMarkerAnimationNone, sin animación). | |
BOOL | arrastrables |
Controla si se puede arrastrar este marcador de forma interactiva (NO predeterminado). | |
BOOL | plana |
Controla si el marcador debe quedar plano contra la superficie terrestre (SÍ) o una valla publicitaria orientada a la cámara (NO, predeterminado). | |
CLLocationDegrees | rotación |
Fija la rotación del marcador en grados en el sentido de las manecillas del reloj respecto del punto de anclaje del marcador. | |
float | opacidad |
Establece la opacidad del marcador, entre 0 (completamente transparente) y 1 (predeterminado), inclusive. | |
GMSMarkerLayer * | capa |
Proporciona la capa Core Animation para este GMSMarker. | |
GMSPanoramaView * | panoramaView |
panoramaView especifica qué vista panorámica intentará mostrar este marcador. | |
NSString * | title |
Título, una descripción breve de la superposición. | |
GMSMapView * | mapa |
El mapa en el que se encuentra esta superposición | |
BOOL | aprieta |
Si esta superposición genera notificaciones, | |
int | zIndex |
Las superposiciones con valores zIndex más altos se dibujarán sobre las capas y las superposiciones de mosaicos de valores zIndex más bajos. | |
id | userData |
Datos de superposición. |
Documentación de las funciones de los miembros
+ (tipo de instancia) markerWithPosition: | (CLLocationCoordinate2D) | position |
Es un constructor de conveniencia para un marcador predeterminado.
+ (UIImage *) markerImageWithColor: | (nullable UIColor *) | color |
Crea una versión con tono 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*) fragmento [read, write, copy] |
Texto del fragmento, que se muestra debajo del título en la ventana de información cuando se selecciona.
- (UIImage*) icon [read, write, assign] |
Ícono de marcador que se renderizará.
Si se deja "nil", usa un marcador de lugar del SDK predeterminado.
Admite imágenes animadas, pero cada fotograma debe tener el mismo tamaño o el comportamiento no está definido.
Admite el uso de AlignmentRectInsets para especificar un área táctil reducida. Esto también redefine la forma en que se especifican los anclajes. En el caso de una imagen animada, se usa 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 pueden animarse, excepto frame
y center
. No se admite el cambio de estas propiedades o 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 marco.
Ten en cuenta que cuando este cambio 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 ningún 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 esto cambia de NO a SÍ, se garantiza que la ventana de información se volverá a dibujar el próximo fotograma.
La configuración predeterminada es NO.
- (CGPoint) groundAnchor [read, write, assign] |
El anclaje de suelo especifica el punto de la imagen del ícono que está anclado en 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 distintos de cero, la parte superior izquierda y la 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, que se mostrará directamente encima de este punto.
Este punto se especifica dentro del mismo espacio quegroundAnchor.
- (GMSMarkerAnimation) appearAnimation [read, write, assign] |
Controla la animación que se usa cuando se coloca este marcador en un GMSMapView (el 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 el marcador debe quedar plano contra la superficie terrestre (SÍ) o una valla publicitaria orientada a la cámara (NO, predeterminado).
- rotación (CLLocationDegrees) [read, write, assign] |
Fija la rotación del marcador en grados en el sentido de las manecillas del reloj respecto del punto de anclaje del marcador.
El eje de rotación es perpendicular al marcador. Una rotación igual a 0 corresponde a la posición predeterminada del marcador. Animado.
Cuando se utiliza un marcador plano en el mapa, la posición predeterminada se alinea respecto del norte y la rotación hace que siempre se quede plana en el mapa. Cuando el marcador es una valla publicitaria, la posición predeterminada es hacia arriba y la rotación hace que siempre apunte hacia la cámara.
- (float) 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 si el objeto position
del marcador está demasiado lejos de la ubicación panorámica actual del objeto panoramaView
, no se mostrará, ya que será demasiado pequeño.
Se puede establecer en nil 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] |
Título, una descripción breve de la superposición.
Algunas superposiciones, como los marcadores, mostrarán 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 se configura esta propiedad, se agregará la superposición al mapa. Si se establece en nil, se quitará esta superposición del mapa. Las superposiciones pueden estar activas como máximo en un mapa a la vez.
- (BOOL) que se puede presionar [read, write, assign, inherited] |
Si esta superposición genera notificaciones,
De forma predeterminada, algunas superposiciones, como los marcadores, se podrán presionar.
- (int) zIndex [read, write, assign, inherited] |
Las superposiciones con valores zIndex
más altos se dibujarán sobre las capas y las superposiciones de mosaicos de valores zIndex
más bajos.
La igualdad de valores genera un orden de dibujo indefinido. Los marcadores son una excepción que, independientemente de su valor de zIndex
, siempre se dibujarán encima de capas de mosaicos y otras superposiciones que no sean marcadores. 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 (lo que evita que se liberen objetos).