Documentation de référence sur la classe GMSMapView

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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:]. Vous pouvez également la créer avec la méthode [[GMSMapView alloc] initWithFrame:] par défaut (dans laquelle l'appareil photo sera défini à un emplacement par défaut).

GMSMapView ne peut être lu et modifié qu'à partir du 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 indéfini.

Fonctions publiques des membres

(type d'instance)- initWithFrame:camera:
 Crée et renvoie une vue plan, avec un cadre et une cible de caméra.
(type d'instance)- initWithFrame:mapID:camera:
 Crée et renvoie une vue plan avec un cadre, un ID de carte et une cible de caméra.
(void)- startRendering
 Demande à cette carte d'alimenter son moteur de rendu.
(void)- stopRendering
 Demande à cette carte d'éteindre son moteur de rendu.
(void)- clair
 Efface toutes les balises ajoutées à la carte, y compris les repères, les polylignes et les superpositions au sol.
(void)- setMinZoom:maxZoom:
 Définit minZoom et maxZoom.
(valeur GMSCameraPosition pouvant être nulle *)- cameraForBounds:insets:
 Créez une GMSCameraPosition qui présente bounds avec padding.
(void)- moveCamera :
 Modifie la caméra en fonction de update.
(BOOL)- areEqualForRenderingPosition:position:
 Vérifiez si les positions de l'appareil photo sont en cause ou non, en tenant compte du niveau de précision et de transformation utilisé en interne.
(void)- animateToCameraPosition:
 Anime la caméra de cette carte dans cameraPosition.
(void)- animateToLocation:
 animateToCameraPosition, mais ne modifie que la position de la caméra (c'est-à-dire, la position actuelle, remplacée par location).
(void)- animateToZoom :
 animateToCameraPosition, mais ne modifie que le niveau de zoom de la caméra.
(void)- animateToBearing :
 Comme animateToCameraPosition, mais ne modifie que l'orientation de la caméra (en degrés).
(void)- animateToVisualizeAngle:
 Comme 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 conformément à la propriété animateToCameraPosition.

Fonctions de membre publiques statiques

(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 pratique pour créer et renvoyer une vue plan avec un cadre, un ID de carte et une cible de caméra.

Propriétés

ID IBOutlet < GMSMapViewDelegate >délégué
 Délégué GMSMapView.
GMSCameraPosition*caméra
 Permet de contrôler la caméra, qui définit l'orientation de la carte.
GMSProjection*projection
 Renvoie un objet GMSProjection que vous pouvez utiliser pour convertir des coordonnées d'é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, elle indique où l'utilisateur est en train de dessiner.
GMSMarker*selectedMarker
 Repère sélectionné.
BOOLtrafficEnabled
 Détermine si la carte extrait les données de trafic, le cas échéant.
GMSMapViewTypemapType
 Contrôle le type de tuiles de carte à afficher.
GMSMapStyle*mapStyle.
 Permet de contrôler le style de la carte.
Nombre décimalminZoom
 Zoom minimal (le plus éloigné possible de la caméra)
Nombre décimalmaxZoom
 Zoom maximal (le plus proche possible de la caméra par rapport à la Terre)
BOOLbuildingsEnabled.
 Si cette option est définie, les bâtiments 3D sont affichés lorsqu'ils sont disponibles.
BOOLIndoorEnabled
 Indique si les plans d'intérieur sont affichés, le cas échéant.
GMSIndoorDisplay*IndoorDisplay
 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.
UIEdgeInsetsremplissage
 Contrôle la zone "visible" de la vue.
GMSMapViewPaddingAdjustmentBehaviorpaddingAdjustBehavior.
 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".
GMSMapLayerCalque
 Accesseur du type CALayer personnalisé utilisé pour le calque.
GMSFrameRatepreferredFrameRate
 Contrôle la fréquence d'images du 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 la faire quitter les limites spécifiées.

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

NSString *constkGMSAccessibilityMyLocation
 Identifiant d'accessibilité du bouton "Ma position".

Documentation sur la fonction de membre

+ (instancetype) mapWithFrame: (GRGR) cadre
caméra: (GMSCameraPosition *) caméra

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

+ (instancetype) mapWithFrame: (GRGR) cadre
mapID: (GMSMapID *) ID de carte
caméra: (GMSCameraPosition *) caméra

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

- (instancetype) initWithFrame: (GRGR) cadre
caméra: (GMSCameraPosition*) caméra

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

- (instancetype) initWithFrame: (GRGR) cadre
mapID: (GMSMapID *) ID de carte
caméra: (GMSCameraPosition*) caméra

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

- (void) startRendering

Demande à cette carte d'alimenter son moteur de rendu.

Cette option est facultative et idempotente.

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

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

Cette option est facultative et idempotente.

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

Efface toutes les balises ajoutées à la carte, y compris les repères, les polylignes et les superpositions au sol.

Cette opération n'efface pas le point géographique visible et ne réinitialise pas le type de carte actuel.

- (void) setMinZoom: (nombre à virgule flottante) minZoom
maxZoom: (nombre à virgule flottante) maxZoom

Définit minZoom et maxZoom.

Cette méthode s'attend à ce que la valeur minimale soit inférieure ou égale à la valeur maximale, et renverra une exception avec le nom NSRangeException.

- (null GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds*) limites
encadrés: (UIEdgeInsets) encarts

Créez une GMSCameraPosition qui présente bounds avec padding.

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

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

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

Modifie la caméra en fonction de update.

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

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

Vérifiez si les positions de l'appareil photo sont en cause ou non, en tenant compte du niveau de précision et de transformation utilisé en interne.

- (void) animateToCameraPosition: (GMSCameraPosition*) cameraPosition

Anime la caméra de cette carte dans cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D) position

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

- (void) animateToZoom: (nombre à virgule flottante) zoom

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

Comme animateToCameraPosition, mais ne modifie que l'orientation de la caméra (en degrés).

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

- (void) animateToViewingAngle: (double) viewingAngle

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

Cette valeur sera limitée à un minimum de 0 (c'est-à-dire vers le bas), et entre 30 et 45 degrés vers l'horizon, selon la proximité avec la Terre.

- (void) animateWithCameraUpdate: (GMSCameraUpdate *) cameraUpdate.

Applique cameraUpdate à la caméra actuelle, puis utilise le résultat conformément à la propriété animateToCameraPosition.


- (NSString* const) kGMSAccessibilityMyLocation [related]

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


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 des coordonnées d'écran en coordonnées de latitude/longitude.

Il s'agit d'un instantané de la projection en cours, qui ne sera pas automatiquement mis à jour lorsque la caméra se déplace. Elle représente soit la projection du dernier cadre GMSMapView tracé, soit le cadre à venir, 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, elle indique où l'utilisateur est en train de dessiner.

Si ce paramètre est désactivé ou s'il est activé, mais qu'aucune donnée de localisation n'est disponible, la valeur est nulle. Cette propriété est observable à l'aide de KVO.

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

Repère sélectionné.

Lorsque vous définissez cette propriété, vous sélectionnez un repère spécifique qui affiche une fenêtre d'informations. Si cette propriété n'est pas nulle, le fait de la définir sur nil désélectionne le repère et masque la fenêtre d'informations. Cette propriété est observable à l'aide de KVO.

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

Détermine si la carte extrait les données de trafic, le cas échéant.

en fonction 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 style de carte autre que "nil" ne s'applique que si "mapType" est normal.

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

Zoom minimal (le plus éloigné possible de la caméra)

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

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

Zoom maximal (le plus proche possible de la caméra par rapport à la Terre)

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

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

Si cette option est définie, les bâtiments 3D sont affichés lorsqu'ils sont disponibles.

La valeur par défaut est "YES".

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

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

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

La valeur par défaut est "YES".

Si cette règle est définie sur "NO", les caches des données d'intérieur peuvent être supprimés définitivement et tous les étages actuellement sélectionnés par l'utilisateur final seront 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*) settings [read, assign]

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

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

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

En appliquant une marge intérieure, vous pouvez créer une zone située en périphérie de la vue. Celle-ci contient des données cartographiques, mais pas de commandes d'interface utilisateur.

Si la marge intérieure n'est pas équilibrée, le centre visuel de la vue se déplace comme prévu. Le remplissage affectera également la propriété projection. Ainsi, la région visible n'inclura pas la zone de remplissage. La fonction GMSCameraUpdate pour FitToBounds garantira la prise en compte de cette marge intérieure et de 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.

À l'instar des marges intérieures, les zones de sécurité permettent de contrôler la position de la carte, comme la boussole, le bouton Ma position et le sélecteur d'étage.

La valeur par défaut est kGMSMapViewPaddingAdjustBehavior.

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

La valeur par défaut est "YES".

Si la valeur est NON, GMSMapView génère des éléments d'accessibilité pour les objets en superposition, tels que GMSMarker et GMSPolyline.

Cette propriété est conforme au protocole UIAcessible informel, à l'exception de la valeur par défaut "YES".

- (GMSMapLayer*) layer [read, retain]

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

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

Contrôle la fréquence d'images du 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 la faire quitter les limites spécifiées.