Lorsque vous aurez activé la facturation et créé une clé API, vous pourrez configurer le projet Xcode qui vous servira à développer votre application.
Des notes de version sont disponibles pour chaque version.
Étape 1 : Installez le logiciel requis
Pour créer un projet à l'aide du SDK Places pour iOS, vous devez disposer des éléments suivants :
- Xcode version 26.0 ou ultérieure
Étape 2 : Créez le projet Xcode et installez le SDK Places pour iOS
Swift Package Manager
Le SDK Places pour iOS peut être installé via Swift Package Manager. Pour ajouter le SDK, assurez-vous d'avoir supprimé toutes les dépendances existantes du SDK Places pour iOS.
Pour ajouter le SDK à un projet nouveau ou existant, procédez comme suit :
-
Ouvrez votre fichier
projectouworkspaceXcode, puis accédez à File > Add Package Dependencies (Fichier > Ajouter des dépendances de package). - Saisissez https://github.com/googlemaps/ios-places-sdk comme URL, appuyez sur Entrée pour extraire le package, puis cliquez sur "Add Package" (Ajouter un package).
-
Pour installer une version spécifique de
version, définissez le champ Règle de dépendance sur l'une des options basées sur la version. Pour les nouveaux projets, nous vous recommandons de spécifier la dernière version et d'utiliser l'option "Version exacte". Une fois l'opération terminée, cliquez sur "Ajouter un package". - Dans la fenêtre Choisir les produits du package, vérifiez que
GooglePlaces,GooglePlacesSwiftou les deux seront ajoutés à votre cible principale désignée. Une fois l'opération terminée, cliquez sur Add Package (Ajouter un package).Si vous mettez à jour Google Places Swift à partir de l'URL GitHub obsolète
Important : L'URL GitHub permettant d'accéder à Google Places Swift a changé à partir de la version 0.3.0. Si vous mettez à jour une version de GooglePlacesSwift accessible via l'ancienne URL,
https://github.com/googlemaps/ios-places-swift-sdk, supprimez-la de la section des dépendances de package de Xcode. - Pour vérifier votre installation, accédez au volet General (Général) de votre cible. Dans Frameworks, Libraries, and Embedded Content (Frameworks, bibliothèques et contenu intégré), vous devriez voir les packages installés. Vous pouvez également consulter la section Package Dependencies (Dépendances du package) de Project Navigator (Navigateur de projet) pour vérifier le package et sa version.
Pour mettre à jour le package d'un projet existant, procédez comme suit :
-
Dans Xcode, accédez à File > Packages > Update To Latest Package Versions (Fichier > Packages > Mettre à jour vers les dernières versions des packages).
Si vous mettez à jour Google Places Swift à partir de l'URL GitHub obsolète
Important : L'URL GitHub permettant d'accéder à Google Places Swift a changé à partir de la version 0.3.0. Si vous mettez à jour une version de GooglePlacesSwift accessible via l'ancienne URL,
https://github.com/googlemaps/ios-places-swift-sdk, supprimez-la de la section des dépendances de package de Xcode. - Pour vérifier votre installation, accédez à la section Package Dependencies (Dépendances du package) de Project Navigator (Navigateur de projet) pour vérifier le package et sa version.
Pour supprimer le SDK Places pour iOS installé manuellement, procédez comme suit :
-
Dans les paramètres de configuration de votre projet Xcode, recherchez Frameworks, Libraries, and Embedded Content (Frameworks, bibliothèques et contenu intégré). Utilisez le signe moins (-) pour supprimer les frameworks suivants :
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
Dans le répertoire racine de votre projet Xcode, supprimez le bundle
GooglePlaces.
Installation manuelle
Ce guide explique comment ajouter manuellement les XCFrameworks contenant le SDK Places pour iOS et le SDK Places Swift pour iOS à votre projet, et comment configurer vos paramètres de compilation dans Xcode. Un XCFramework est un package binaire que vous pouvez utiliser sur plusieurs plates-formes, y compris les machines utilisant Apple Silicon. Vous pouvez choisir d'ajouter le SDK Places pour iOS, le SDK Places Swift pour iOS ou les deux.
- Téléchargez les fichiers binaires et de ressources du SDK suivants :
- Si vous installez le SDK Places Swift pour iOS, installez les fichiers suivants :
- Extrayez les fichiers pour accéder au XCFramework et aux ressources.
- Lancez Xcode et ouvrez un projet existant ou créez-en un. Si vous débutez dans le développement iOS, créez un projet et sélectionnez le modèle d'application iOS.
- Supprimez tous les groupes Maps des précédentes versions de votre projet.
-
Ouvrez l'onglet Général. Faites glisser le fichier XCFramework suivant dans votre projet sous Frameworks, Libraries, and Embedded Content (Frameworks, bibliothèques et contenu intégré). Veillez à sélectionner Do Not Embed (Ne pas intégrer) :
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
Copiez le fichier
GooglePlaces.bundledu dossier GooglePlacesResources que vous avez téléchargé dans le répertoire de premier niveau de votre projet Xcode. Veillez à sélectionner Copier les éléments dans le dossier du groupe de destination lorsque vous y êtes invité.
Si vous installez le SDK Places pour Swift, copiez le fichierGooglePlacesSwift.bundledu dossier GooglePlacesSwiftResources que vous avez téléchargé dans le répertoire de premier niveau de votre projet Xcode. Veillez à sélectionner Copier les éléments dans le dossier du groupe de destination lorsque vous y êtes invité. - Sélectionnez votre projet dans le navigateur de projets, puis choisissez la cible de votre application.
-
Ouvrez l'onglet Build Phases (Phases de compilation). Dans Link Binary with Libraries (Associer le binaire aux bibliothèques), ajoutez les frameworks et bibliothèques suivants :
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
Choisissez votre projet plutôt qu'une cible spécifique, puis ouvrez l'onglet Build Settings (Paramètres de compilation). Dans la section Linking - General -> Other Linker Flags (Liaison - Général -> Autres options de l'éditeur de liens), ajoutez
-ObjCà "Debug" (Débogage) et "Release" (Version). Si ces paramètres ne sont pas visibles, remplacez le filtre Basic (De base) par All (Tous) dans la barre Build Settings (Paramètres de compilation).
Étape 3 : Ajoutez la clé API à votre application
Dans les exemples suivants, remplacez YOUR_API_KEY par votre clé API.
Ajoutez votre clé API à votre fichier AppDelegate.swift comme suit :
- Ajoutez la déclaration d'importation suivante :
import GooglePlacesSwift
- Ajoutez le code suivant à votre méthode
application(_:didFinishLaunchingWithOptions:), en remplaçant YOUR_API_KEY par votre clé API :PlacesClient.provideAPIKey("YOUR_API_KEY")
Swift
Ajoutez votre clé API à votre fichier AppDelegate.swift comme suit :
- Ajoutez la déclaration d'importation suivante :
import GooglePlaces
- Ajoutez le code suivant à votre méthode
application(_:didFinishLaunchingWithOptions:), en remplaçant YOUR_API_KEY par votre clé API :GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
Objective-C
Ajoutez votre clé API à votre fichier AppDelegate.m comme suit :
- Ajoutez la déclaration d'importation suivante :
@import GooglePlaces;
- Ajoutez le code suivant à votre méthode
application:didFinishLaunchingWithOptions:, en remplaçant YOUR_API_KEY par votre clé API :[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
Étape 4 (facultative) : Inspectez le fichier manifeste de confidentialité Apple
Apple exige des informations sur la confidentialité des applications sur l'App Store. Pour en savoir plus, consultez la page Informations sur la confidentialité des données de l'App Store d'Apple.
Le fichier manifeste de confidentialité Apple est inclus dans le bundle de ressources du SDK. Pour vérifier que le fichier Privacy Manifest a été inclus et inspecter son contenu, créez une archive de votre application et générez un rapport de confidentialité à partir de l'archive.
Étapes suivantes
- Commencez à rédiger du code. Nous vous recommandons de commencer par implémenter une application de démarrage qui obtient le lieu actuel de l'utilisateur.
- Une fois votre projet configuré, vous pouvez explorer les exemples d'applications.
- Utilisez App Check pour sécuriser votre clé API.