Ajouter une carte

Dans l'API, les cartes sont représentées par la classe GMSMapView, une sous-classe de UIView. La carte est l'objet le plus important du SDK Maps pour iOS et fournit les méthodes nécessaires pour ajouter, supprimer et gérer d'autres objets tels que des repères et des polylignes.

Introduction

Le SDK Maps pour iOS vous permet d'afficher une carte Google dans votre application iOS. Ces cartes ont la même apparence que celles qui apparaissent dans l'application iOS Google Maps et le SDK présente de nombreuses fonctionnalités identiques.

Outre la fonctionnalité de cartographie, l'API prend aussi en charge toute une gamme d'interactions conformes au modèle de l'interface utilisateur iOS. Par exemple, vous pouvez configurer des interactions avec une carte en définissant des répondeurs qui réagissent aux gestes de l'utilisateur, tels que l'appui simple et l'appui double.

La classe principale lors de l'utilisation d'un objet Map est la classe GMSMapView. GMSMapView gère automatiquement les opérations suivantes :

• Connexion au service Google Maps
• Téléchargement des tuiles de carte
• Affichage des tuiles sur l'écran de l'appareil
• Affichage de diverses commandes comme le panoramique et le zoom
• Réponse aux gestes de panoramique et de zoom (déplacement de la carte et zoom avant ou arrière)
  • Répondre aux gestes à deux doigts en inclinant l'angle de vue de la carte.

En plus de ces opérations automatiques, vous pouvez contrôler le comportement et l'apparence de la carte grâce aux propriétés et aux méthodes exposées par la classe GMSMapView. Utilisez GMSMapView pour ajouter et supprimer des repères, des calques au sol et des polylignes, modifier le type de carte affiché et contrôler ce qui est affiché sur la carte à l'aide de la classe GMSCameraPosition.

Créer des cartes avec SwiftUI

SwiftUI propose une autre façon de créer une UI à l'aide d'une approche déclarative. Vous indiquez à SwiftUI l'apparence souhaitée pour votre vue ainsi que ses différents états, et le système se charge du reste. SwiftUI gère la mise à jour de la vue chaque fois que l'état sous-jacent change en raison d'un événement ou d'une action de l'utilisateur.

Le SDK Maps pour iOS repose sur UIKit et ne fournit pas de vue compatible avec SwiftUI. Pour ajouter des cartes dans SwiftUI, vous devez vous conformer à UIViewRepresentable ou UIViewControllerRepresentable. Pour en savoir plus, consultez l'atelier de programmation Ajouter une carte à votre application iOS avec SwiftUI.

Ajouter une carte

Les principales étapes pour ajouter une carte sont les suivantes :

1. Pour télécharger le SDK, obtenir une clé API et ajouter les frameworks requis, suivez les étapes décrites dans :

   1. Configurer dans la console Google Cloud

   2. Utiliser une clé API

   3. Configurer un projet Xcode

   4. Dans votre AppDelegate, fournissez votre clé API à la méthode de classe provideAPIKey: sur GMSServices.

   5. Créez ou mettez à jour un ViewController. Si la carte s'affiche lorsque ce contrôleur de vue devient visible, veillez à la créer dans la méthode viewDidLoad.

   6. Lorsque vous initialisez votre vue de carte, définissez les options de configuration avec GMSMapViewOptions. Les propriétés incluent frame, camera, mapID,backgroundColor ou screen.

   7. Définissez la propriété map options camera avec un objet GMSCameraPosition. Cela spécifie le centre et le niveau de zoom de la carte.

   8. Créez et instanciez une classe GMSMapView à l'aide de la méthode options: GMSMapView. Si cette carte doit être utilisée comme seule vue du contrôleur de vue, la valeur par défaut CGRectZero de l'option de carte frame peut être utilisée comme vue frame : la carte est redimensionnée automatiquement.

   9. Définissez l'objet GMSMapView comme vue du contrôleur de vue. Exemple : self.view = mapView;.

Dans l'exemple ci-dessous, une carte, centrée sur le centre-ville de Singapour, est ajoutée à une application.

import GoogleMaps

class MapObjects : UIViewController {
  override func viewDidLoad() {
    super.viewDidLoad()

    let options = GMSMapViewOptions()
    options.camera = GMSCameraPosition(latitude: 1.285, longitude: 103.848, zoom: 12)
    options.frame = self.view.bounds;

    let mapView = GMSMapView(options:options)
    self.view = mapView
  }
}

- (void)viewDidLoad {
  [super viewDidLoad];

  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                        longitude:103.848
                                                             zoom:12];
  options.frame = self.view.bounds;

  GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
  self.view = mapView;
}

Une fois ces étapes effectuées, vous pouvez configurer l'objet GMSMapView.

Étape suivante

Une fois ces étapes effectuées, vous pourrez configurer les paramètres de la carte.