Le dépôt "Maps SDK for iOS" sur GitHub contient des exemples illustrant l'utilisation du SDK Maps pour iOS dans votre application iOS. L'application exemple contient du code pour les points forts du SDK et peut être utilisée comme point de départ pour votre application.
Liste des exemples du SDK Maps pour iOS
Les principaux exemples d'activités de l'application de démonstration sont listés ci-dessous et reproduits dans les pages liées pour que vous puissiez les retrouver rapidement. Pour obtenir la liste complète des exemples disponibles, consultez le dossier d'exemples GitHub.
- Afficher une carte de base
- Afficher une fenêtre d'informations pour un repère
- Ajouter un repère à une carte
- Géocoder une adresse de manière inversée
- Activer et désactiver les gestes de la carte
- Gérer les événements de repère
- Activer le bouton "Ma position"
- Dessiner des polygones sur une carte
- Tracer des polylignes sur une carte
Exécuter l'application exemple complète en local
L'application exemple du SDK Maps pour iOS est disponible en tant qu'archive de téléchargement sur GitHub. Suivez ces étapes pour installer et essayer l'application exemple du SDK Maps pour iOS.
- Exécutez
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git
pour cloner le dépôt d'exemples dans un répertoire local. Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez cloné les fichiers exemples, puis accédez au répertoire Google Maps:
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
pod install
open GoogleMapsSwiftDemos.xcworkspace
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
pod install
open GoogleMapsDemos.xcworkspace
- Dans Xcode, appuyez sur le bouton de compilation pour créer l'application avec le schéma actuel. La compilation génère une erreur et vous invite à saisir votre clé API dans le fichier
SDKConstants.swift
pour Swift ou le fichierSDKDemoAPIKey.h
pour Objective-C. - Si vous ne disposez pas encore d'une clé API, suivez les instructions pour configurer un projet dans la Google Cloud Console et obtenir une clé API. Lorsque vous configurez la clé dans la console Cloud, vous pouvez la limiter à l'identifiant du bundle de l'application exemple pour vous assurer que seule votre application peut l'utiliser. L'identifiant de bundle par défaut de l'application d'exemples du SDK est
com.example.GoogleMapsDemos
. - Modifiez le fichier
SDKConstants.swift
pour Swift ou le fichierSDKDemoAPIKey.h
pour Objective-C, puis 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";
- Dans le fichier
SDKConstants.swift
(Swift) ouSDKDemoAPIKey.h
(Objective-C), supprimez la ligne suivante, car elle permet d'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, avec une liste de démonstrations 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.