Présentation
Il s'agit de la classe principale du SDK Google Maps pour iOS et du point d'entrée de toutes les méthodes liées à la carte.
La carte doit être instanciée avec l'un des constructeurs "-init" ou "-initWithOptions:".
GMSMapView ne peut être lu et modifié qu'à partir du thread principal, comme pour 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 des membres publics | |
| (instancetype) | - init |
| Initialisation avec CGRectZero et les options par défaut. | |
| (instancetype) | - initWithOptions: |
| Crée une vue plan avec les options données. | |
| (instancetype) | - initWithFrame: |
| (type d'instance pouvant avoir une valeur nulle) | - initWithCoder: |
| (instancetype) | - initWithFrame:camera: |
| Crée et affiche une vue plan, avec un cadre et une cible de caméra. | |
| (instancetype) | - initWithFrame:mapID:camera: |
| Crée et affiche une vue de carte 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) | - effacer |
| 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. | |
| (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 de caméra données entraîneraient pratiquement le même rendu, en tenant compte du niveau de précision et de transformations utilisés en interne. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
| Renvoie un calque d'éléments géographiques du type spécifié. | |
| (GMSDatasetFeatureLayer *) | - datasetFeatureLayerOfDatasetID: |
| Renvoie un calque d'éléments géographiques de l'ensemble de données spécifié. | |
| (void) | - animateToCameraPosition: |
Anime la caméra de cette carte en cameraPosition. | |
| (void) | - animateToLocation: |
En tant que animateToCameraPosition:, mais modifie uniquement la position de l'appareil photo (par exemple, en remplaçant la position actuelle par location). | |
| (void) | - animateToZoom: |
| En tant que animateToCameraPosition:, mais ne modifie que le niveau de zoom de la caméra. | |
| (void) | - animateToBearing: |
| En tant que animateToCameraPosition : ne modifie que l'orientation de la caméra (en degrés). | |
| (void) | - animateToViewingAngle : |
| En tant que animateToCameraPosition : ne modifie que l'angle de vue de la caméra (en degrés). | |
| (void) | - animateWithCameraUpdate: |
Applique cameraUpdate à l'appareil photo actuel, puis utilise le résultat selon animateToCameraPosition:. | |
Fonctions des membres publics statiques | |
| (instancetype) | + mapWithFrame:camera: |
| Crée et affiche une vue plan avec un cadre et une cible de caméra. | |
| (instancetype) | + mapWithFrame:mapID:camera: |
| initialiseur pratique permettant de créer et de renvoyer une vue de carte 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. | |
| GMSCameraPosition * | 64 Mpx |
| 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 les coordonnées de l'écran en coordonnées de latitude/longitude. | |
| BOOL | myLocationEnabled |
| Détermine si le point Ma position et le cercle de précision sont activés. | |
| CLLocation * | myLocation |
| Si la fonctionnalité "Ma position" est activée, cette option indique où le point de localisation de l'appareil est dessiné. | |
| GMSMarker * | selectedMarker |
| Repère sélectionné. | |
| BOOL | trafficEnabled |
| Détermine si la carte trace des données de trafic, le cas échéant. | |
| GMSMapViewType | mapType |
| Contrôle le type de tuiles de carte à afficher. | |
| GMSMapStyle * | mapStyle |
| Contrôle le style de la carte. | |
| UIUserInterfaceStyle | overrideUserInterfaceStyle |
| Modifiez la carte selon le paramètre UIUserInterfaceStyle souhaité. | |
| float | minZoom |
| Zoom minimal (le niveau de zoom arrière maximal de la caméra) | |
| float | maxZoom |
| Zoom maximal (la plus proche possible de la Terre) | |
| BOOL | buildingsEnabled |
| Si cette option est définie, les bâtiments 3D seront affichés lorsqu'ils sont disponibles. | |
| BOOL | indoorEnabled |
| Détermine 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 certains aspects de l'affichage des données en intérieur. | |
| GMSUISettings * | paramètres |
| Récupère l'objet GMSUISettings, qui contrôle les paramètres de l'interface utilisateur de la carte. | |
| UIEdgeInsets | marge intérieure |
| Contrôle la zone "visible" de la vue. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Permet de contrôler la manière dont les encarts de la zone sûre sont ajoutés aux valeurs de marge intérieure. | |
| BOOL | accessibilityElementsHidden |
| La valeur par défaut est "YES". | |
| GMSMapLayer * | calque |
| Accesseur du type CALayer personnalisé utilisé pour le calque. | |
| GMSFrameRate | preferredFrameRate |
| Contrôle la fréquence d'images du rendu. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| Si la valeur n'est pas nulle, la cible de la caméra est contraint de sorte que des gestes ne puissent pas l'obliger à quitter les limites spécifiées. | |
| GMSMapCapabilityFlags | mapCapabilities |
| Toutes les fonctionnalités disponibles sous conditions (en fonction de mapID ou d'autres paramètres de la carte) disponibles à l'instant T. | |
Fonctions associées | |
Notez qu'il ne s'agit pas de fonctions membres. | |
| NSString *const | kGMSAccessibilityCompass |
| Identifiant d'accessibilité du bouton de la boussole. | |
| NSString *const | kGMSAccessibilityMyLocation |
| Identifiant d'accessibilité du bouton "Ma position". | |
| NSString *const | kGMSAccessibilityOutOfQuota |
| Identifiant d'accessibilité pour le libellé d'erreur "Hors quota". | |
Documentation sur les fonctions membres
| - (instancetype) init |
Initialisation avec CGRectZero et les options par défaut.
| - (instancetype) initWithOptions: | (GMSMapViewOptions* non nul) | options |
Crée une vue plan avec les options données.
Cette méthode copie la valeur de l'objet options.
| - (instancetype) initWithFrame: | (CGRect) | cadre |
| - (type d'instance nullable) initWithCoder: | (NSCoder *) | encodeur |
| + (instancetype) mapWithFrame: | (CGRect) | cadre | |
| caméra: | (GMSCameraPosition *) | caméra | |
Crée et affiche une vue plan avec un cadre et une cible de caméra.
| + (instancetype) mapWithFrame: | (CGRect) | cadre | |
| mapID: | (GMSMapID *) | mapID | |
| caméra: | (GMSCameraPosition *) | caméra | |
initialiseur pratique permettant de créer et de renvoyer une vue de carte avec un frame, un ID de carte et une cible de caméra ;
| - (instancetype) initWithFrame: | (CGRect) | cadre | |
| caméra: | (GMSCameraPosition *) | caméra | |
Crée et affiche une vue plan, avec un cadre et une cible de caméra.
- Remarque :
- Cette fonctionnalité est obsolète. Utilisez plutôt -init ou -initWithOptions:.
| - (instancetype) initWithFrame: | (CGRect) | cadre | |
| mapID: | (GMSMapID *) | mapID | |
| caméra: | (GMSCameraPosition *) | caméra | |
Crée et affiche une vue de carte avec un cadre, un ID de carte et une cible de caméra.
- Remarque :
- Cette fonctionnalité est obsolète. Utilisez plutôt -init ou -initWithOptions:.
| - (void) startRendering |
Demande à cette carte d'alimenter 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) effacer |
Efface tout le balisage ajouté à la carte, y compris les repères, les polylignes et les superpositions au sol.
Cette opération n'efface pas le point visible et ne réinitialise 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 avec le nom NSRangeException.
| - (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | limites | |
| encarts: | (UIEdgeInsets) | encarts | |
Créez une GMSCameraPosition qui présente bounds avec padding.
La caméra aura une direction et une inclinaison nulles (c'est-à-dire orientée vers le nord et orientées vers la Terre). Cela tient compte du cadre et de la marge intérieure de cette GMSMapView.
Si les limites ne sont pas valides, cette méthode renvoie une caméra nulle.
| - (void) moveCamera : | (GMSCameraUpdate *) | mise à 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 caméra données entraîneraient pratiquement le même rendu, en tenant compte du niveau de précision et de transformations utilisés en interne.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
Renvoie un calque d'éléments géographiques du type spécifié.
Les couches de caractéristiques doivent être configurées 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é, l'attribut isAvailable du calque obtenu sera NO et ne répondra à 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.
| - (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
Renvoie un calque d'éléments géographiques de l'ensemble de données spécifié.
Vous devez configurer les ID des ensembles de données dans la console Cloud.
Si aucun ensemble de données correspondant à l'ID spécifié n'existe sur cette carte, ou si le style basé sur les données n'est pas activé, le isAvailable du calque obtenu sera NO et ne répondra à aucun appel.
| - (void) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
Anime la caméra de cette carte en cameraPosition.
| - (void) animateToLocation: | (CLLocationCoordinate2D) | position |
En tant que animateToCameraPosition : ne modifie que la position de l'appareil photo (la position actuelle est alors remplacée par location).
| - (vide) animateToZoom: | (float) | zoomer |
En tant que 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 |
En tant que animateToCameraPosition : 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 |
En tant que animateToCameraPosition : ne modifie que l'angle de vue de la caméra (en degrés).
Cette valeur sera fixée au minimum à zéro (c'est-à-dire orientée vers le bas), et entre 30 et 45 degrés par rapport à l'horizon, en fonction de leur proximité relative par rapport à la terre.
| - (void) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
Applique cameraUpdate à l'appareil photo actuel, puis utilise le résultat selon animateToCameraPosition:.
Documentation sur les amis et les fonctions associées
- (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é
- (ID IBOutlet<GMSMapViewDelegate>) délégué [read, write, assign] |
délégué GMSMapView.
- (GMSCameraPosition*) camera [read, write, copy] |
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. Il n'est pas automatiquement mis à jour lorsque la caméra bouge. Il représente soit la projection de la dernière image GMSMapView dessinée, soit l'image suivante lorsque la caméra a été définie explicitement ou que la carte 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 la fonctionnalité "Ma position" est activée, cette option indique où le point de localisation de l'appareil est dessiné.
S'il 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é.
Cette propriété permet de sélectionner un repère spécifique et d'afficher une fenêtre d'informations sur celui-ci. Si cette propriété n'est pas nulle, le fait de la définir sur "nil" permet de désélectionner le repère et de masquer la fenêtre d'informations. Cette propriété est observable à l'aide de KVO.
- (BOOL) trafficEnabled [read, write, assign] |
Détermine si la carte trace des données de trafic, le cas échéant.
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] |
Contrôle le style de la carte.
Un mapStyle non nul ne s'applique que si mapType est défini sur Normal.
- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
Modifiez la carte selon le paramètre UIUserInterfaceStyle souhaité.
Ce paramètre remplace le comportement d'UIKit par défaut et est défini par défaut sur UIUserInterfaceStyleLight pour assurer la rétrocompatibilité. Ce paramètre a une incidence sur le jeu de couleurs des cartes de type Normal et Relief.
- (float) minZoom [read, assign] |
Zoom minimal (le niveau de zoom arrière maximal de la caméra)
La valeur par défaut est kGMSMinZoomLevel. Modifié avec -setMinZoom:maxZoom:.
– (nombre décimal) maxZoom [read, assign] |
Zoom maximal (la plus proche possible de 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 seront affichés lorsqu'ils sont disponibles.
La valeur par défaut est "YES".
Cela peut être utile lorsque vous ajoutez un calque de tuiles personnalisées à la carte, afin de le rendre plus net 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étermine 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 et n'importe quel é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 de l'interface utilisateur de la carte.
- (UIEdgeInsets) Marge intérieure [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 qui contiendra des données de carte, 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 en conséquence. Le remplissage affecte également la propriété projection, de sorte que la zone visible n'inclut pas la zone de marge intérieure. GMSCameraUpdate fitToBounds s'assure que cette marge intérieure et celle demandée sont prises en compte.
Cette propriété peut être animée dans un bloc d'animation basé sur UIView.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
Permet de contrôler la manière dont les encarts de la zone sûre sont ajoutés aux valeurs de marge intérieure.
Tout comme l'ajout d'une marge extérieure, la zone de sécurité insère des 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 kGMSMapViewPaddingAdjustBehaviorAlways.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
La valeur par défaut est "YES".
Si la valeur est "NO", GMSMapView génère des éléments d'accessibilité pour les objets en superposition, 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] |
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 contraint de sorte que des gestes ne puissent pas l'obliger à quitter les limites spécifiées.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Toutes les fonctionnalités disponibles sous conditions (en fonction de mapID ou d'autres paramètres de la carte) disponibles à l'instant T.
N'inclut pas les fonctionnalités disponibles en permanence.