Caméra et vue

Sélectionnez une plate-forme : Android iOS JavaScript

Le SDK Maps pour iOS vous permet de modifier le point de vue de l'utilisateur sur la carte en changeant la caméra de la carte.

Avec le SDK Maps pour iOS, vos utilisateurs peuvent incliner et faire pivoter pour les adapter à une orientation adaptée à leur contexte. À n'importe quel niveau de zoom les utilisateurs peuvent effectuer un panoramique sur la carte ou modifier sa perspective avec une latence très faible.

Les modifications apportées à l'appareil photo n'affectent pas les repères, les polylignes ni les autres éléments graphiques que vous avez Vous pouvez cependant les modifier pour qu'ils correspondent mieux au un nouvel affichage.

Vue de la carte

Le SDK Maps pour iOS utilise Mercator Projection pour représenter la surface du monde (une sphère) sur l'écran de votre appareil (une surface .

Remarque :Une projection de Mercator a une hauteur finie sur le plan longitudinal (nord/sud), mais une largeur infinie sur le plan latitudinal (est/ouest). Cette caractéristique signifie que la carte la vue se répète infiniment à l'est et à l'ouest. Dans les directions nord et sud, le Les images de la carte de base sont coupées à l'aide de la projection de Mercator à environ +/- 85. en degrés pour rendre carrée la carte obtenue, ce qui facilite la logique sélection de tuile.

Position de la caméra

La vue de la carte est modélisée comme une caméra orientée vers le bas sur une surface plane. La position de la caméra (et par conséquent le rendu de la carte) est indiquée par les propriétés suivantes : position cible (latitude/longitude), orientation, inclinaison et zoom.

Cible (zone géographique)

La cible de la caméra correspond à la position du centre de la carte, spécifiée en tant que coordonnées de latitude et longitude.

La latitude peut être comprise entre -85 et 85 degrés, inclus. Les valeurs supérieures ou inférieures à cette fourchette seront limitées à la valeur la plus proche dans cette fourchette. Par exemple, si vous spécifiez une latitude de 100, la valeur sera définie sur 85. La longitude est comprise entre -180 et 180 degrés, inclus. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette (-180, 180). Par exemple, les valeurs 480, 840 et 1200 seront toutes remplacées par 120 degrés.

Orientation

L'orientation de la caméra indique la direction de la boussole, mesurée en degrés depuis le nord géographique et correspondant au bord supérieur de la carte. Si vous tracez une ligne verticale du centre de la carte à son bord supérieur, l'orientation correspond à la direction de la caméra (mesurée en degrés) par rapport au nord géographique.

La valeur d'orientation 0 signifie que le haut de la carte pointe vers le nord géographique. La valeur d'orientation 90 indique que le haut de la carte est orienté plein est (90 degrés sur une boussole). La valeur 180 signifie que le haut de la carte est orienté plein sud.

L'API Google Maps vous permet de modifier l'orientation d'une carte. Par exemple, un conducteur tourne souvent sa carte routière pour l'aligner dans le sens de la route, tandis qu'un randonneur utilisant une carte et une boussole oriente généralement la carte afin qu'une ligne verticale pointe vers le nord.

Inclinaison (angle de vue)

L'inclinaison définit la position de la caméra sur un arc juste au-dessus du point central de la carte, mesurée en degrés à partir du nadir (direction qui pointe juste en dessous de la caméra). La valeur 0 correspond à une caméra orientée à la verticale vers le bas. Une valeur supérieure à 0 correspond à une caméra inclinée vers l'horizon selon le nombre de degrés spécifié. Lorsque vous modifiez l'angle de vue, la carte apparaît en perspective, les éléments cartographiques lointains semblant plus petits, et les plus proches semblant plus grands, comme le montrent les illustrations ci-dessous.

Dans les images ci-dessous, l'angle de vue est de 0 degré. La première image correspond à un plan schématisé ; la position 1 correspond à la position de la caméra et la position 2 à la position actuelle de la carte. La carte qui en résulte est présentée juste en dessous.

Carte affichée avec l'angle de vue par défaut de la caméra

Angle de vue par défaut de la caméra

Sur les images ci-dessous, l'angle de vue est de 45 degrés. Notez que la caméra se déplace à mi-chemin le long d'un arc entre une ligne verticale perpendiculaire (0 degré) et le sol (90 degrés), jusqu'à la position 3. La caméra pointe toujours vers le point central de la carte, mais la zone représentée par la ligne en position 4 est maintenant visible.

Carte affichée avec un angle de vue de 45 degrés

Angle de vue de 45 degrés

Sur cette capture d'écran, la carte est toujours centrée sur le même point que sur la carte d'origine, mais d'autres éléments cartographiques ont été ajoutés en haut de la carte. À mesure que vous augmentez l'angle au-delà de 45 degrés, les éléments cartographiques situés entre la caméra et la position de la carte apparaissent proportionnellement plus grands, tandis que ceux situés au-delà de la position de la carte apparaissent proportionnellement plus petits, ce qui donne un effet tridimensionnel.

Zoom

Le niveau de zoom de la caméra détermine l'échelle de la carte. Plus le niveau de zoom est élevé, plus on peut voir de détails sur la carte ; et inversement, plus le niveau de zoom est faible, plus la partie du monde affichée à l'écran est grande. Au niveau de zoom 0, l'échelle de la carte est telle que le monde entier a une largeur d'environ 256 points.

Augmenter le niveau de zoom de 1 double la largeur du monde à l'écran. Ainsi, à un niveau de zoom de N, la largeur du monde est approximativement 256 * 2^N points. Par exemple, à un niveau de zoom de 2, le monde entier est environ Largeur de 1 024 points.

Le niveau de zoom ne doit pas nécessairement être un nombre entier. La fourchette de niveaux de zoom autorisée par la carte dépend d'un certain nombre de facteurs, comme la cible, le type de carte et la taille de l'écran. Tout nombre en dehors de la fourchette sera converti vers la valeur valide la plus proche, qui peut correspondre au niveau de zoom minimal ou maximal. La liste suivante indique le niveau de détail approximatif que vous pouvez vous attendre à voir à chaque niveau de zoom :

• 1 : Le monde
• 5 : La masse continentale/Le continent
• 10 : La ville
• 15 : Les rues
• 20 : Les bâtiments

Remarque : En raison de la taille de l'écran et de la densité, il se peut que certains appareils ne soient pas compatibles avec les niveaux de zoom les plus bas. Utilisez le minZoom de GMSMapView afin d'obtenir le niveau de zoom minimal possible pour la carte.

Les images suivantes montrent à quoi ressemblent les différents niveaux de zoom :

Carte au niveau de zoom 5

Carte au niveau de zoom 15

Carte au niveau de zoom 20

Définir la position initiale de la caméra

Définissez la position initiale de la caméra à l'aide des GMSCameraPosition qui vous permet de définir la latitude et la longitude de la cible, ainsi que l'orientation, l'inclinaison et le zoom.

Pour définir la position initiale de la caméra, créez un objet GMSMapViewOptions et définissez la propriété camera en GMSCameraPosition. Transmettez ensuite vos options GMSMapView de commodité.

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 16)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:16];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Vous pouvez également créer l'objet GMSMapView à l'aide de l'initialisation par défaut UIView. . Dans ce cas, la caméra se positionne à l'emplacement par défaut et après sa création.

Swift

let options = GMSMapViewOptions()
options.frame = self.view.bounds
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.frame = self.view.bounds;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Modifier la position de la caméra

Vous pouvez modifier la position de la caméra pour définir l'emplacement via un programme. l'orientation, l'inclinaison et le zoom. Bien que GMSMapView propose plusieurs méthodes que vous pour modifier la position de la caméra, utilisez généralement GMSCameraPosition ou GMSCameraUpdate:

• GMSCameraPosition contient les propriétés et les méthodes permettant de changer la position de chaque caméra. : cible, direction, inclinaison et zoom.

• GMSCameraUpdate vous permet de modifier la cible, la direction, l'inclinaison et le zoom. Il contient également pratiques pour prendre en charge le défilement, le zoom avancé, le centrage caméra dans des limites prédéfinies, etc.

Lorsque vous déplacez la caméra, vous pouvez choisir d'ancrer l'appareil photo vers le nouveau ce qui signifie qu'il n'y a pas d'animation, ou animez le mouvement. Par exemple, si lorsque vous animez un changement d'emplacement cible de la caméra, l'animation passe du l'emplacement précédent vers le nouveau.

L'animation effectue une interpolation entre les attributs de caméra actuels et les nouveaux attributs. Vous pouvez contrôler la durée de l'animation avec Core Animation :

Utiliser GMSCameraPosition

Pour changer l'appareil photo avec GMSCameraPosition vous créez un objet ou vous copiez un objet existant, puis vous le définissez GMSMapView. Utilisez l'objet GMSCameraPosition pour ancrer l'appareil photo sur le nouvel emplacement, avec ou sans animation.

Utilisez un objet GMSCameraPosition pour configurer les propriétés de la caméra, telles que latitude, longitude, zoom, orientation et angle de vue. Vous utiliserez ensuite cet objet pour définir la propriété camera de GMSMapView.

Swift

let fancy = GMSCameraPosition(
  latitude: -33,
  longitude: 151,
  zoom: 6,
  bearing: 270,
  viewingAngle: 45
)
mapView.camera = fancy
      

Objective-C

GMSCameraPosition *fancy = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                       longitude:151.2086
                                                            zoom:6
                                                         bearing:30
                                                    viewingAngle:45];
[mapView setCamera:fancy];
      

Omettez toute propriété GMSCameraPosition que vous souhaitez définir sur sa valeur par défaut.

Pour animer ce déplacement, utilisez la méthode animateToCameraPosition: au lieu de en définissant la propriété camera.

Utiliser GMSCameraUpdate

GMSCameraUpdate vous permet de modifier la position de la caméra et de choisir d'utiliser l'option "Aligner sur" ou "Animer sur" ce nouveau poste. L'avantage de GMSCameraUpdate est sa commodité. Vous pouvez utiliser GMSCameraPosition pour effectuer les mêmes tâches que GMSCameraUpdate, mais GMSCameraUpdate fournit des méthodes d'assistance supplémentaires pour faciliter de manipuler l'appareil photo.

Par exemple, pour utiliser GMSCameraPosition afin d'incrémenter le niveau de zoom actuel, vous devez déterminer le niveau de zoom actuel, puis créer Un objet GMSCameraPosition pour lequel vous définissez le zoom sur une valeur supérieure à le zoom actuel.

Vous pouvez également créer un objet GMSCameraUpdate avec la méthode zoomIn:. Ensuite, modifiez l'appareil photo en transmettant l'objet GMSCameraUpdate à GMSMapView animateWithCameraUpdate:.

Swift

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)
      

Objective-C

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];
      

Utilisez la méthode moveCamera: GMSMapView pour ancrer l'appareil photo sur la nouvelle position. à la place.

Dans l'exemple suivant, vous utilisez GMSCameraUpdate pour animer un mouvement de la caméra. pour la centrer sur Vancouver.

Swift

// Center the camera on Vancouver, Canada
let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let vancouverCam = GMSCameraUpdate.setTarget(vancouver)
mapView.animate(with: vancouverCam)
      

Objective-C

// Center the camera on Vancouver, Canada
CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
GMSCameraUpdate *vancouverCam = [GMSCameraUpdate setTarget:vancouver];
[mapView animateWithCameraUpdate:vancouverCam];
      

Construire un objet GMSCameraUpdate

Créez un objet GMSCameraUpdate à l'aide de l'une de ses méthodes.

zoomIn: et zoomOut:

Modifiez le niveau de zoom actuel de 1, 0 tout en conservant toutes les autres propriétés sont identiques.

zoomTo:

Remplace le niveau de zoom par la valeur donnée tout en conservant les autres les mêmes propriétés.

zoomBy:

Augmente (ou diminue, si la valeur est négative) le niveau de zoom par la valeur donnée.

zoomBy:atPoint:

Augmente (ou diminue, si la valeur est négative) niveau de zoom selon la valeur donnée, tout en conservant la valeur du point spécifié à l'écran.

setTarget:

Modifie la latitude et la longitude de la caméra tout en conservant toutes les autres propriétés.

setTarget:zoom:

Modifie la latitude, la longitude et le zoom de la caméra, tandis que en conservant toutes les autres propriétés.

setCamera:

Définit un nouveau GMSCameraPosition.

scrollByX:Y:

Modifie la latitude et la longitude de la caméra afin de déplacer la carte selon le nombre de points spécifié. Une valeur x positive entraîne caméra pour se déplacer vers la droite, de sorte que la carte semble avoir été déplacée vers la à gauche. Une valeur y positive déplace la caméra vers le bas, de sorte que la carte semble avoir bougé vers le haut. Le défilement est effectué par rapport de direction. Par exemple, si la caméra est orientée à 90 degrés, l'est est en haut.

fitBounds:

Transforme l'appareil photo de façon à centrer les limites spécifiées à l'écran à au plus grand niveau de zoom possible. Applique une valeur par défaut une marge intérieure de 64 points.

fitBounds:withPadding:

Transforme la caméra de façon à centrer les limites spécifiées sur la l'écran au niveau de zoom le plus élevé possible. Utilisez cette méthode pour spécifier la même marge intérieure, en points, pour tous les côtés du cadre de délimitation.

fitBounds:withEdgeInsets:

Transforme la caméra de façon à centrer les limites spécifiées sur la l'écran au niveau de zoom le plus élevé possible. Avec UIEdgeInsets, vous spécifiez une marge intérieure de chaque côté du cadre de délimitation indépendamment.

Remarque :Les méthodes fitBounds: prennent en compte à la fois les marge intérieure que vous avez définie sur la carte, ainsi que les marges intérieures spécifiées lorsque vous respectez les limites. Pour Par exemple, si vous spécifiez une marge intérieure de 100 points autour de votre GMSMapView, puis appelle la méthode fitBounds:, les transformations de l'appareil photo comptabilisent les 64 points de marge intérieure par défaut en plus des 100 points de la marge intérieure personnalisée.

Utiliser GMSMapView pour modifier une seule propriété

GMSMapView propose plusieurs méthodes vous permettant de déplacer la caméra sans objet GMSCameraPosition ou GMSCameraUpdate. Avec ces méthodes, comme animateToLocation: ou animateToZoom:, vous pouvez animer la modification d'un à une seule propriété d'appareil photo.

Remarque :Bien que GMSMapView fournisse des méthodes pour modifier une seule propriété, vous utilisez généralement GMSCameraPosition ou GMSCameraUpdate pour déplacer la caméra, y compris lorsque vous souhaitez modifier plusieurs propriétés de la caméra.

Par exemple, utilisez la méthode toViewingAngle: pour animer un changement au niveau de l'appareil photo. avec une inclinaison.

Swift

mapView.animate(toViewingAngle: 45)
      

Objective-C

[mapView animateToViewingAngle:45];
      

Définir une cible (zone géographique)

La localisation détermine le centre de la carte. Les emplacements sont spécifiés par de latitude et de longitude, et représentées par programmation CLLocationCoordinate2D, créé avec CLLocationCoordinate2DMake.

Utilisez GMSCameraPosition pour modifier le lieu. Dans cet exemple, la carte s'aligne au nouvel emplacement.

Swift

let target = CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208)
mapView.camera = GMSCameraPosition(target: target, zoom: 6)
      

Objective-C

CLLocationCoordinate2D target =
    CLLocationCoordinate2DMake(-33.868, 151.208);
mapView.camera = [GMSCameraPosition cameraWithTarget:target zoom:6];
      

Pour animer ce changement et déplacer la carte sur le nouveau lieu, vous pouvez utiliser les animateToCameraPosition: au lieu de définir la propriété camera. Ou Utilisez la méthode animateToLocation: sur GMSMapView.

Swift

mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))
      

Objective-C

[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];
      

Vous pouvez également créer un objet GMSCameraUpdate pour déplacer la caméra. Utilisez son intégrée, scrollByX:Y:, pour spécifier le nombre de points de défilement de la dans les directions X et Y. Dans cet exemple, vous faites défiler la caméra à 200 pointe vers la droite et 100 points vers le bas:

Swift

// Move the camera 200 points to the right, and 100 points downwards
let downwards = GMSCameraUpdate.scrollBy(x: 200, y: 100)
mapView.animate(with: downwards)
      

Objective-C

// Move the camera 200 points to the right, and 100 points downwards
GMSCameraUpdate *downwards = [GMSCameraUpdate scrollByX:200.0 Y:100.0];
[mapView animateWithCameraUpdate:downwards];
      

Définir la direction (orientation)

L'orientation est la direction de la boussole, mesurée en degrés à partir du nord géographique, pour le bord supérieur de la carte. Par exemple, une orientation de 90 degrés permet d'afficher dont l'arête supérieure est orientée vers l'est.

Définir la direction par programmation avec GMSCameraPosition ou GMSCameraUpdate ou avec la méthode animateToBearing: de GMSMapView.

Swift

mapView.animate(toBearing: 0)
      

Objective-C

[mapView animateToBearing:0];
      

Définir l'inclinaison (angle de vue)

L'angle de vue correspond à la position de la caméra sur un arc situé directement au-dessus de la position centrale de la carte et la surface de la Terre, mesurées en degrés nadir (direction directement sous la caméra). Lorsque vous modifiez l'angle de vue, la carte apparaît en perspective, avec des éléments géographiques situés entre la caméra et la position de la carte ; qui apparaissent proportionnellement plus grands, et des éléments géographiques situés au-delà de la position de la carte apparaissent proportionnellement plus petits, ce qui donne un effet tridimensionnel.

L'angle de vue peut être compris entre 0 (pointant directement vers le bas sur la carte) et jusqu'à une valeur maximale dépendante du niveau de zoom. Pour un niveau de zoom 16 ou supérieur, l'angle est de 65 degrés. À un niveau de zoom 10 ou inférieur, l'angle maximal est de 30 degrés.

Définissez l'angle de vue par programmation à l'aide de GMSCameraPosition ou GMSCameraUpdate ou avec la méthode animateToViewingAngle: de GMSMapView.

Swift

mapView.animate(toViewingAngle: 45)
      

Objective-C

[mapView animateToViewingAngle:45];
      

Définir le zoom

Le niveau de zoom de la caméra détermine l'échelle de la carte. Avec un zoom plus grand plus de détails à l'écran, tandis qu'aux niveaux de zoom plus faibles, peut voir plus de parties du monde.

Définissez le zoom par programmation avec GMSCameraPosition ou GMSCameraUpdate, ou avec la méthode animateToZoom: de GMSMapView.

Swift

mapView.animate(toZoom: 12)
      

Objective-C

[mapView animateToZoom:12];
      

L'exemple suivant utilise la méthode zoomIn: pour construire un GMSCameraUpdate. pour animer un zoom avant d'un niveau par rapport au niveau actuel.

Swift

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)
      

Objective-C

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];
      

Définir des limites

Pour déplacer la caméra de sorte que toute une zone d'intérêt soit visible au point le plus élevé niveau de zoom possible, définissez des limites pour la vue de la caméra. Par exemple, si vous souhaite afficher toutes les stations-service dans un rayon de cinq kilomètres position, déplacez la caméra de sorte qu'elles soient toutes visibles à l'écran:

1. Calculer la GMSCoordinateBounds que vous souhaitez être visibles à l'écran.
2. Utilisez la méthode cameraForBounds:insets: de GMSMapView pour renvoyer un GMSCameraPosition

Définir ces limites permet de s'assurer que l'élément GMSCoordinateBounds donné s'adapte entièrement dans la taille de la carte actuelle. Notez que cette méthode définit l'inclinaison et l'orientation de la carte sur 0.

L'exemple suivant montre comment modifier la caméra afin que les villes de Vancouver et de Calgary apparaissent toutes les deux dans la même vue.

Swift

let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let calgary = CLLocationCoordinate2D(latitude: 51.05,longitude: -114.05)
let bounds = GMSCoordinateBounds(coordinate: vancouver, coordinate: calgary)
let camera = mapView.camera(for: bounds, insets: UIEdgeInsets())!
mapView.camera = camera
      

Objective-C

CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
CLLocationCoordinate2D calgary = CLLocationCoordinate2DMake(51.05, -114.05);
GMSCoordinateBounds *bounds =
    [[GMSCoordinateBounds alloc] initWithCoordinate:vancouver coordinate:calgary];
GMSCameraPosition *camera = [mapView cameraForBounds:bounds insets:UIEdgeInsetsZero];
mapView.camera = camera;
      

Remarque :La méthode cameraForBounds:insets: prend en compte marge intérieure définie sur le GMSMapView en plus des encarts spécifiés ici.

Limiter le panoramique à une zone donnée

Ces scénarios définissent les limites de la carte, mais l'utilisateur peut alors faire défiler la carte ou effectuer un panoramique. en dehors de ces limites. Vous pouvez limiter la coordonnée les limites centrales du point focal de la carte (la cible de l'appareil photo) afin que les utilisateurs ne peut que faire défiler et faire un panoramique à l'intérieur de ces limites.

Par exemple, une application de vente au détail pour un centre commercial ou un aéroport peut vouloir limiter la carte à des limites spécifiques, ce qui permet aux utilisateurs de faire défiler et de faire un panoramique à l'intérieur de ces limites.

Pour limiter le panoramique à des limites spécifiques, définissez la propriété cameraTargetBounds de GMSMapView à un objet GMSCoordinateBounds qui définit les limites requises. Pour supprimer la restriction ultérieurement, définissez cameraTargetBounds sur "nil".

Swift

mapView.cameraTargetBounds = bounds
      

Objective-C

mapView.cameraTargetBounds = bounds;
      

Le schéma ci-dessous illustre le scénario suivant : la cible de la caméra est limitée à une zone légèrement plus grande que la fenêtre d'affichage. L'utilisateur peut faire défiler la carte ou effectuer un panoramique, sous réserve que la cible de la caméra reste dans la zone délimitée. La croix représente la cible de la caméra :

La carte remplit toujours la fenêtre d'affichage, même si cela se traduit par l'affichage de zones qui se trouvent en dehors des limites définies. Par exemple, si vous positionnez la cible de la caméra à un angle de la zone délimitée, la zone située au-delà de l'angle est visible dans la fenêtre d'affichage, mais les utilisateurs ne peuvent pas faire défiler la carte jusque dans cette zone. Le schéma suivant illustre ce scénario. La croix représente la cible de la caméra :

Dans le schéma suivant, la cible de la caméra est très limitée. l'utilisateur a très peu de possibilité de faire défiler ou de faire un panoramique sur la carte. La croix représente la cible de la caméra:

Définir un zoom minimal ou maximal

Les constantes globales kGMSMinZoomLevel et kGMSMaxZoomLevel définissent les valeurs de zoom minimales ou maximales. Par défaut, minZoom et maxZoom les propriétés de GMSMapView sont définies sur ces constantes.

Remarque :La plage de niveaux de zoom autorisée peut également dépendre du type de carte, de l'écran la taille et d'autres facteurs. Tout nombre en dehors de la plage autorisée est converti en la valeur valide la plus proche.

Pour limiter la plage de niveaux de zoom disponible pour la carte, définissez des valeurs minimale et maximale le niveau de zoom. Le code suivant limite le niveau de zoom à un niveau compris entre 10 et 15.

Swift

let camera = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 12
)
let mapView = GMSMapView(frame: .zero, camera: camera)
mapView.setMinZoom(10, maxZoom: 15)
      

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:41.887
                                                       longitude:-87.622
                                                             zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero
                                        camera:camera];
[mapView setMinZoom:10 maxZoom:15];
      

Vous devez définir la plage de zoom à l'aide de la méthode setMinZoom:maxZoom:. cependant, vous peuvent lire les valeurs actuelles à l'aide des propriétés minZoom et maxZoom. Ce est utile lorsque vous limitez une seule des valeurs. Le code suivant modifie uniquement le niveau de zoom minimal.

Swift

mapView.setMinZoom(12, maxZoom: mapView.maxZoom)
      

Objective-C

[mapView setMinZoom:12 maxZoom:mapView.maxZoom];
      

Si, après avoir modifié les niveaux de zoom minimal et maximal, le niveau de zoom de la caméra est défini sur en dehors de la nouvelle plage, le zoom actuel est automatiquement afficher la valeur valide la plus proche. Par exemple, dans le code suivant, le zoom d'origine est défini sur 4. Lorsque la plage de zoom est ensuite définie sur 10-15, le le zoom actuel est redéfini sur 10.

Swift

// Sets the zoom level to 4.
let camera2 = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 4
)
let mapView2 = GMSMapView(frame: .zero, camera: camera)

// The current zoom, 4, is outside of the range. The zoom will change to 10.
mapView.setMinZoom(10, maxZoom: 15)
      

Objective-C

// Sets the zoom level to 4.
GMSCameraPosition *camera2 = [GMSCameraPosition cameraWithLatitude:41.887
                                                         longitude:-87.622
                                                              zoom:4];
GMSMapView *mapView2 = [GMSMapView mapWithFrame:CGRectZero
                                         camera:camera];
// The current zoom, 4, is outside of the range. The zoom will change to 10.
[mapView setMinZoom:10 maxZoom:15];