L'application de démonstration du SDK Maps pour iOS inclut des exemples illustrant les principales fonctionnalités du SDK. Examinez le code dans l'application de démonstration pour voir comment chaque exemple est implémenté.
Essayer les démonstrations du SDK
L'application de démonstration du SDK Maps pour iOS est disponible en tant qu'archive des téléchargements sur GitHub et en tant que pod CocoaPods. CocoaPods est un gestionnaire de dépendances Open Source pour les projets Cocoa Swift et Objective-C.
Suivez cette procédure pour installer et essayer l'application de démonstration du SDK Maps pour iOS.
- Récupérez les exemples de fichiers à l'aide de l'une des deux méthodes suivantes :
Directement depuis GitHub
- Téléchargez l'exemple d'archive de code depuis GitHub, puis décompressez l'archive.
- 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 Google Maps :
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
- Exécutez les commandes suivantes :
Swift
pod install open GoogleMapsSwiftDemos.xcworkspace
Objective-C
pod install open GoogleMapsDemos.xcworkspace
Utiliser CocoaPods v1.6.1
- Si vous ne disposez pas encore de l'outil CocoaPods, installez la version 1.6.1 sur macOS en exécutant la commande suivante à partir du terminal. Pour en savoir plus, consultez le guide de démarrage de CocoaPods.
sudo gem install cocoapods -v1.6.1
- Récupérez les fichiers Google Maps à l'aide de CocoaPods :
pod try GoogleMaps
Lorsque vous y êtes invité, choisissez entre Swift et Objective-C. CocoaPods met à jour vos dépôts de spécification, puis ouvre la démonstration dans un projet Xcode temporaire nommé
SwiftDemoApp.xcodeproj
ouObjCDemoApp.xcodeproj
.
- Dans Xcode, appuyez sur le bouton de compilation pour compiler, puis exécuter le schéma actuel. La compilation génère une erreur vous invitant à saisir votre clé API dans le fichier
SDKConstants.swift
pour Swift ouSDKDemoAPIKey.h
pour Objective-C. - Si vous ne disposez pas encore d'une clé API, suivez les instructions pour configurer un projet dans Google Cloud Console et obtenir une clé API. Lorsque vous configurez la clé sur Cloud Console, vous pouvez spécifier l'identifiant du bundle 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.GoogleMapsDemos
. - Modifiez le fichier
SDKConstants.swift
pour Swift ou le fichierSDKDemoAPIKey.h
pour Objective-C et collez votre clé API dans la définition de la constanteapiKey
oukAPIKey
. Exemple :Swift
static let apiKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- Supprimez la ligne suivante, car elle sert à enregistrer le problème défini par l'utilisateur:
Swift
#error (Register for API Key and insert here. Then delete this line.”)
Objective-C
#error Register for API Key and insert here.
- Créez et exécutez le projet. La fenêtre du simulateur iOS s'affiche et présente une liste de démonstration du SDK Maps.
- Choisissez l'une des options affichées pour tester une fonctionnalité du SDK Maps pour iOS.
- Si vous êtes invité à autoriser GoogleMapsDemos à accéder à votre position, sélectionnez Autoriser.
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, reportez-vous aux guides sur les objets de carte, les repères, les formes et les autres pages de ce guide.