Documentation de référence de la classe GMSMapView

Documentation de référence de la classe GMSMapView

Présentation

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

La carte doit être instanciée via l'un des constructeurs -init ou -initWithOptions:.

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înera une exception ou un comportement non défini.

Fonctions de membre public

(type d'instance)- init
 Initialisation avec CGRectZero et les options par défaut.
(type d'instance)- initWithOptions:
 Crée une vue plan avec les options fournies.
(type d'instance)- initWithFrame:
(type d'instance)- initWithCoder :
(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 de carte avec un cadre, un ID de carte et une cible de caméra.
(void) startRendering
 Demande à cette carte d'activer son moteur de rendu.
(void) stopRendering
 Demande à cette carte d'éteindre son moteur de rendu.
(void) - Effacer
 Efface tout le balisage qui a été ajouté à la carte, y compris les repères, les polylignes et les superpositions au sol.
(void) - setMinZoom:maxZoom:
 Définit minZoom et maxZoom.
(nullable GMSCameraPosition *) 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 données de la caméra entraînent dans la pratique le même rendu de la caméra, en tenant compte du niveau de précision et des transformations utilisés en interne.
(GMSFeatureLayer
< GMSPlaceFeature * > *)
featureLayerOfFeatureType:
 Renvoie un calque d'éléments géographiques du type spécifié.
(void) - animateToCameraPosition:
 Anime la caméra de cette carte en cameraPosition.
(void) - animateToLocation :
 As animateToCameraPosition:, mais ne modifie que la position de la caméra (par exemple, en passant de l'emplacement actuel à location).
(void) - animateToZoom:
 As animateToCameraPosition:, mais modifie uniquement 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) - animateToviewAngle :
 As animateToCameraPosition:, mais modifie uniquement l'angle de vue de la caméra (en degrés).
(void) - animateWithCameraUpdate:
 Applique cameraUpdate à l'appareil photo actuel, puis utilise le résultat conformément à animateToCameraPosition:.

Fonctions de membre public 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:
 Outil d'initialisation pratique pour créer et renvoyer une vue de carte avec un cadre, un ID de carte et une cible de caméra

Propriétés

ID IBOutlet< GMSMapViewDelegate >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 des coordonnées à l'écran en coordonnées de latitude/longitude.
BOOLmyLocationEnabled
 Détermine si le point "Ma position" et le cercle de précision sont activés.
CLLocation * myLocation
 Si l'option "Ma position" est activée, indique où le point de position de l'appareil est tracé.
GMSMarkerselectedMarker
 Repère sélectionné.
BOOLtrafficEnabled
 Détermine si la carte doit afficher des données sur le trafic, le cas échéant.
GMSMapViewTypemapType
 Permet de contrôler le type de tuiles de carte à afficher.
GMSMapStylemapStyle
 Permet de contrôler le style de la carte.
float minZoom
 Zoom minimal (le niveau de zoom arrière le plus élevé peut être le plus élevé de la caméra).
float maxZoom
 Zoom maximal (la caméra la plus proche peut se trouver par rapport à la Terre)
BOOLbuildingsEnabled
 Si cette option est définie, les bâtiments 3D s'affichent lorsqu'ils sont disponibles.
BOOLindoorEnabled
 Définit si les plans d'intérieur sont affichés lorsqu'ils sont disponibles.
GMSIndoorDisplayindoorDisplay
 Récupère l'instance GMSIndoorDisplay qui permet d'observer ou de contrôler certains aspects de l'affichage des données en intérieur.
GMSUISettingsparamètres
 Récupère l'objet GMSUISettings, qui contrôle les paramètres d'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".
GMSMapLayercalque
 Accesseur du type CALayer personnalisé utilisé pour le calque.
GMSFrameRatepreferredFrameRate
 Permet de contrôler la fréquence d'images du rendu.
GMSCoordinateBoundscameraTargetBounds
 Si la valeur n'est pas "nil", contraigne la cible de la caméra de sorte que les gestes ne l'entraînent pas à quitter les limites spécifiées.
GMSMapCapabilityFlags ;mapCapabilities
 Toutes les fonctionnalités disponibles sous conditions (en fonction de l'ID de carte ou d'autres paramètres de carte) disponibles à l'heure actuelle.

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

NSString *constkGMSAccessibilityCompass
 Identifiant d'accessibilité du bouton de la boussole.
NSString *constkGMSAccessibilityMyLocation
 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

- (type d'instance) init

Initialisation avec CGRectZero et les options par défaut.

- (instancetype) initWithOptions: (valeur non nulle GMSMapViewOptions *) options

Crée une vue plan avec les options fournies.

La valeur de l'objet options est copiée par cette méthode.

- (instancetype) initWithFrame: (CGRect) cadre
- (instancetype) initWithCoder: (NSCoder *) encodeur
+ (instancetype) mapWithFrame: (CGRect) cadre
caméra: (GMSCameraPosition *). caméra

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

+ (instancetype) mapWithFrame: (CGRect) cadre
mapID: (GMSMapID *). mapID
caméra: (GMSCameraPosition *). caméra

Outil d'initialisation pratique pour créer et renvoyer une vue de carte avec un cadre, un ID de carte et une cible de caméra

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

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

Remarque :
Cette fonctionnalité est obsolète. Utilisez -init ou -initWithOptions: à la place.
- (instancetype) initWithFrame: (CGRect) cadre
mapID: (GMSMapID *). mapID
caméra: (GMSCameraPosition *). caméra

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

Remarque :
Cette fonctionnalité est obsolète. Utilisez -init ou -initWithOptions: à la place.
- (void) startRendering

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

Cette étape est facultative et idempotente.

Remarque :
Cette fonctionnalité 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 étape est facultative et idempotente.

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

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

Cela n'effacera pas le point de position visible et ne réinitialisera pas le mapType actuel.

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

Définit minZoom et maxZoom.

Cette méthode s'attend à ce que la valeur minimale soit inférieure ou égale à la valeur maximale. Dans le cas contraire, elle génère une exception intitulée NSRangeException.

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

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

La caméra présente une direction et une inclinaison nulles (elle doit donc faire face au nord et regarder directement 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 un appareil photo nul.

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

Modifie la caméra en fonction de update.

Le changement de mode est instantané (sans animation).

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

Vérifiez si les positions données de la caméra entraînent dans la pratique le même rendu de la caméra, en tenant compte du niveau de précision et des transformations utilisés en interne.

Renvoie un calque d'éléments géographiques du type spécifié.

Les calques de caractéristiques doivent être configurés dans la console Cloud.

Si un calque du type spécifié n'existe pas sur cette carte, si le style basé sur les données n'est pas activé ou si le framework de rendu Metal n'est pas utilisé, le paramètre isAvailable du calque généré est NO et ne répond à aucun appel.

Nécessite le moteur de rendu Metal. Découvrez comment activer Metal : https://developers.google.com/maps/documentation/ios-sdk/config#use-metal.

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

Anime la caméra de cette carte en cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D)  position

As animateToCameraPosition:, mais ne modifie que la position de la caméra (par exemple, en passant de l'emplacement actuel à location).

- (void) animateToZoom: (float)  zoomer

As animateToCameraPosition:, mais modifie uniquement 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) animateToviewAngle: (double) viewingAngle

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

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

- (void) animateWithCameraUpdate: (GMSCameraUpdate *) cameraUpdate

Applique cameraUpdate à l'appareil photo actuel, puis utilise le résultat conformément à animateToCameraPosition:.


- (NSString* const) kGMSAccessibilityCompass [related]

Identifiant d'accessibilité du bouton de la 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 de la propriété

- (IBOutlet id<GMSMapViewDelegate>) délégué [read, write, assign]
- (GMSCameraPosition*) caméra [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 à l'écran en coordonnées de latitude/longitude.

Il s'agit d'un instantané de la projection en cours, qui n'est pas automatiquement mis à jour lorsque la caméra bouge. Elle représente soit la projection du dernier frame GMSMapView dessiné, soit la prochaine image (où la caméra a été définie explicitement ou la carte qui vient d'être créée). Il ne sera jamais nul.

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

Détermine si le point "Ma position" et le cercle de précision sont activés.

La valeur par défaut est "NO".

- (CLLocation*) myLocation [read, assign]

Si l'option "Ma position" est activée, indique où le point de position de l'appareil est tracé.

S'il est désactivé ou s'il est activé, mais qu'aucune donnée de localisation n'est disponible, la valeur est "null". Cette propriété est observable à l'aide de KVO.

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

Repère sélectionné.

Définir cette propriété permet de sélectionner un repère spécifique et d'afficher une fenêtre d'informations sur celui-ci. Si la valeur de cette propriété n'est pas "nil", et si vous la définissez sur "nil", le repère est désélectionné et la fenêtre d'informations est masquée. Cette propriété est observable à l'aide de KVO.

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

Détermine si la carte doit afficher des données sur le trafic, le cas échéant.

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

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

Permet de contrôler 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 minimal (le niveau de zoom arrière le plus élevé peut être le plus élevé de la caméra).

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

- (float) maxZoom [read, assign]

Zoom maximal (la caméra la plus proche peut se trouver 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 s'affichent 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 la rendre plus nette aux niveaux de zoom élevés. Si vous modifiez cette valeur, toutes les vignettes seront brièvement invalidées.

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

Définit si les plans d'intérieur sont affichés lorsqu'ils sont disponibles.

La valeur par défaut est "YES".

Si cette règle est définie sur "NO", les caches des données intérieures peuvent être supprimés définitivement et tout étage actuellement sélectionné par l'utilisateur final peut être réinitialisé.

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Récupère l'instance GMSIndoorDisplay qui permet d'observer ou de contrôler certains 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 d'interface utilisateur pour la carte.

- Marge intérieure (UIEdgeInsets) [read, write, assign]

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

En appliquant une marge extérieure, il est possible de créer une zone autour du bord de la vue. Celle-ci contiendra les données de la carte, mais pas les commandes d'interface utilisateur.

Si la marge intérieure n'est pas équilibrée, le centre visuel de la vue se déplace en conséquence. La marge intérieure affectera également la propriété projection. La zone de marge intérieure n'est donc pas visible dans la zone visible. GMSCameraUpdatefitToBounds garantit que cette marge intérieure et toute marge intérieure demandée seront prises en compte.

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, la zone sûre insère les commandes de position de la carte, telles que la boussole, le bouton "Ma position" et le sélecteur d'étage, dans la zone de sécurité de l'appareil.

La valeur par défaut est kGMSMapViewPaddingAjustementBehaviorAlways.

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

La valeur par défaut est "YES".

Si ce paramètre est défini sur "NO", GMSMapView génère des éléments d'accessibilité pour les objets superposés, tels que GMSMarker et GMSPolyline.

Cette propriété suit le protocole informel UIAccessibility, à l'exception de la valeur par défaut "YES".

- (GMSMapLayer*) calque [read, retain]

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

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

Permet de contrôler 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 "nil", contraigne la cible de la caméra de sorte que les gestes ne l'entraînent pas à quitter les limites spécifiées.

– (GMSMapCapabilityFlags) mapCapabilities [read, assign]

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

N'inclut pas de fonctionnalités toujours disponibles.