Ajouter une carte avec un repère

Ce tutoriel explique comment ajouter une carte Google simple avec un repère à votre application iOS. Il est destiné aux personnes ayant un niveau de connaissance débutant ou intermédiaire en Swift ou en Objective-C, ainsi que des connaissances générales sur Xcode. Pour en savoir plus sur la création de cartes, consultez le guide du développeur.

Vous allez créer la carte suivante à l'aide de ce tutoriel. Le repère est placé à Sydney, en Australie.

Obtenir le code

Clonez ou téléchargez le dépôt d'exemples Google Maps iOS sur GitHub.

Vous pouvez également cliquer sur le bouton suivant pour télécharger le code source:

Obtenir le code

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.
        let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        let mapView = GMSMapView.map(withFrame: self.view.frame, camera: camera)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}
      

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:6];
  GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
  mapView.myLocationEnabled = YES;
  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end
      

Commencer

Obtenir une clé API et activer les API nécessaires

Pour suivre ce tutoriel, vous devez disposer d'une clé API Google autorisée à utiliser le SDK Maps pour iOS. Cliquez sur le bouton ci-dessous pour obtenir une clé et activer l'API.

Pour en savoir plus, consultez la section Obtenir une clé API.

Ajouter la clé API à votre application

Ajoutez votre clé API à votre fichier AppDelegate.swift comme suit :

1. Notez que l'instruction d'importation suivante a été ajoutée au fichier :

   import GoogleMaps

2. Modifiez la ligne suivante dans votre méthode application(_:didFinishLaunchingWithOptions:), en remplaçant YOUR_API_KEY par votre clé API :

   GMSServices.provideAPIKey("YOUR_API_KEY")

Compiler et exécuter votre application

1. Connectez un appareil iOS à votre ordinateur ou sélectionnez un simulateur dans le menu du schéma Xcode.
2. Si vous utilisez un appareil, assurez-vous que les services de localisation sont activés. Si vous utilisez un simulateur, sélectionnez un emplacement dans le menu Fonctionnalités.
3. Dans Xcode, cliquez sur l'option de menu Product/Run (Produit/Exécuter) ou sur l'icône du bouton de lecture.
• Xcode compile l'application, puis l'exécute sur l'appareil ou sur l'émulateur.
• Vous devriez voir une carte avec un repère centré sur Sydney (côte est de l'Australie), semblable à l'image figurant sur cette page.

Dépannage :

• Si aucune carte ne s'affiche, vérifiez que vous avez bien obtenu une clé API et que vous l'avez ajoutée à l'application, comme décrit précédemment. Recherchez les messages d'erreur concernant la clé API dans la console de débogage d'Xcode.
• Si vous avez limité la clé API par l'identifiant du bundle iOS, modifiez-la afin d'ajouter l'identifiant du bundle pour l'application : com.google.examples.map-with-marker.
• Assurez-vous d'avoir un bon signal Wi-Fi ou GPS.
• Utilisez les outils de débogage Xcode pour afficher les journaux et déboguer l'application.

Comprendre le code

1. Créez une carte et définissez-la comme vue dans viewDidLoad().

   Swift

   // Create a GMSCameraPosition that tells the map to display the
   // coordinate -33.86,151.20 at zoom level 6.
   let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
   let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
   view = mapView
         

   Objective-C

   // Create a GMSCameraPosition that tells the map to display the
   // coordinate -33.86,151.20 at zoom level 6.
   GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                           longitude:151.20
                                                                zoom:6.0];
   GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
   self.view = mapView;
         

2. Ajoutez un repère à la carte dans viewDidLoad().

   Swift

   // Creates a marker in the center of the map.
   let marker = GMSMarker()
   marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
   marker.title = "Sydney"
   marker.snippet = "Australia"
   marker.map = mapView
         

   Objective-C

   // Creates a marker in the center of the map.
   GMSMarker *marker = [[GMSMarker alloc] init];
   marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
   marker.title = @"Sydney";
   marker.snippet = @"Australia";
   marker.map = mapView;
         

Par défaut, le SDK Maps pour iOS affiche le contenu de la fenêtre d'informations lorsque l'utilisateur appuie sur un repère. Il n'est pas nécessaire d'ajouter un écouteur de clic pour le repère si le comportement par défaut vous suffit.

Félicitations ! Vous avez créé une application iOS qui affiche une carte Google avec un repère indiquant un lieu spécifique. Vous avez également appris à utiliser le SDK Maps pour iOS.

Étapes suivantes

En savoir plus sur l'objet map et sur les possibilités offertes par les repères