Référence de la classe GMSMarker

Référence de la classe GMSMarker

Présentation

Un repère est une icône placée à un point précis de la surface de la carte.

L'icône d'un repère est orientée par rapport à l'écran de l'appareil et non par rapport à la surface de la carte. Autrement dit, elle ne changera pas nécessairement d'orientation en cas de rotation, d'inclinaison ou de zoom sur la carte.

Hérite de GMSOverlay.

Hérité par GMSAdvancedMarker.

Fonctions de membre public statique

(type d'instance)+ markerWithPosition: :
 Constructeur pratique pour un repère par défaut.
(UIImage *)+ MarkerImageWithColor:
 Crée une version teintée de l'image du repère par défaut à utiliser comme icône.

Propriétés

CLLocationCoordinate2Dposition
 Position du repère.
NSString * extrait
 Texte de l'extrait, affiché sous le titre dans la fenêtre d'informations lorsque cette option est sélectionnée.
UIImage * icône
 Icône de repère à afficher
UIView * iconView
 Vue Repère à afficher.
BOOLtracksViewChanges
 Détermine si l'icône de ce repère doit être redessinée à chaque image.
BOOLtracksInfoWindowChanges
 Détermine si la fenêtre d'informations de ce repère doit être redessinée à chaque image.
CGPointgroundAnchor
 L'ancre au sol indique le point de l'icône qui est ancré à la position du repère sur la surface de la Terre.
CGPointinfoWindowAnchor
 L'ancre de la fenêtre d'informations spécifie le point de l'icône à partir duquel ancrer la fenêtre d'informations, qui s'affichera directement au-dessus de ce point.
GMSMarkerAnimationappearAnimation
 Contrôle l'animation utilisée lorsque ce repère est placé sur un GMSMapView (kGMSMarkerAnimationNone par défaut, aucune animation).
BOOLdéplaçable
 Détermine si ce repère peut être déplacé de manière interactive (désactivé par défaut).
BOOLplat
 Détermine si ce repère doit être plat contre la surface de la Terre (OUI) ou un panneau d'affichage faisant face à la caméra (NON, par défaut).
CLLocationDegreesrotation
 Définit la rotation du repère en degrés dans le sens des aiguilles d'une montre autour du point d'ancrage du repère.
float opacité
 Définit l'opacité du repère, entre 0 (complètement transparent) et 1 (par défaut) inclus.
GMSMarkerLayercalque
 Fournit la couche d'animation principale pour ce GMSMarker.
GMSPanoramaViewpanoramaView
 panoramaView spécifie la vue panoramique qui tentera d'afficher ce repère.
NSString * title
 Titre : brève description de la superposition.
GMSMapViewcarte
 Carte sur laquelle se trouve cette superposition.
BOOLtappable
 Si cette superposition doit entraîner l'affichage de notifications sur l'écran,
int zIndex
 Des superpositions de valeur zIndex plus élevée seront dessinées au-dessus des calques de tuiles et des superpositions de valeur zIndex inférieures.
iduserData
 Superposer des données.

Documentation sur la fonction de membre

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D)  position

Constructeur pratique pour un repère par défaut.

+ (UIImage *) MarkerImageWithColor: (nullable UIColor *)  color

Crée une version teintée de l'image du repère par défaut à utiliser comme icône.


Documentation de la propriété

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

Position du repère.

Animé.

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

Texte de l'extrait, affiché sous le titre dans la fenêtre d'informations lorsque cette option est sélectionnée.

- Icône (UIImage*) [read, write, assign]

Icône de repère à afficher

Si aucune valeur n'est spécifiée, un repère de lieu par défaut est utilisé par le SDK.

Accepte les images animées, mais chaque image doit avoir la même taille, sinon le comportement n'est pas défini.

Compatible avec l'utilisation d'AlignRectInsets pour spécifier une zone cliquable réduite. Cela redéfinit également la manière dont les ancres sont spécifiées. Pour une image animée, la valeur de l'animation est utilisée et non les images individuelles.

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

Vue Repère à afficher.

Si la valeur n'est pas définie, la propriété icon est utilisée à la place.

Prise en charge de l'animation de toutes les propriétés animables de UIView, à l'exception de frame et de center. Il n'est pas possible de modifier ces propriétés ni la version de CALayer correspondante, y compris position.

Notez que l'affichage se comporte comme si clipsToBounds était défini sur "YES", quelle que soit sa valeur réelle.

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

Détermine si l'icône de ce repère doit être redessinée à chaque image.

Notez que lorsque l'état passe de "NO" à "YES", l'icône sera redessinée pour l'image suivante.

La valeur par défaut est "YES". Cette valeur n'a aucun effet si la valeur de iconView est nulle.

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

Détermine si la fenêtre d'informations de ce repère doit être redessinée à chaque image.

Notez que lorsque vous passez de "NO" à "YES", la fenêtre d'informations sera redessinée pour l'image suivante.

La valeur par défaut est "NO".

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

L'ancre au sol indique le point de l'icône qui est ancré à la position du repère sur la surface de la Terre.

Ce point est spécifié dans l'espace continu [0,0, 1,0] x [0,0, 1,0], où (0,0) correspond à l'angle supérieur gauche de l'image et (1,1) à l'angle inférieur droit.

Si l'alignement de l'image est différent de zéro, les encarts en haut à gauche et en bas à droite mentionnés ci-dessus font référence à l'encart de l'image.

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

L'ancre de la fenêtre d'informations spécifie le point de l'icône à partir duquel ancrer la fenêtre d'informations, qui s'affichera directement au-dessus de ce point.

Ce point est spécifié dans le même espace que "groundAnchor".

- (GMSMarkerAnimation) appearAnimation [read, write, assign].

Contrôle l'animation utilisée lorsque ce repère est placé sur un GMSMapView (kGMSMarkerAnimationNone par défaut, aucune animation).

- (BOOL) déplaçable [read, write, assign]

Détermine si ce repère peut être déplacé de manière interactive (désactivé par défaut).

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

Détermine si ce repère doit être plat contre la surface de la Terre (OUI) ou un panneau d'affichage faisant face à la caméra (NON, par défaut).

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

Définit la rotation du repère en degrés dans le sens des aiguilles d'une montre autour du point d'ancrage du repère.

L'axe de rotation est perpendiculaire au repère. Une rotation de 0 correspond à la position par défaut du repère. Animé.

Lorsque le repère est plat sur la carte, la position par défaut est alignée sur le nord et la rotation est définie de sorte que le repère reste toujours à plat sur la carte. Lorsque le repère est un panneau d'affichage, la position par défaut est à la verticale vers le haut, et la rotation est définie de sorte que le repère soit toujours face à la caméra.

- (float) opacité [read, write, assign]

Définit l'opacité du repère, entre 0 (complètement transparent) et 1 (par défaut) inclus.

- (GMSMarkerLayer*) couche [read, assign]

Fournit la couche d'animation principale pour ce GMSMarker.

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

panoramaView spécifie la vue panoramique qui tentera d'afficher ce repère.

Notez que si la position du repère est trop éloignée de la position actuelle du panorama du panoramaView, elle ne s'affichera pas, car elle sera trop petite.

Peut être défini sur "nil" pour supprimer le repère de toute vue panoramique actuelle à laquelle il est associé.

Un repère peut être affiché simultanément sur un panorama et sur une carte.

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

Titre : brève description de la superposition.

Certaines superpositions, telles que les repères, affichent le titre sur la carte. Le titre correspond également au texte d'accessibilité par défaut.

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

Carte sur laquelle se trouve cette superposition.

Définir cette propriété ajoutera la superposition à la carte. Le fait de définir cette valeur sur "nil" supprime cette superposition de la carte. Une superposition peut être active à la fois sur une carte au maximum.

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

Si cette superposition doit entraîner l'affichage de notifications sur l'écran,

Par défaut, vous pouvez appuyer sur certaines superpositions, comme les repères.

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

Des superpositions de valeur zIndex plus élevée seront dessinées au-dessus des calques de tuiles et des superpositions de valeur zIndex inférieures.

Si la valeur est égale, l'ordre de dessin n'est pas défini. Les repères sont une exception : quelle que soit la zIndex, ils seront toujours dessinés au-dessus des calques de tuiles et d'autres superpositions non constituées de repères. Ils sont en effet considérés comme appartenant à un groupe z-index distinct par rapport aux autres superpositions.

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

Superposer des données.

Vous pouvez utiliser cette propriété pour associer un objet arbitraire à cette superposition. Le SDK Google Maps pour iOS ne lit ni n'écrit cette propriété.

Notez que le paramètre userData ne doit contenir aucune référence forte à des objets Maps. Dans le cas contraire, un cycle de conservation pourrait être créé (empêcher la libération des objets).