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:]. Elle peut également être créée avec la méthode initWithFrame [[GMSMapView par défaut] (où l'appareil photo sera défini sur une position par défaut).
GMSMapView ne peut être lu et modifié que depuis le 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 non défini.
Fonctions publiques | |
(type d'instance) | - initWithFrame:camera: |
Crée et affiche une vue plan, avec un cadre et une cible de caméra. | |
(type d'instance) | - initWithFrame:mapID:camera: |
Crée et affiche une vue plan avec un frame, un ID de carte et une cible de caméra. | |
(void) | - startRendering |
Indique à cette carte d'allumer son moteur de rendu. | |
(void) | - stopRendering |
Indique à cette carte d'éteindre son moteur de rendu. | |
(void) | - clair |
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 . | |
(possibilité de valeur nulle pour GMSCameraPosition *) | - cameraForBounds:insets: |
Créez une GMSCameraPosition présentant bounds avec padding . | |
(void) | - moveCamera : |
Modifie l'appareil photo en fonction de update . | |
(BOOL) | - areEqualForRenderingPosition:position: |
Vérifiez si les positions de la caméra en question sont pratiquement identiques, en tenant compte du niveau de précision et des transformations utilisés en interne. | |
(void) | - animateToCameraPosition: |
Anime l'appareil photo de cette carte dans cameraPosition . | |
(void) | - animateToLocation: |
En tant qu'animateToCameraPosition, mais modifie uniquement la position de la caméra (c'est-à-dire, la position actuelle de location ) | |
(void) | - animateToZoom: |
As animateToCameraPosition:, mais ne modifie que 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) | - animateToShowingAngle: |
As 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 selon animateToCameraPosition. | |
Fonctions publiques de membre 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: |
Initialisation de base pour créer et renvoyer une vue plan 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 * | 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 les coordonnées de l'é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, la position du point de la position de l'appareil est affichée. | |
GMSMarker * | sélectionné |
Repère sélectionné. | |
BOOL | trafficEnabled |
Détermine si la carte génère des données de trafic, si elles sont disponibles. | |
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 minimum (plus le zoom arrière n'est possible). | |
Nombre décimal | maxZoom |
Zoom maximal (l'appareil photo peut être le plus proche de la Terre) | |
BOOL | buildingsEnabled |
S'il est défini, les bâtiments 3D s'afficheront là où 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 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 | 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 * | couche |
Accesseur du type CALayer personnalisé utilisé pour le calque. | |
GMSFrameRate | preferredFrameRate |
Contrôle la fréquence d'images de 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 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) actuellement disponibles. | |
Fonctions associées | |
(Notez qu'il ne s'agit pas de fonctions membres.) | |
NSString *const | kGMSAccessibilityCompass |
Identifiant d'accessibilité du bouton Boussole. | |
NSString *const | kGMSAccessibilityMyLocation (Emplacement d'accessibilité de kGMS) |
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
+ (instancetype) mapWithFrame: | (GRIT). | cadre | |
appareil photo: | (GMSCameraPosition *) | caméra | |
Crée et renvoie une vue plan avec un cadre et une cible de caméra.
+ (instancetype) mapWithFrame: | (GRIT). | cadre | |
mapID: | (GMSMapID *) | mapID (ID de carte) | |
appareil photo: | (GMSCameraPosition *) | caméra | |
Initialisation de base pour créer et renvoyer une vue plan avec un frame, un ID de carte et une cible de caméra.
- (type d'instance) initWithFrame: | (GRIT). | cadre | |
appareil photo: | (GMSCameraPosition *) | caméra | |
Crée et affiche une vue plan, avec un cadre et une cible de caméra.
- (type d'instance) initWithFrame: | (GRIT). | cadre | |
mapID: | (GMSMapID *) | mapID (ID de carte) | |
appareil photo: | (GMSCameraPosition *) | caméra | |
Crée et affiche une vue plan avec un frame, un ID de carte et une cible de caméra.
- (void) startRendering |
Indique à cette carte d'allumer son moteur de rendu.
Cette option est facultative et idempotente.
- Remarque :
- Obsolète. Cette méthode est obsolète et sera supprimée dans une prochaine version.
- (void) stopRendering |
Indique à cette carte d'éteindre son moteur de rendu.
Cette option est facultative et idempotente.
- Remarque :
- Obsolète. Cette méthode est obsolète et sera supprimée dans une prochaine version.
- (vide) clair |
Efface tout le balisage ajouté à la carte, y compris les repères, les polylignes et les superpositions au sol.
Le point géographique visible ne sera pas effacé ni le type de carte actuel sera réinitialisé.
- (void) setMinZoom: | (float) | minZoom | |
maxZoom: | (float) | maxZoom | |
Définit minZoom
et maxZoom
.
Avec cette méthode, le minimum doit être inférieur ou égal au maximum et génère une exception avec le nom NSRangeException.
- (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | limites | |
encarts: | (UIEdgeInsets) | encarts | |
Créez une GMSCameraPosition présentant bounds
avec padding
.
La caméra sera orientée et inclinée vers le nord et orientée directement vers 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 une caméra nulle.
- (void) moveCamera : | (GMSCameraUpdate *) | mettre à jour |
Modifie l'appareil photo en fonction de update
.
Le changement de caméra est instantané (sans animation).
- (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | position | |
position: | (GMSCameraPosition *) | otherPosition | |
Vérifiez si les positions de la caméra en question sont pratiquement identiques, en tenant compte du niveau de précision et des transformations utilisés en interne.
- (void) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition. |
Anime l'appareil photo de cette carte dans cameraPosition
.
- (void) animateToLocation: | (CLLocationCoordinate2D) | position |
Comme animateToCameraPosition, mais ne modifie que la position de la caméra (c'est-à-dire, la position actuelle de location
).
- (void) animateToZoom: | (float) | zoom |
As 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 |
As animateToCameraPosition:, mais modifie uniquement l'orientation de la caméra (en degrés).
La valeur zéro indique le nord géographique.
- (void) animateToShowingAngle: | (double) | viewingAngle. |
As animateToCameraPosition:, mais ne modifie que l'angle de vue de la caméra (en degrés).
Cette valeur sera limitée à zéro au minimum (c'est-à-dire directement vers le bas) et comprise entre 30 et 45 degrés vers l'horizon, en fonction de la proximité relative par rapport à la terre.
- (void) animateWithCameraUpdate: | (GMSCameraUpdate *) | appareil photo |
Applique cameraUpdate
à la caméra actuelle, 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 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 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 les coordonnées de l'écran en coordonnées de latitude/longitude.
Il s'agit d'un instantané de la projection actuelle qui n'est pas automatiquement mis à jour lorsque la caméra bouge. Cela représente soit la projection du dernier cadre GMSMapView dessiné, soit l'image qui suit à l'endroit 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, la position du point de la position de l'appareil est affichée.
Si elle est désactivée ou qu'elle est activée, mais qu'aucune donnée de localisation n'est disponible, cette valeur est nulle. Cette propriété est observable à l'aide de KVO.
- (GMSMarker*) selectMarker [read, write, assign] |
Repère sélectionné.
Définir cette propriété sélectionne un repère particulier, affichant une fenêtre d'informations. Si cette propriété est nulle, le fait de la définir sur nil désélectionne le repère, en masquant la fenêtre d'informations. Cette propriété est observable à l'aide de KVO.
- (BOOL) trafficEnabled [read, write, assign] |
Détermine si la carte génère des données de trafic, si elles sont disponibles.
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] |
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 minimum (plus le zoom arrière n'est possible).
La valeur par défaut est kGMSMinZoomLevel. Modifié avec -setMinZoom:maxZoom:.
- (nombre à virgule flottante) maxZoom [read, assign] |
Zoom maximal (l'appareil photo peut être le plus proche de la Terre)
La valeur par défaut est kGMSMaxZoomLevel. Modifié avec -setMinZoom:maxZoom:.
- (BOOL) buildingsEnabled [read, write, assign] |
S'il est défini, les bâtiments 3D s'afficheront là où ils sont disponibles.
La valeur par défaut est "YES".
Cela peut s'avérer utile lorsque vous ajoutez un calque de tuiles personnalisé à la carte afin de le rendre plus clair à des niveaux de zoom élevés. Si vous modifiez cette valeur, toutes les tuiles 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 ce paramètre est défini sur "NO", les caches des données intérieures peuvent être supprimés définitivement et tous les étages sélectionnés par l'utilisateur final peuvent être 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*) paramètres [read, assign] |
Récupère l'objet GMSUISettings, qui contrôle les paramètres de l'interface utilisateur pour la carte.
- Remplissage (UIEdgeInsets) [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. Elle contient les données de la carte, mais pas les commandes de l'interface utilisateur.
Si la marge intérieure n'est pas équilibrée, le centre visuel de la vue se déplace comme prévu. La marge intérieure affecte également la propriété projection
. La zone visible n'inclut donc pas la zone de marge intérieure. La fonction GMSCameraUpdate fitToBounds prend en compte cette marge intérieure et 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.
Tout comme la marge intérieure, les encarts de la zone de sûreté permettent de positionner la carte, comme la boussole, le bouton Ma position et le sélecteur d'étage dans la zone sûre de l'appareil.
La valeur par défaut est kGMSMapViewPaddingAdjustmentBehaviorBehavior.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
La valeur par défaut est "YES".
Si elle est définie sur "NO", GMSMapView génère des éléments d'accessibilité pour les objets de superposition tels que GMSMarker et GMSPolyline.
Cette propriété suit le protocole UIAccessibility, sauf 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 de 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 quitter les limites spécifiées.
- (mapMapFlags) mapCapabilities [read, assign] |
Toutes les fonctionnalités disponibles sous conditions (en fonction de l'ID de carte ou d'autres paramètres de carte) actuellement disponibles.
N'inclut pas les fonctionnalités toujours disponibles.