Paramétrage et démo

Sélectionnez une plate-forme : Android iOS

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

Pour essayer ces utilitaires, vous pouvez:

Installer CocoaPods (facultatif)

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 disposez pas encore de l'outil CocoaPods, installez-le sur macOS en exécutant la commande suivante à partir du terminal:

sudo gem install cocoapods

Pour en savoir plus, consultez le guide de démarrage de CocoaPods.

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 essayer chaque utilitaire.

Installez l'application de démonstration en utilisant l'une des deux méthodes suivantes:

Utiliser des fichiers GitHub

  1. Téléchargez l'exemple d'archive de code depuis GitHub, puis décompressez l'archive.
  2. Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez développé les exemples de fichiers, puis affichez le répertoire d'exemples correspondant au langage 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.

Utiliser CocoaPods v1.6.1

  1. Ouvrez une fenêtre de terminal et installez la version 1.6.1 : 
    sudo gem install cocoapods -v1.6.1
  2. Récupérez les fichiers Google Maps à l'aide de CocoaPods : 
    pod try Google-Maps-iOS-Utils

    Lorsque vous y êtes invité, choisissez entre Swift et Objective-C. CocoaPods met à jour vos dépôts de spécification, puis ouvre la démonstration dans un projet Xcode temporaire nommé SwiftDemoApp.xcodeproj ou ObjCDemoApp.xcodeproj.

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

Dans Obtenir une clé API, vous générez 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 l'instruction d'importation suivante : 
    import GoogleMaps
  2. Modifiez la ligne suivante pour ajouter votre clé API entre les 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 l'instruction d'importation suivante : 
    @import GoogleMaps;
  2. Modifiez la ligne suivante pour ajouter votre clé API entre les guillemets doubles : 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

Créer et exécuter l'application de démonstration

Après avoir ajouté la clé API, créez 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, celle-ci s'affiche. 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.

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 :

Utiliser CocoaPods

  1. Si vous n'avez pas encore de projet Xcode, créez-en un maintenant et enregistrez-le sur votre ordinateur local. (Si vous débutez avec le développement sur iOS, créez une application Single View.)
  2. Si vous n'avez pas encore de fichier de 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, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '7.4.0'
  pod 'Google-Maps-iOS-Utils', '4.1.0'
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 de repères dépend du quadtree, mais vous pouvez utiliser le quadtree sans regroupement de repères. Si vous ne souhaitez que l'utilitaire quadtree, vous pouvez remplacer pod 'Google-Maps-iOS-Utils' par 'Google-Maps-iOS-Utils/QuadTree' dans le fichier de votre pod.

Utiliser Carthage

  1. Installez Carthage. Plusieurs méthodes existent. Pour connaître la procédure exacte, consultez le fichier README de Carthage.
  2. 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 version 11.7 ou antérieure, créez une application Single View.)
  3. Créez un fichier nommé Cartfile dans le répertoire de votre projet. Ce fichier définit les dépendances de votre projet.
  4. Modifiez Cartfile et ajoutez la dépendance de la bibliothèque d'utilitaires du SDK Maps pour iOS:
    github "googlemaps/google-maps-ios-utils"
  5. Enregistrez le Cartfile.
  6. Dans une fenêtre de terminal, accédez au répertoire contenant Cartfile :
    cd <path-to-project>
  7. Exécutez la commande de mise à jour:
    carthage update --platform iOS

    Cette action installera les API spécifiées dans Cartfile, ainsi que toutes les dépendances éventuelles.
  8. Dans le Finder, accédez au répertoire de votre projet et accédez aux fichiers de framework téléchargés sous Carthage/Build/iOS.
  9. Ajoutez les frameworks du SDK Maps pour iOS à votre projet en faisant glisser les groupes suivants dans votre projet. (Lorsque vous y êtes invité, sélectionnez Copier des éléments si nécessaire, veuillez utiliser la même version que ci-dessus.)
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
    Les clients du forfait Premium doivent également inclure GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework.
  10. Effectuez un clic droit sur GoogleMaps.framework dans votre projet, puis sélectionnez Show In Finder (Afficher dans le Finder).
  11. Faites glisser Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle du dossier Resources vers votre projet. Lorsque vous y êtes invité, vérifiez que Copy items into destination group's folder (Copier les éléments dans le dossier du groupe de destination) n'est pas sélectionné.
  12. Sélectionnez votre projet dans Project Navigator, puis choisissez la cible de votre application.
  13. Ouvrez l'onglet Build Phases (Phases de compilation) pour la cible de votre application, puis ajoutez les frameworks suivants dans la section Link Binary with Libraries (Associer le binaire avec les bibliothèques) :
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

  14. Choisissez votre projet plutôt qu'une cible spécifique, et ouvrez l'onglet Build Settings (Paramètres de build). Dans la section Other Linker Flags (Autres indicateurs Linker), ajoutez -ObjC. Si ces paramètres ne sont pas visibles, modifiez le filtre dans la barre Build Settings (Paramètres de build) de Basic (De base) à All (Tous).

Utiliser Swift Package Manager

  1. Si vous n'avez pas encore de projet Xcode, créez-en un maintenant et enregistrez-le sur votre ordinateur local. (Si vous débutez avec le développement iOS, créez un projet et sélectionnez le modèle d'application iOS. Sous 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 connaître les options, consultez Installer le SDK.
  3. Dans votre projet Xcode, accédez à File -> Swift Packages -> Add Package Dependency (Ajouter une dépendance de package).
  4. Dans la fenêtre qui s'affiche, saisissez l'URL https://github.com/googlemaps/google-maps-ios-utils du dépôt de la bibliothèque d'utilitaires du SDK Maps pour iOS, puis sélectionnez 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, cochez la case d'option Version, sélectionnez Exact dans la liste déroulante, saisissez la dernière version de la bibliothèque d'utilitaires du SDK Maps pour iOS (par exemple, "3.4.0", par exemple), puis cliquez sur Suivant.

Ajouter la clé API à votre application

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

Créer et exécuter le projet

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

Ajouter un utilitaire à votre application

Consultez la documentation de chaque utilitaire pour en savoir plus sur son utilisation dans votre application: