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. | |
| 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 à 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 l'option "Ma position" est activée, indique où le point de position de l'appareil est tracé. | |
| GMSMarker * | selectedMarker |
| Repère sélectionné. | |
| BOOL | trafficEnabled |
| Détermine si la carte doit afficher des données sur le trafic, le cas échéant. | |
| GMSMapViewType | mapType |
| Permet de contrôler le type de tuiles de carte à afficher. | |
| GMSMapStyle * | mapStyle |
| 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) | |
| BOOL | buildingsEnabled |
| Si cette option est définie, les bâtiments 3D s'affichent lorsqu'ils sont disponibles. | |
| BOOL | indoorEnabled |
| Définit si les plans d'intérieur sont affichés lorsqu'ils sont disponibles. | |
| 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 d'interface utilisateur pour la carte. | |
| UIEdgeInsets | Marge intérieure |
| Contrôle la zone "visible" de la vue. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Permet de contrôler la façon 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 |
| Permet de contrôler la fréquence d'images du rendu. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| 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. | |
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 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.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType). | featureType |
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:.
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é
- (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.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
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.