Présentation des exemples de code

Sélectionnez une plate-forme: Android iOS JavaScript

Les applications de démonstration du SDK fournies avec le SDK Places pour iOS présentent un certain nombre de fonctionnalités, y compris la saisie semi-automatique de lieux et les photos de lieux. Vous trouverez par ailleurs des extraits de code sur chaque page de ce guide du développeur.

Essayer les démos de SDK à l'aide de CocoaPods

Le SDK Places pour iOS est disponible en tant que pod CocoaPods. CocoaPods est un gestionnaire de dépendances Open Source pour les projets Cocoa Swift et Objective-C.

Le SDK Places pour iOS fournit un ensemble d'applications de démonstration du SDK que vous pouvez installer et exécuter à l'aide de la commande pod try:

Pour installer CocoaPods et essayer le SDK Places pour iOS, procédez comme suit:

  1. Si vous ne possédez pas encore l'outil CocoaPods, installez-le sur macOS en exécutant la commande ci-dessous à partir du terminal. Pour en savoir plus, consultez le guide de démarrage de CocoaPods. 
    sudo gem install cocoapods
  2. Récupérez les fichiers d'exemple à l'aide de l'une de ces deux méthodes:

    Utiliser des fichiers GitHub

    1. Téléchargez l'exemple d'archive de code depuis GitHub, puis décompressez-le.
    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 détail du répertoire GooglePlaces :

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces
    3. Exécutez la commande suivante:
      pod install
      
open GooglePlacesDemos.xcworkspace

    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 Adresses à l'aide de CocoaPods : 
      pod try GooglePlaces

      CocoaPods met à jour vos dépôts de spécifications, puis ouvre les démos du SDK dans un projet Xcode temporaire, GooglePlacesDemos.xcworkspace.

  3. Activez le SDK Places pour iOS pour votre projet Google Cloud Console.
  4. Si vous ne disposez pas encore d'une clé API, suivez les instructions pour configurer un projet dans Cloud Console et obtenir une clé API. Lorsque vous configurez la clé sur Cloud Console, vous pouvez spécifier l'identifiant de groupe de votre application pour vous assurer que seule votre application peut l'utiliser. L'identifiant de groupe par défaut de l'application d'exemples de SDK est com.example.GooglePlacesDemos.
  5. Modifiez le fichier SDKDemoAPIKey et collez votre clé API dans la constante appropriée. Exemple :

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. Si Xcode vous invite à déverrouiller le fichier SDKDemoAPIKey pour modification, sélectionnez Déverrouiller.
  7. Le cas échéant, supprimez la ligne suivante, car elle est utilisée pour enregistrer le problème:

    Swift

    #error (Inscrivez-vous pour obtenir la clé API et l'insérez ici.) Supprimez ensuite cette ligne.")

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. Créez et exécutez une nouvelle fois le projet.
  9. Si la compilation échoue ou si l'application plante avec une erreur concernant votre clé API lors de sa première exécution, assurez-vous que vous avez fourni les clés requises dans le fichier SDKDemoAPIKey.
  10. Si vous exécutez les démonstrations GooglePlaces, la fenêtre du simulateur iOS affiche une liste de démonstrations de lieux.
  11. Si vous êtes invité à autoriser GooglePlacesDemos à accéder à votre position, sélectionnez Autoriser.
  12. L'échantillon choisi peut désormais être lancé.

Utiliser des extraits de code du guide du développeur

Chaque page du guide du développeur inclut des extraits de code qui illustrent une fonctionnalité particulière de l'API. Par exemple, consultez les guides sur la saisie semi-automatique, obtenir le lieu actuel, les photos et d'autres pages de ce guide.