Paramétrage et démo

Sélectionnez une plate-forme : Android iOS

Cette page explique comment configurer bibliothèque utilitaire pour le SDK Maps pour iOS.

Pour essayer ces utilitaires, vous avez deux possibilités:

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 maintenant et enregistrez-le sur votre ordinateur local. (Si vous débutez dans le développement iOS, créez un projet et sélectionnez l'application iOS modèle. 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. Voir Installer le SDK pour connaître les options.
  3. Dans votre projet Xcode, accédez à File (Fichier) -> Packages Swift -> Ajoutez 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 Suivant.
    • À ce stade, vous serez peut-être invité à vous authentifier avec votre compte GitHub. Suivez le les instructions pour créer GitHub jeton d'accès personnel pour poursuivre le processus.
  5. Dans la fenêtre suivante, sélectionnez l'option Version, puis 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 le menu déroulant à côté de Ajouter au projet, sélectionnez votre projet, puis sélectionnez Ajouter un package.

Utiliser CocoaPods

  1. Si vous n'avez pas encore de projet Xcode, créez-en un maintenant et enregistrez-le dans sur votre ordinateur local. (Si vous débutez dans le développement iOS, créez un Single Voir l'application.)
  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 votre les dépendances du projet.
  3. Modifiez le fichier Pod de votre projet et ajoutez une dépendance au niveau Pod Google-Maps-iOS-Utils. Voici une qui inclut les dépendances dont vous avez besoin SDK Maps pour iOS et 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.0.0' # x-release-please-version
end
  4. Exécutez pod install.
  5. Fermez Xcode, puis ouvrez (double-cliquez) le dossier .xcworkspace pour lancer Xcode. À partir de ce moment, vous doit 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 voulez seul l'utilitaire quadtree, vous pouvez modifier pod 'Google-Maps-iOS-Utils' jusqu'à '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

Une fois la clé API ajoutée, compilez et exécutez le projet.

Utiliser un utilitaire dans votre application

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

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

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

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

Utiliser des fichiers de GitHub

  1. Télécharger l'archive de l'exemple de code à partir de GitHub et décompresser l'archive.
  2. Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez développé les fichiers d'exemple, puis accédez au répertoire d'exemples approprié pour le langage que vous souhaitez utiliser: <ph type="x-smartling-placeholder">
      </ph>
    • 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 dossier .xcworkspace pour lancer Xcode. À partir de ce moment, vous doit 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écifications, Ensuite, la démo s'ouvre 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 maintenant cette clé au projet Xcode pour 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 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 la déclaration 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 = @"";

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émo, vous pouvez sélectionner l'utilitaire à afficher dans l'application.
  • Si vous exécutez la version de démonstration Objective-C, vous voyez la version de démonstration un 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.