Paramétrage et démo

Sélectionnez la 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 :

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 connaître les options, consultez Installer le SDK.
  3. Dans votre projet Xcode, accédez à File -> Swift Packages -> Add Package Dependency (Fichier > Packages Swift > 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 et sélectionnez Next (Suivant).
    • Vous serez peut-ê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 , puis Up to Next Major Version dans la liste déroulante. Saisissez ensuite 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 Add to Project (Ajouter au projet), sélectionnez votre projet, puis cliquez sur Add Package (Ajouter un package).

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

Une fois la clé API ajoutée, créez 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 essayer chaque utilitaire.

Pour installer l'application de démonstration :

Utiliser des fichiers depuis GitHub

  1. Téléchargez l'archive d'exemple de code depuis GitHub et décompressez-la. Vous pouvez également cloner le dépôt dans un répertoire local :
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez décompressé les exemples de fichiers, puis accédez au répertoire d'exemples approprié pour le langage que vous souhaitez utiliser :

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
    open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
    open 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 pour l'application de démonstration. consultez Obtenir une clé API.

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 = @"";

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

Une fois la clé API ajoutée, 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, vous verrez 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.