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. | |
BOOL | myLocationEnabled |
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é. | |
BOOL | trafficEnabled |
Détermine si la carte extrait les données de trafic, le cas échéant. | |
GMSMapViewType | mapType |
Contrôle le type de tuiles de carte à afficher. | |
GMSMapStyle* | mapStyle. |
Permet de contrôler le style de la carte. | |
Nombre décimal | minZoom |
Zoom minimal (le plus éloigné possible de la caméra) | |
Nombre décimal | maxZoom |
Zoom maximal (le plus proche possible de la caméra par rapport à la Terre) | |
BOOL | buildingsEnabled. |
Si cette option est définie, les bâtiments 3D sont affichés lorsqu'ils sont disponibles. | |
BOOL | IndoorEnabled |
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. | |
GMSUISettings * | paramètres |
Récupère l'objet GMSUISettings, qui contrôle les paramètres de l'interface utilisateur pour la carte. | |
UIEdgeInsets | remplissage |
Contrôle la zone "visible" de la vue. | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustBehavior. |
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 |
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 limitée afin que les gestes ne puissent pas la faire quitter les limites spécifiées. | |
Fonctions associées | |
Notez qu'il ne s'agit pas de fonctions membres. | |
NSString *const | kGMSAccessibilityMyLocation |
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.
Documentation sur les amis et les fonctions associées
- (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.
- (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.
À 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.