Documentation de référence sur 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. Il s'agit du 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 [[GMSMapView alloc] initWithFrame:] par défaut (où l'appareil photo est défini sur un emplacement par défaut).

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 de membre public

(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.
(vide)startRendering
 Demande à cette carte d'activer son moteur de rendu.
(vide)stopRendering
 Demande à la carte d'éteindre son moteur de rendu.
(vide)- clair
 Efface tout le balisage qui a été ajouté à la carte, y compris les repères, les polylignes et les superpositions au sol.
(vide)- setMinZoom:maxZoom:
 Définit minZoom et maxZoom.
(GMSCameraPosition pouvant avoir une valeur nulle *)- cameraForBounds:insets:
 Créez une GMSCameraPosition qui présente bounds avec padding.
(vide)- moveCamera:
 Modifie l'appareil photo en fonction de update.
(BOOL)- areEqualForRenderingPosition:position:
 Vérifiez si les positions données de l'appareil photo peuvent entraîner le même rendu, 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é.
(vide)- animateToCameraPosition:
 Anime la caméra de cette carte sur cameraPosition.
(vide)- animateToLocation :
 As animateToCameraPosition:, mais modifie uniquement la position de l'appareil photo (par exemple, de l'emplacement actuel à location).
(vide)- animateToZoom:
 As animateToCameraPosition:, mais modifie uniquement le niveau de zoom de la caméra.
(vide)- animateToBearing:
 As animateToCameraPosition:, mais modifie uniquement l'orientation de la caméra (en degrés).
(vide)- animateToViewingAngle :
 As animateToCameraPosition:, mais modifie uniquement l'angle de vue de la caméra (en degrés).
(vide)- 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 de commodité 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é
 délégué GMSMapView.
GMSCameraPositioncaméra
 Contrôle 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 * maPosition
 Si la fonctionnalité "Ma position" est activée, affiche l'emplacement du point de localisation de l'appareil.
GMSMarkerselectedMarker
 Repère sélectionné.
BOOLtrafficEnabled
 Détermine si la carte dessine des données sur le trafic, le cas échéant.
GMSMapViewType.mapType
 Contrôle le type de tuiles de carte à afficher.
GMSMapStylemapStyle
 Permet de contrôler le style de la carte.
nombre décimalZoom minimal
 Zoom minimal (le niveau de zoom arrière le plus élevé peut être le plus élevé de la caméra).
nombre décimalmaxZoom
 Zoom maximal (la caméra doit être la plus proche de la Terre).
BOOLbuildingsEnabled
 Si cette option est définie, les bâtiments en 3D s'affichent lorsqu'ils sont disponibles.
BOOLindoorEnabled
 Détermine 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 à l'intérieur.
GMSUISettingsparamètres
 Récupère l'objet GMSUISettings, qui contrôle les paramètres de l'interface utilisateur pour la carte.
UIEdgeInsetsMarge intérieure
 Contrôle la zone "visible" de la vue.
GMSMapViewPaddingAdjustmentBehaviorpaddingAjustementBehavior
 Contrôle la façon dont les encarts de la zone de sûreté sont ajoutés aux valeurs de marge intérieure.
BOOLAccessibleElementsHidden
 La valeur par défaut est "YES".
GMSMapLayercalque
 Accesseur du type CALayer personnalisé utilisé pour le calque.
GMSFrameRatepréféréFrameRate
 Permet de contrôler la fréquence d'images de l'affichage.
GMSCoordinateBoundscameraTargetBounds
 Si la valeur n'est pas "nil", force la cible de la caméra de sorte qu'elle ne quitte pas les limites spécifiées par des gestes.
GMSMapCapabilityFlagsmapFonctionnalités
 Toutes les fonctionnalités disponibles sous conditions (en fonction de leur ID de carte ou d'autres paramètres de carte) disponibles à un moment précis.

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 les fonctions de membre

+ (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*.) ID de carte
caméra: (GMSCameraPosition *). caméra

Outil d'initialisation de commodité 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.

- (instancetype) initWithFrame: (CGRect). cadre
mapID: (GMSMapID*.) ID de carte
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.

- (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 à la 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 géographique visible et ne réinitialisera pas le mapType actuel.

- (void) setMinZoom: (nombre à virgule flottante) Zoom minimal
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 au maximum. Dans le cas contraire, elle génère une exception intitulée NSRangeException.

- (Possibilité de valeur nulle pour GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds *). limites
encarts: (UIEdgeInsets) encarts

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

La caméra présente une orientation et une inclinaison nulles (c'est-à-dire qu'elle fait face au nord et qu'elle regarde directement la Terre). Le cadre et la marge intérieure de ce GMSMapView sont alors pris en compte.

Si les limites ne sont pas valides, cette méthode renvoie un appareil photo nul.

- (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 données de l'appareil photo peuvent entraîner le même rendu, 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 couches de fonctionnalités doivent être configurées dans la console Cloud.

Si aucun calque du type spécifié n'existe 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 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 *). Positionde la caméra

Anime la caméra de cette carte sur cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D) position

As animateToCameraPosition:, mais modifie uniquement la position de l'appareil photo (par exemple, de l'emplacement actuel à location).

- (void) animateToZoom: (nombre à virgule flottante) 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) animateToViewingAngle: (double) angledevue

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 à une orientation orientée vers le bas) et à entre 30 et 45 degrés vers l'horizon, en fonction de la proximité relative de la terre.

- (void) animateWithCameraUpdate: (GMSCameraUpdate*.) Mise à jour de la caméra

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 sur la propriété

- (IBOutlet id<GMSMapViewDelegate>) délégué [read, write, assign]

délégué GMSMapView.

- (GMSCameraPosition*) caméra [read, write, copy]

Contrôle 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 l'image suivante, lorsque la caméra a été explicitement définie 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, affiche l'emplacement du point de localisation de l'appareil.

Si elle est désactivée ou qu'elle est activée, mais qu'aucune donnée de localisation n'est disponible, la valeur est "nul". 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 cette propriété est définie 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 dessine des données sur le trafic, le cas échéant.

Cette condition 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 défini sur 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 doit être la plus proche 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 en 3D s'affichent lorsqu'ils sont disponibles.

La valeur par défaut est "YES".

Cela peut être utile lors de l'ajout d'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 vignettes seront brièvement invalidées.

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

Détermine 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 à l'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.

- Marge intérieure (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. Celle-ci contiendra 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 en conséquence. La marge intérieure affecte également la propriété projection. Ainsi, la zone visible n'inclut pas la marge intérieure. GMSCameraUpdate fitToBounds garantit que cette marge intérieure et celle qui est demandée seront prises en compte.

Cette propriété peut être animée dans un bloc d'animation basé sur UIView.

Contrôle la façon dont les encarts de la zone de sûreté sont ajoutés aux valeurs de marge intérieure.

Tout comme la marge intérieure, la zone de sûreté insère des commandes de position sur la carte, comme 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 kGMSMapViewPaddingAdjustmentBehaviorAlways.

- (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*) layer [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 de l'affichage.

La valeur par défaut est kGMSFrameRateMaximum.

- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]

Si la valeur n'est pas "nil", force la cible de la caméra de sorte qu'elle ne quitte pas les limites spécifiées par des gestes.

Toutes les fonctionnalités disponibles sous conditions (en fonction de leur ID de carte ou d'autres paramètres de carte) disponibles à un moment précis.

N'inclut pas de fonctionnalités toujours disponibles.