Essayer la démo

En intégrant le SDK Navigation pour Android, votre application peut aller au-delà de la simple liaison à une vue cartographique externe. Grâce à la navigation Google Maps, votre application peut proposer une récupération dynamique et un reporting en un coup d'œil des données sur le trajet d'un utilisateur. Ce guide explique comment exécuter les applications de démonstration du SDK Navigation, disponibles sur GitHub.

Préparez-vous

Pour commencer à utiliser le SDK Navigation, assurez-vous de disposer des éléments suivants.

• Une clé API provisionnée pour être utilisée avec le SDK Navigation. Pour en savoir plus sur la création et la restriction de clés, consultez la section Utiliser des clés API.
• L'artefact du SDK. Vérifiez que votre projet est configuré pour utiliser Maven pour le SDK Navigation.
• Une ou plusieurs applications de démonstration.
• Android Studio, l'environnement de développement recommandé pour créer une application avec le SDK Navigation.

Cette documentation s'adresse aux personnes familiarisées avec la programmation Android et les concepts de programmation orientée objet. Vous devez également connaître Google Maps du point de vue de l'utilisateur.

Remarque : Si votre application utilise déjà le SDK Maps, le SDK Navigation remplace le SDK Maps pour les fonctionnalités de calque de carte et de navigation features. Vous ne pouvez pas utiliser le SDK Navigation et le SDK Maps dans la même application.

Obtenir les applications de démonstration

Google fournit deux applications pour vous aider à comprendre ce que le SDK Navigation offre en plus des API Google Maps, en fonction de votre niveau d'expérience. Les développeurs qui connaissent les API Google Maps peuvent se concentrer sur la démonstration GoogleNavigation. Les développeurs qui découvrent les deux projets trouveront les deux applications utiles.

À partir du SDK Navigation pour Android v4.1, les applications de démonstration suivantes sont toutes deux disponibles au téléchargement sur GitHub.

• Démonstration GoogleNavigation : présente l'intégration des comportements et des vues de l'API tels qu'ils se rapportent à l'expérience utilisateur lors d'une session de navigation guidée.

• Démonstration GoogleMap : présente les comportements individuels de l'GoogleMap interface pour personnaliser l'apparence et la présentation des cartes.

Démonstration GoogleNavigation

La dernière démonstration GoogleNavigation est disponible sur GitHub.

Créer

1. Dans Android Studio, importez l'application de démonstration et autorisez l'exécution de Gradle.

   Remarque : L'application ne parvient pas à charger la carte tant que vous n'avez pas mis à jour local.defaults.properties avec la clé API provisionnée.

2. Ouvrez local.defaults.properties et mettez à jour la valeur de la propriété MAPS_API_KEY :

     MAPS_API_KEY=YOUR_API_KEY
   

3. Cliquez sur build (Créer) et examinez les détails d'implémentation du SDK.

   • Dans la classe Java, notez le code d'implémentation.

   • Dans la mise en page XML, notez la conception et le texte de la mise en page.

   • Dans le fichier build.gradle, notez le SDK dans les dépendances.

Pour en savoir plus sur l'ajout de la clé API au fichier manifeste, consultez la documentation du plug-in Secrets Gradle.

Exécuter

1. Connectez un appareil Android à votre ordinateur ou utilisez un émulateur.

   • Appareil Android : reportez-vous aux instructions pour activer les options pour les développeurs sur votre appareil Android et configurer votre système afin qu'il détecte l'appareil.
   • Émulateur : utilisez l'outil AVD (Android Virtual Device) Manager pour configurer un appareil virtuel. Lorsque vous choisissez un émulateur, assurez-vous de sélectionner une image qui inclut les API Google.

2. Dans Android Studio, cliquez sur l'option de menu Run (Exécuter) ou sur l'icône du bouton de lecture , puis choisissez une cible de déploiement.

Une fois l'application créée et lancée, l'utilisateur voit une page de destination contenant une liste d'options.

Options NavViewActivity et NavFragmentActivity

Les nouveaux utilisateurs du SDK Navigation trouveront probablement ces deux options les plus utiles.

Option 1 : NavViewActivity présente les comportements à l'aide de NavigationView en association avec Navigator.

Option 2 : La deuxième option, intitulée NavFragmentActivity, présente les comportements à l'aide de SupportNavigationFragment avec Navigator.

Remarque : Dans la plupart des cas, nous vous recommandons d'utiliser SupportNavigationFragment, qui est un wrapper pour NavigationView, au lieu d'interagir directement avec NavigationView. Pour en savoir plus, consultez Bonnes pratiques d'interaction avec la carte de navigation .

Lorsque vous cliquez sur l'une de ces options, les éléments suivants s'affichent :

• l'interface utilisateur de navigation
• un bouton "Définir la destination" dans le menu de l'application
• une superposition avec laquelle vous pouvez interagir pour appeler dynamiquement des méthodes sur l'API
• un menu à développer proposant d'autres options

Pour commencer, cliquez sur Set Destination (Définir la destination) et choisissez une adresse. L'application simule ensuite un trajet de votre position actuelle à cette adresse. Utilisez la superposition des panneaux de commande pour voir ce qui se passe lorsque vous appelez une API. Par exemple, cliquez sur View Methods (Afficher les méthodes) pour essayer de forcer le SDK à passer en mode nuit et voir à quoi il ressemble.

Option SwappingMapAndNavActivity

Remarque : Cette option vous aide à passer de la version 1 à la version 4. Nous vous encourageons à utiliser NavigationView exclusivement dans la mesure du possible, mais nous vous fournissons cet exemple pour vous montrer comment utiliser les deux en même temps.

SwappingMapAndNavActivity présente les modèles courants suivants :

• affichage d'une MapView
• passage à une NavigationView au début de la navigation
• retour à une MapView à la fin de la navigation

Démonstration GoogleMap

La dernière démonstration GoogleNavigation est disponible sur GitHub.

Remarque : Pour en savoir plus sur l'interaction avec l'objet GoogleMap dans votre application, consultez Bonnes pratiques d'interaction avec GoogleMap.

Créer

1. Dans Android Studio, importez l'application de démonstration et autorisez l'exécution de Gradle.

   Remarque : L'application ne parvient pas à charger la carte tant que vous n'avez pas mis à jour local.defaults.properties avec la clé API provisionnée.

2. Ouvrez local.defaults.properties et mettez à jour la valeur de la propriété MAPS_API_KEY :

     MAPS_API_KEY=YOUR_API_KEY
   

3. Cliquez sur build (Créer) et examinez les détails d'implémentation du SDK.

   • Dans la classe Java, notez le code d'implémentation.

   • Dans la mise en page XML, notez la conception et le texte de la mise en page.

   • Dans le fichier build.gradle, notez le SDK dans les dépendances.

Pour en savoir plus sur l'ajout de la clé API au fichier manifeste, consultez le plug-in Secrets Gradle.

Exécuter

1. Connectez un appareil Android à votre ordinateur ou utilisez un émulateur.

   • Appareil Android : reportez-vous aux instructions pour activer les options pour les développeurs sur votre appareil Android et configurer votre système afin qu'il détecte l'appareil.
   • Émulateur : utilisez l'outil AVD (Android Virtual Device) Manager pour configurer un appareil virtuel. Lorsque vous choisissez un émulateur, assurez-vous de sélectionner une image qui inclut les API Google.

2. Dans Android Studio, cliquez sur l'option de menu Run (Exécuter) ou sur l'icône du bouton de lecture , puis choisissez une cible de déploiement.

Une fois l'application créée et lancée, l'utilisateur voit une page de destination contenant une liste de démonstrations.

Ce modèle de présentation et la structure correspondante du code source devraient être familiers aux utilisateurs des démonstrations du SDK Google Maps. En effet, la démonstration GoogleMap est conçue pour être semblable à l'application de démonstration de l'API Maps. La principale différence est que la démonstration du SDK Navigation permet à l'utilisateur de choisir la classe de vue sur laquelle il souhaite exécuter une démonstration : NavigationView ou MapView, le cas échéant.

En règle générale, Google encourage les utilisateurs à utiliser le NavigationView. Cette démonstration vous permet d'essayer ces comportements sur les deux versions dans notre application de démonstration et de choisir celle qui vous convient le mieux. Par exemple, il peut être nécessaire d'utiliser une MapView dans les cas où vous utilisez une bibliothèque tierce qui s'attend à interagir avec cette classe.

Important : Les classes MapView, MapFragment et SupportMapFragment nécessitent que l'application Services Google Play soit installée sur les appareils. Si vous démarrez un nouvel émulateur ou si vous réinitialisez un appareil très ancien, l'image Android peut être fournie avec une version très obsolète des services Google Play préinstallée. Dans ce cas, vous devrez attendre qu'une version plus récente soit automatiquement extraite ou mettre à jour manuellement les services Play via le Google Play Store.