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. En outre, vous trouverez 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 Objectif-C.

Le SDK Places pour iOS fournit un ensemble d'applications de démonstration de 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 exemples de fichiers à l'aide de l'une des deux méthodes suivantes:

    Utiliser des fichiers de GitHub

    1. Téléchargez l'archive d'exemple de code sur 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 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 Places à l'aide de CocoaPods : 
      pod try GooglePlaces

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

  3. Activez le SDK Places pour iOS pour votre projet dans la console Google Cloud.
  4. Si vous ne possédez pas encore de clé API, suivez les instructions pour configurer un projet sur la console Cloud et obtenir une clé API. Lorsque vous configurez la clé dans la console Cloud, vous pouvez spécifier l'identifiant de bundle de votre application pour vous assurer que seule votre application peut l'utiliser. L'identifiant de bundle par défaut de l'application exemple 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 le modifier, sélectionnez Unlock (Déverrouiller).
  7. Si elle est présente, supprimez la ligne suivante, car elle est utilisée pour enregistrer le problème:

    Swift

    #error (S'enregistrer pour la clé API et insérer 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 lorsque vous l'exécutez pour la première fois, assurez-vous d'avoir 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émonstration Places.
  11. Si vous êtes invité à autoriser GooglePlacesDemos à accéder à votre position, sélectionnez Autoriser.
  12. L'échantillon choisi peut désormais être lancé.

Utiliser les 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, reportez-vous aux guides sur la saisie semi-automatique, l'obtention du lieu actuel, les photos et les autres pages de ce guide.