Exemple de code du SDK Maps pour iOS

Sélectionnez une plate-forme : Android iOS JavaScript

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.

Dépannage : Si l'application exemple s'exécute correctement, mais qu'aucune carte ne s'affiche, vérifiez que vous avez bien ajouté la clé API au fichier manifeste de l'application, comme décrit dans la section Utiliser des clés API.

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 à télécharger sur GitHub. Suivez ces étapes pour installer et essayer l'application exemple du SDK Maps pour iOS.

1. 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.

2. Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez cloné les fichiers d'exemple, 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

3. 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 fichier SDKDemoAPIKey.h pour Objective-C.
4. 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 de 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.
5. Modifiez le fichier SDKConstants.swift pour Swift ou le fichier SDKDemoAPIKey.h pour Objective-C, puis collez votre clé API dans la définition de la constante apiKey ou kAPIKey. Exemple :

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

6. Dans le fichier SDKConstants.swift (Swift) ou SDKDemoAPIKey.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.

7. Créez et exécutez le projet. La fenêtre du simulateur iOS s'affiche, avec une liste de démonstrations du SDK Maps.
8. Choisissez l'une des options affichées pour tester une fonctionnalité du SDK Maps pour iOS.
9. Si vous êtes invité à autoriser GoogleMapsDemos à accéder à votre position, sélectionnez Autoriser.