Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps SDK for iOS

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou choisir un projet
  2. Activer Google Maps SDK for iOS
  3. Créer les clés appropriées
Continuer

Paramétrage et démo

Cette page décrit comment configurer la bibliothèque d'utilitaires pour le Google Maps SDK for iOS. Si vous le souhaitez, vous pouvez également installer l'application de démo de la bibliothèque d'utilitaires dans un projet Xcode temporaire, puis l'exécuter pour voir des exemples des fonctionnalités de la bibliothèque.

Obtenir CocoaPods

La bibliothèque d'utilitaires est disponible sous la forme d'un pod CocoaPods nommé Google-Maps-iOS-Utils. CocoaPods est un gestionnaire de dépendances open source pour les projets Cocoa Swift et Objective-C.

Si vous ne possédez pas encore l'outil CocoaPods, installez-le sur macOS en exécutant la commande suivante à partir du terminal :

sudo gem install cocoapods

Pour plus de détails, voir le guide de démarrage de CocoaPods.

(Facultatif) Installez et exécutez l'application de démo.

La bibliothèque d'utilitaires inclut une application de démo que vous pouvez installer et exécuter comme suit :

  1. Exécutez la commande suivante :
    pod try Google-Maps-iOS-Utils
  2. Lorsque vous y êtes invité, choisissez entre Swift et Objective-C. CocoaPods met à jour vos référentiels de spécifications, puis ouvre la démo dans un projet Xcode temporaire nommé SwiftDemoApp.xcodeproj ou ObjCDemoApp.xcodeproj.

  3. Si vous n'avez pas encore de clé d'API Google Maps, obtenez-en une maintenant :
    1. Allez à la Google API Console.
    2. Créez ou sélectionnez un projet.
    3. Cliquez sur Continue pour activer le Google Maps SDK for iOS.
    4. Sur la page Credentials, obtenez une clé d'API.
      Remarque : Si vous avez une clé avec des restrictions pour iOS, vous pouvez l'utiliser. Vous pouvez utiliser la même clé avec n'importe laquelle de vos applications iOS au sein du même projet.
    5. Dans la boîte de dialogue affichant la clé d'API, sélectionnez Restrict key afin de définir une restriction pour iOS sur la clé d'API.
    6. Dans la section Restrictions, sélectionnez iOS apps, puis saisissez l'identifiant de groupe de votre application. Par exemple : com.example.hellomap.
    7. Cliquez sur Save.

      Votre nouvelle clé d'API restreinte à iOS s'affiche dans la liste des clés d'API de votre projet. Une clé d'API est une chaîne de caractères semblable à ce qui suit :

      AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

    Vous pouvez également rechercher une clé existante dans la Google API Console.

  4. Modifiez le fichier AppDelegate.swift ou AppDelegate.m dans votre projet Xcode et collez votre clé d'API dans la définition de la constante kMapsAPIKey.
  5. Créez et exécutez le projet.

Installer la bibliothèque d'utilitaires en tant que projet Xcode

Suivez les étapes suivantes pour ajouter la bibliothèque d'utilitaires à votre espace de travail Xcode :

  1. Si vous n'avez pas encore de projet Xcode, créez-en un immédiatement et enregistrez-le sur votre machine locale. (Si vous n'êtes pas familier du développement iOS, créez une application Single View.)
  2. Si vous n'avez pas encore de fichier pod pour votre projet, créez un fichier nommé Podfile dans le répertoire de votre projet. Ce fichier définit les dépendances de votre projet.
  3. Modifiez le fichier pod de votre projet et ajoutez une dépendance au pod Google-Maps-iOS-Utils. Voici un exemple qui inclut les dépendances dont vous avez besoin pour le Google Maps SDK for iOS et la bibliothèque d'utilitaires :
    source 'https://github.com/CocoaPods/Specs.git'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleMaps'
      pod 'Google-Maps-iOS-Utils'
    end
  4. Exécutez pod install.
  5. Fermez Xcode, et ouvrez (par un double clic) le fichier .xcworkspace de votre projet pour lancer Xcode. À partir de ce moment, vous devez utiliser le fichier .xcworkspace pour ouvrir le projet.

Remarque : L'utilitaire de regroupement des marqueurs dépend du quadtree, mais vous pouvez utiliser le quadtree sans regroupement des marqueurs. Si vous n'avez besoin que de l'utilitaire quadtree, vous pouvez définir pod 'Google-Maps-iOS-Utils' sur 'Google-Maps-iOS-Utils/QuadTree' dans votre fichier pod.

Créer un en-tête de pontage (Swift uniquement)

Si vous avez créé votre projet en utilisant Swift, vous devez ajouter un en-tête de pontage à votre projet de sorte que Swift puisse utiliser les classes Objective-C de la bibliothèque d'utilitaires. Suivez les étapes ci-dessous pour ajouter un en-tête de pontage :

  1. Ajoutez un nouveau fichier d'en-tête dans le dossier racine de votre projet. Nommez le fichier comme vous le souhaitez, avec l'extension de nom de fichier .h.
  2. Collez le code suivant dans le fichier :
    #import <Google-Maps-iOS-Utils/GMUMarkerClustering.h>
    

    Ou collez le code suivant si vous n'avez besoin que de l'utilitaire quadtree :

    #import <Google-Maps-iOS-Utils/GQTPointQuadTree.h>
    
  3. Enregistrez le fichier.
  4. Dans l'éditeur de projet Xcode, sélectionnez le projet principal.
  5. Accédez à Build Settings dans l'éditeur de version Xcode.
  6. Dans les paramètres de version, trouvez Swift Compiler - Code Generation.
  7. Dans la section Objective-C Bridging Header, ajoutez le chemin d'accès au fichier d'en-tête que vous venez de créer.
  8. Créez le projet.

Pour plus de détails, voir le guide d'Apple qui explique comment utiliser Swift et Objective-C dans le même projet.

Obtenir une clé d'API

Cliquez sur le bouton ci-dessous pour obtenir de l'aide tout au long du processus d'activation de Google Maps SDK for iOS et d'obtention d'une clé d'API. Si votre projet comporte déjà une clé d'API restreinte à iOS, vous pouvez utiliser cette clé.

Obtenir une clé

Vous pouvez également obtenir une clé d'API comme suit :

  1. Allez à la Google API Console.
  2. Créez ou sélectionnez un projet.
  3. Cliquez sur Continue pour activer le Google Maps SDK for iOS.
  4. Sur la page Credentials, obtenez une clé d'API.
    Remarque : Si vous possédez une clé avec des restrictions pour iOS, vous pouvez l'utiliser. Vous pouvez utiliser la même clé avec n'importe laquelle de vos applications iOS au sein du même projet.
  5. Dans la boîte de dialogue affichant la clé d'API, sélectionnez Restrict key afin de définir une restriction pour iOS sur la clé d'API.
  6. Dans la section Restrictions, sélectionnez iOS apps, puis saisissez l'identifiant de groupe de votre application. Par exemple : com.example.hellomap.
  7. Cliquez sur Save.

    Votre nouvelle clé d'API restreinte à iOS s'affiche dans la liste des clés d'API de votre projet. Une clé d'API est une chaîne de caractères semblable à ce qui suit :

    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Vous pouvez également rechercher une clé existante dans la Google API Console.

Pour plus d'informations sur l'utilisation de la Google API Console, voir l'aide de la API Console.

Ajouter la clé d'API à votre application

Swift

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

  1. Ajoutez la déclaration d'importation suivante :
    import GoogleMaps
  2. Ajoutez ce qui suit à votre méthode application(_:didFinishLaunchingWithOptions:), en remplaçant YOUR_API_KEY par votre clé d'API :
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Si vous utilisez également Places API, ajoutez votre clé à nouveau, tel qu'illustré ici :
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Ajoutez votre clé d'API à AppDelegate.m comme suit :

  1. Ajoutez la déclaration d'importation suivante :
    @import GoogleMaps;
  2. Ajoutez ce qui suit à votre méthode application:didFinishLaunchingWithOptions:, en remplaçant YOUR_API_KEY par votre clé d'API :
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Si vous utilisez également Places API, ajoutez votre clé à nouveau, tel qu'illustré ici :
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Ajouter le regroupement de marqueurs ou quadtree à votre application

Voir les guides sur le regroupement de marqueurs et sur quadtree.

Envoyer des commentaires concernant…

Google Maps SDK for iOS
Google Maps SDK for iOS
Besoin d'aide ? Consultez notre page d'assistance.