Documentation de référence sur la classe GMSMapView


Présentation

Il s'agit de la classe principale du SDK Google Maps pour iOS. Elle constitue le point d'entrée de toutes les méthodes liées à la carte.

La carte doit être instanciée via le constructeur de commodité [GMSMapView mapWithFrame:camera:]. Elle peut également être créée avec la méthode initWithFrame [[GMSMapView par défaut] (où l'appareil photo sera défini sur une position par défaut).

GMSMapView ne peut être lu et modifié que depuis le thread principal, comme tous les objets UIKit. L'appel de ces méthodes à partir d'un autre thread entraîne une exception ou un comportement non défini.

Fonctions publiques

(type d'instance)- initWithFrame:camera:
 Crée et affiche une vue plan, avec un cadre et une cible de caméra.
(type d'instance)- initWithFrame:mapID:camera:
 Crée et affiche une vue plan avec un frame, un ID de carte et une cible de caméra.
(void)- startRendering
 Indique à cette carte d'allumer son moteur de rendu.
(void)- stopRendering
 Indique à cette carte d'éteindre son moteur de rendu.
(void)- clair
 Efface tout le balisage ajouté à la carte, y compris les repères, les polylignes et les superpositions au sol.
(void)- setMinZoom:maxZoom :
 Définit minZoom et maxZoom.
(possibilité de valeur nulle pour GMSCameraPosition *)- cameraForBounds:insets:
 Créez une GMSCameraPosition présentant bounds avec padding.
(void)- moveCamera :
 Modifie l'appareil photo en fonction de update.
(BOOL)- areEqualForRenderingPosition:position:
 Vérifiez si les positions de la caméra en question sont pratiquement identiques, en tenant compte du niveau de précision et des transformations utilisés en interne.
(void)- animateToCameraPosition:
 Anime l'appareil photo de cette carte dans cameraPosition.
(void)- animateToLocation:
 En tant qu'animateToCameraPosition, mais modifie uniquement la position de la caméra (c'est-à-dire, la position actuelle de location)
(void)- animateToZoom:
 As animateToCameraPosition:, mais ne modifie que le niveau de zoom de la caméra.
(void)- animateToBearing:
 As animateToCameraPosition:, mais modifie uniquement l'orientation de la caméra (en degrés).
(void)- animateToShowingAngle:
 As animateToCameraPosition:, mais ne modifie que l'angle de vue de la caméra (en degrés).
(void)- animateWithCameraUpdate:
 Applique cameraUpdate à la caméra actuelle, puis utilise le résultat selon animateToCameraPosition.

Fonctions publiques de membre statique

(type d'instance)+ mapWithFrame:camera:
 Crée et renvoie une vue plan avec un cadre et une cible de caméra.
(type d'instance)+ mapWithFrame:mapID:camera:
 Initialisation de base pour créer et renvoyer une vue plan avec un frame, un ID de carte et une cible de caméra.

Propriétés

IBOutlet ID : GMSMapViewDelegate >délégué
 Délégué GMSMapView.
GMSCameraPositioncaméra
 Permet de contrôler la caméra, qui définit l'orientation de la carte.
GMSProjectionprojection
 Renvoie un objet GMSProjection que vous pouvez utiliser pour convertir les coordonnées de l'écran en coordonnées de latitude/longitude.
BOOLmyLocationEnabled
 Détermine si le point Ma position et le cercle Précision sont activés.
CLLocation * maPosition
 Si la fonctionnalité "Ma position" est activée, la position du point de la position de l'appareil est affichée.
GMSMarkersélectionné
 Repère sélectionné.
BOOLtrafficEnabled
 Détermine si la carte génère des données de trafic, si elles sont disponibles.
GMSMapViewTypemapType
 Contrôle le type de tuiles de carte à afficher.
GMSMapStylemapStyle
 Permet de contrôler le style de la carte.
Nombre décimalminZoom
 Zoom minimum (plus le zoom arrière n'est possible).
Nombre décimalmaxZoom
 Zoom maximal (l'appareil photo peut être le plus proche de la Terre)
BOOLbuildingsEnabled
 S'il est défini, les bâtiments 3D s'afficheront là où ils sont disponibles.
BOOLindoorEnabled
 Détermine si les plans d'intérieur sont affichés, le cas échéant.
GMSIndoorDisplayIndoorDisplay
 Récupère l'instance GMSIndoorDisplay qui permet d'observer ou de contrôler les aspects de l'affichage des données en intérieur.
GMSUISettingsparamètres
 Récupère l'objet GMSUISettings, qui contrôle les paramètres de l'interface utilisateur pour la carte.
UIEdgeInsetsmarge intérieure
 Contrôle la zone "visible" de la vue.
GMSMapViewPaddingAdjustmentBehaviorpaddingAdjustmentBehavior
 Permet de contrôler la façon dont les encarts de la zone sûre sont ajoutés aux valeurs de marge intérieure.
BOOLaccessibilityElementsHidden
 La valeur par défaut est "YES".
GMSMapLayercouche
 Accesseur du type CALayer personnalisé utilisé pour le calque.
GMSFrameRatepreferredFrameRate
 Contrôle la fréquence d'images de rendu.
GMSCoordinateBoundscameraTargetBounds
 Si la valeur n'est pas nulle, la cible de la caméra est limitée afin que les gestes ne puissent pas quitter les limites spécifiées.
GMSMapCapabilityFlagsmapCapabilities
 Toutes les fonctionnalités disponibles sous conditions (en fonction de l'ID de carte ou d'autres paramètres de carte) actuellement disponibles.

(Notez qu'il ne s'agit pas de fonctions membres.)

NSString *constkGMSAccessibilityCompass
 Identifiant d'accessibilité du bouton Boussole.
NSString *constkGMSAccessibilityMyLocation (Emplacement d'accessibilité de kGMS)
 Identifiant d'accessibilité du bouton "ma position".
NSString *constkGMSAccessibilityOutOfQuota
 Identifiant d'accessibilité pour le libellé d'erreur "Hors quota".

Documentation sur la fonction de membre

+ (instancetype) mapWithFrame: (GRIT). cadre
appareil photo: (GMSCameraPosition *) caméra

Crée et renvoie une vue plan avec un cadre et une cible de caméra.

+ (instancetype) mapWithFrame: (GRIT). cadre
mapID: (GMSMapID *) mapID (ID de carte)
appareil photo: (GMSCameraPosition *) caméra

Initialisation de base pour créer et renvoyer une vue plan avec un frame, un ID de carte et une cible de caméra.

- (type d'instance) initWithFrame: (GRIT). cadre
appareil photo: (GMSCameraPosition *) caméra

Crée et affiche une vue plan, avec un cadre et une cible de caméra.

- (type d'instance) initWithFrame: (GRIT). cadre
mapID: (GMSMapID *) mapID (ID de carte)
appareil photo: (GMSCameraPosition *) caméra

Crée et affiche une vue plan avec un frame, un ID de carte et une cible de caméra.

- (void) startRendering

Indique à cette carte d'allumer son moteur de rendu.

Cette option est facultative et idempotente.

Remarque :
Obsolète. Cette méthode est obsolète et sera supprimée dans une prochaine version.
- (void) stopRendering

Indique à cette carte d'éteindre son moteur de rendu.

Cette option est facultative et idempotente.

Remarque :
Obsolète. Cette méthode est obsolète et sera supprimée dans une prochaine version.
- (vide) clair

Efface tout le balisage ajouté à la carte, y compris les repères, les polylignes et les superpositions au sol.

Le point géographique visible ne sera pas effacé ni le type de carte actuel sera réinitialisé.

- (void) setMinZoom: (float) minZoom
maxZoom: (float) maxZoom

Définit minZoom et maxZoom.

Avec cette méthode, le minimum doit être inférieur ou égal au maximum et génère une exception avec le nom NSRangeException.

- (nullable GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds *) limites
encarts: (UIEdgeInsets) encarts

Créez une GMSCameraPosition présentant bounds avec padding.

La caméra sera orientée et inclinée vers le nord et orientée directement vers la Terre. Cela tient compte du cadre et de la marge intérieure de ce GMSMapView.

Si les limites ne sont pas valides, cette méthode renvoie une caméra nulle.

- (void) moveCamera : (GMSCameraUpdate *) mettre à jour

Modifie l'appareil photo en fonction de update.

Le changement de caméra est instantané (sans animation).

- (BOOL) areEqualForRenderingPosition: (GMSCameraPosition *) position
position: (GMSCameraPosition *) otherPosition

Vérifiez si les positions de la caméra en question sont pratiquement identiques, en tenant compte du niveau de précision et des transformations utilisés en interne.

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition.

Anime l'appareil photo de cette carte dans cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D) position

Comme animateToCameraPosition, mais ne modifie que la position de la caméra (c'est-à-dire, la position actuelle de location).

- (void) animateToZoom: (float) zoom

As animateToCameraPosition:, mais ne modifie que le niveau de zoom de la caméra.

Cette valeur est limitée par [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirection) bearing

As animateToCameraPosition:, mais modifie uniquement l'orientation de la caméra (en degrés).

La valeur zéro indique le nord géographique.

- (void) animateToShowingAngle: (double) viewingAngle.

As animateToCameraPosition:, mais ne modifie que l'angle de vue de la caméra (en degrés).

Cette valeur sera limitée à zéro au minimum (c'est-à-dire directement vers le bas) et comprise entre 30 et 45 degrés vers l'horizon, en fonction de la proximité relative par rapport à la terre.

- (void) animateWithCameraUpdate: (GMSCameraUpdate *) appareil photo

Applique cameraUpdate à la caméra actuelle, puis utilise le résultat selon animateToCameraPosition.


- (NSString* const) kGMSAccessibilityCompass [related]

Identifiant d'accessibilité du bouton Boussole.

- (NSString* const) kGMSAccessibilityMyLocation [related]

Identifiant d'accessibilité du bouton "ma position".

- (NSString* const) kGMSAccessibilityOutOfQuota [related]

Identifiant d'accessibilité pour le libellé d'erreur "Hors quota".


Documentation sur la propriété

- (ID IBOutlet<GMSMapViewDelegate>) délégué [read, write, assign]

Délégué GMSMapView.

- (GMSCameraPosition*) camera [read, write, copy]

Permet de contrôler la caméra, qui définit l'orientation de la carte.

La modification de cette propriété est instantanée.

- (GMSProjection*) projection [read, assign]

Renvoie un objet GMSProjection que vous pouvez utiliser pour convertir les coordonnées de l'écran en coordonnées de latitude/longitude.

Il s'agit d'un instantané de la projection actuelle qui n'est pas automatiquement mis à jour lorsque la caméra bouge. Cela représente soit la projection du dernier cadre GMSMapView dessiné, soit l'image qui suit à l'endroit où l'appareil photo a été explicitement défini ou la carte que vous venez de créer. Il ne sera jamais nul.

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

Détermine si le point Ma position et le cercle Précision sont activés.

La valeur par défaut est "NO".

- (CLLocation*) myLocation [read, assign]

Si la fonctionnalité "Ma position" est activée, la position du point de la position de l'appareil est affichée.

Si elle est désactivée ou qu'elle est activée, mais qu'aucune donnée de localisation n'est disponible, cette valeur est nulle. Cette propriété est observable à l'aide de KVO.

- (GMSMarker*) selectMarker [read, write, assign]

Repère sélectionné.

Définir cette propriété sélectionne un repère particulier, affichant une fenêtre d'informations. Si cette propriété est nulle, le fait de la définir sur nil désélectionne le repère, en masquant la fenêtre d'informations. Cette propriété est observable à l'aide de KVO.

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

Détermine si la carte génère des données de trafic, si elles sont disponibles.

Cela dépend de la disponibilité des données sur le trafic. La valeur par défaut est "NO".

- (GMSMapViewType) mapType [read, write, assign]

Contrôle le type de tuiles de carte à afficher.

La valeur par défaut est kGMSTypeNormal.

- (GMSMapStyle*) mapStyle [read, write, assign]

Permet de contrôler le style de la carte.

Un mapStyle non nul ne s'applique que si mapType est Normal.

- (float) minZoom [read, assign]

Zoom minimum (plus le zoom arrière n'est possible).

La valeur par défaut est kGMSMinZoomLevel. Modifié avec -setMinZoom:maxZoom:.

- (nombre à virgule flottante) maxZoom [read, assign]

Zoom maximal (l'appareil photo peut être le plus proche de la Terre)

La valeur par défaut est kGMSMaxZoomLevel. Modifié avec -setMinZoom:maxZoom:.

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

S'il est défini, les bâtiments 3D s'afficheront là où ils sont disponibles.

La valeur par défaut est "YES".

Cela peut s'avérer utile lorsque vous ajoutez un calque de tuiles personnalisé à la carte afin de le rendre plus clair à des niveaux de zoom élevés. Si vous modifiez cette valeur, toutes les tuiles seront brièvement invalidées.

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

Détermine si les plans d'intérieur sont affichés, le cas échéant.

La valeur par défaut est "YES".

Si ce paramètre est défini sur "NO", les caches des données intérieures peuvent être supprimés définitivement et tous les étages sélectionnés par l'utilisateur final peuvent être réinitialisés.

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Récupère l'instance GMSIndoorDisplay qui permet d'observer ou de contrôler les aspects de l'affichage des données en intérieur.

- (GMSUISettings*) paramètres [read, assign]

Récupère l'objet GMSUISettings, qui contrôle les paramètres de l'interface utilisateur pour la carte.

- Remplissage (UIEdgeInsets) [read, write, assign]

Contrôle la zone "visible" de la vue.

En appliquant une marge intérieure, vous pouvez créer une zone autour du bord de la vue. Elle contient les données de la carte, mais pas les commandes de l'interface utilisateur.

Si la marge intérieure n'est pas équilibrée, le centre visuel de la vue se déplace comme prévu. La marge intérieure affecte également la propriété projection. La zone visible n'inclut donc pas la zone de marge intérieure. La fonction GMSCameraUpdate fitToBounds prend en compte cette marge intérieure et toute marge intérieure demandée.

Cette propriété peut être animée dans un bloc d'animation basé sur UIView.

Permet de contrôler la façon dont les encarts de la zone sûre sont ajoutés aux valeurs de marge intérieure.

Tout comme la marge intérieure, les encarts de la zone de sûreté permettent de positionner la carte, comme la boussole, le bouton Ma position et le sélecteur d'étage dans la zone sûre de l'appareil.

La valeur par défaut est kGMSMapViewPaddingAdjustmentBehaviorBehavior.

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

La valeur par défaut est "YES".

Si elle est définie sur "NO", GMSMapView génère des éléments d'accessibilité pour les objets de superposition tels que GMSMarker et GMSPolyline.

Cette propriété suit le protocole UIAccessibility, sauf la valeur par défaut "YES".

- (GMSMapLayer*) calque [read, retain]

Accesseur du type CALayer personnalisé utilisé pour le calque.

- (GMSFrameRate) preferredFrameRate [read, write, assign]

Contrôle la fréquence d'images de rendu.

La valeur par défaut est kGMSFrameRateMaximum.

- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]

Si la valeur n'est pas nulle, la cible de la caméra est limitée afin que les gestes ne puissent pas quitter les limites spécifiées.

- (mapMapFlags) mapCapabilities [read, assign]

Toutes les fonctionnalités disponibles sous conditions (en fonction de l'ID de carte ou d'autres paramètres de carte) actuellement disponibles.

N'inclut pas les fonctionnalités toujours disponibles.