Exemples de code utilisant le SDK Places pour iOS

Sélectionnez une plate-forme : Android iOS JavaScript

L'application de démonstration du SDK Places pour iOS sur GitHub fournie avec le SDK Places pour iOS illustre plusieurs fonctionnalités, y compris Place Autocomplete et Place Photos. De plus, vous trouverez des extraits de code sur chaque page de ce guide du développeur. Importez et créez l'application, ajoutez votre clé API, consultez la démonstration et utilisez l'exemple de code fourni comme point de départ pour votre application.

Lorsque vous exécutez l'application exemple, elle affiche une liste des exemples disponibles que vous pouvez exécuter sur votre appareil. Sélectionnez l'une des options proposées.

Exécuter l'exemple d'application complet en local

L'application exemple du SDK Places pour iOS est disponible sous forme d'archive à télécharger sur GitHub. Suivez ces étapes pour installer et essayer l'application exemple du SDK Places pour iOS.

  1. Téléchargez l'archive de l'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-samples/ios-places-sdk-samples.git

  2. Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez développé les fichiers exemples, puis accédez au répertoire de la version que vous souhaitez utiliser :

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. Dans le projet Xcode, accédez à File > Add Package Dependencies (Fichier > Ajouter des dépendances de package). Saisissez l'URL https://github.com/googlemaps/ios-places-sdk, appuyez sur Entrée pour importer le package, puis cliquez sur Add Package (Ajouter le package).
  4. Activez le SDK Places pour iOS et le SDK Maps pour iOS pour votre projet console Google Cloud.
  5. Obtenez une clé API à partir de votre projet avec l'API Places et/ou l'API Places (nouvelle version) activées.
  6. Ajoutez votre clé API à l'application en suivant les instructions appropriées ci-dessous.

    SwiftUI

    Créez un fichier de configuration local appelé GooglePlacesDemos.xcconfig pour votre clé API, dans le même répertoire que le fichier Info.plist de l'application de démonstration (GooglePlacesDemos/GooglePlacesDemos).

    Ajoutez deux lignes à votre fichier de configuration pour définir vos clés API :

    PLACES_API_KEY = YOUR_PLACES_API_KEY et MAPS_API_KEY = YOUR_MAPS_API_KEY.

    Remplacez YOUR_PLACES_API_KEY et YOUR_MAPS_API_KEY par les clés API des étapes précédentes.

    Pour obtenir de l'aide sur la création d'un fichier de configuration local, consultez Format du fichier de paramètres de configuration (xcconfig).

    Swift

    Modifiez le fichier SDKDemoAPIKey et collez votre clé API dans la constante appropriée. Exemple :

    let placesAPIKey = "YOUR_API_KEY"

    Le cas échéant, supprimez la ligne suivante :

    #error (Register for API Key and insert here. Then delete this line.)

    Si Xcode vous invite à déverrouiller le fichier SDKDemoAPIKey pour le modifier, sélectionnez Déverrouiller.

    Objective-C

    Modifiez le fichier SDKDemoAPIKey et collez votre clé API dans la constante appropriée. Exemple :

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Le cas échéant, supprimez la ligne suivante :

    #error (Register for API Key and insert here. Then delete this line.)

    Si Xcode vous invite à déverrouiller le fichier SDKDemoAPIKey pour le modifier, sélectionnez Déverrouiller.

  7. Créez l'application.
  8. 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 d'avoir fourni les clés requises dans les instructions ci-dessus.
  9. Si vous exécutez l'application exemple, la fenêtre du simulateur iOS affiche une liste de démonstrations Places.
  10. Si vous êtes invité à autoriser l'application de démonstration à accéder à votre position, sélectionnez Autoriser.
  11. L'échantillon choisi peut désormais être lancé.