Paramétrage et démo

Sélectionnez une plate-forme : Android iOS

Cette page explique comment configurer la bibliothèque d'utilitaires du SDK Maps pour iOS.

Pour essayer ces utilitaires, vous pouvez:

Ajouter la bibliothèque d'utilitaires du SDK Maps pour iOS à un projet Xcode

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

Utiliser Swift Package Manager

  1. Si vous n'avez pas encore de projet Xcode, créez-en un et enregistrez-le sur votre machine locale. (Si vous débutez avec le développement iOS, créez un projet et sélectionnez le modèle d'application iOS. Dans Xcode 11.7 ou version antérieure, créez une application Single View.)
  2. Ajoutez le SDK Maps pour iOS en tant que dépendance. Pour en savoir plus, consultez la section Installer le SDK.
  3. Dans votre projet Xcode, accédez à File (Fichier) -> Swift Packages (Packages Swift) -> Add Package Dependency (Ajouter une dépendance de package).
  4. Dans la fenêtre qui s'affiche, saisissez l'URL du dépôt de la bibliothèque d'utilitaires du SDK Maps pour iOS https://github.com/googlemaps/google-maps-ios-utils, puis sélectionnez Next (Suivant).
    • À ce stade, vous pouvez être invité à vous authentifier avec votre compte GitHub. Suivez les instructions pour créer un jeton d'accès personnel GitHub afin de poursuivre le processus.
  5. Dans la fenêtre suivante, sélectionnez l'option radio Version, sélectionnez Jusqu'à la prochaine version majeure dans la liste déroulante, puis saisissez la dernière version de la bibliothèque d'utilitaires du SDK Maps pour iOS (par exemple, "6.0.0").
  6. Cliquez sur la liste déroulante à côté de Ajouter au projet, sélectionnez votre projet, puis Ajouter un package.

Utiliser CocoaPods

  1. Si vous n'avez pas encore de projet Xcode, créez-en un et enregistrez-le sur votre machine locale. (Si vous débutez avec le 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 de 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 SDK Maps pour iOS et la bibliothèque d'utilitaires:
    source 'https://github.com/CocoaPods/Specs.git'
    platform :ios, '15.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      use_frameworks!
      pod 'GoogleMaps', '9.0.0'
      pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
    end
  4. Exécutez pod install.
  5. Fermez Xcode, puis ouvrez (double-cliquez) 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 repères dépend du quadtree, mais vous pouvez utiliser le quadtree sans regroupement des repères. Si vous ne souhaitez utiliser que l'utilitaire quadtree, vous pouvez remplacer pod 'Google-Maps-iOS-Utils' par 'Google-Maps-iOS-Utils/QuadTree' dans votre fichier de pod.

Ajouter la clé API à votre application

Consultez Configurer un projet Xcode pour savoir comment générer une clé API et l'ajouter à votre projet Xcode.

Créer et exécuter le projet

Après avoir ajouté la clé API, compilez et exécutez le projet.

Utiliser un utilitaire dans votre application

Pour en savoir plus sur l'utilisation de chaque utilitaire dans votre application, consultez la documentation correspondante:

Installer et exécuter l'application de démonstration

La bibliothèque d'utilitaires inclut une application de démonstration que vous pouvez installer, puis tester chaque utilitaire.

Installez l'application de démonstration:

Utiliser des fichiers depuis GitHub

  1. Téléchargez l'archive de l'exemple de code sur GitHub et décompressez-la.
  2. Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez développé les exemples de fichiers, puis accédez au répertoire d'exemples approprié pour la langue que vous souhaitez utiliser :
    • Pour Swift, exécutez cd google-maps-ios-utils-master/samples/SwiftDemoApp.
    • Pour Objective-C, exécutez cd google-maps-ios-utils-master/samples/ObjCDemoApp.
  3. Exécutez la commande suivante :
    pod install
  4. Fermez Xcode, puis ouvrez (double-cliquez) le fichier .xcworkspace de votre projet pour lancer Xcode. À partir de ce moment, vous devez utiliser le fichier .xcworkspace pour ouvrir le projet.

Ajouter la clé API à l'application de démonstration

Dans Obtenir une clé API, vous avez généré une clé API pour votre application. Ajoutez-la maintenant au projet Xcode de l'application de démonstration.

Swift

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

  1. Ajoutez la déclaration d'importation suivante :
    import GoogleMaps
  2. Modifiez la ligne suivante pour ajouter votre clé API entre guillemets doubles:
    // Change this key to a valid key registered with the demo app bundle id.
    let mapsAPIKey = ""

Objective-C

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

  1. Ajoutez la déclaration d'importation suivante :
    @import GoogleMaps;
  2. Modifiez la ligne suivante pour ajouter votre clé API entre guillemets doubles:
    // Change this key to a valid key registered with the demo app bundle id.
    static NSString *const kMapsAPIKey = @"";

Compiler et exécuter l'application de démonstration

Après avoir ajouté la clé API, compilez et exécutez le projet:

  • Si vous exécutez la version Swift de la démonstration, vous pouvez sélectionner l'utilitaire à afficher dans l'application.
  • Si vous exécutez la version Objective-C de la démonstration, vous voyez la démonstration de l'utilitaire de regroupement de repères. Vous pouvez ensuite modifier la version Objective-C de la démonstration pour essayer chaque utilitaire. Pour en savoir plus, consultez la section Ajouter un utilitaire à votre application ci-dessous.