Essayer la démo

En intégrant le SDK Navigation pour Android, votre application peut aller au-delà de l'association à une vue de carte externe. Avec la navigation Google Maps, votre application peut proposer une récupération dynamique et des rapports en un coup d'œil sur les données du parcours 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.

  • 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 Utiliser des clés API.
  • Artefact du SDK. Assurez-vous 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 le développement Android et les concepts de programmation orientée objet. Il est également recommandé de connaître Google Maps du point de vue de l'utilisateur.

Obtenir les applications de démonstration

Google propose 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émo GoogleNavigation. Les développeurs qui ne connaissent pas les deux projets trouveront les deux applications utiles.

À partir de la version 4.1 du SDK Navigation pour Android, les applications de démonstration suivantes sont disponibles en téléchargement sur GitHub.

  • Démonstration de GoogleNavigation: présente l'intégration des comportements et des vues de l'API dans le contexte de l'expérience utilisateur lors d'une session de navigation guidée.

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

Démonstration de GoogleNavigation

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

Bâtiment

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

  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 (Compilation), puis examinez les détails de l'implémentation du SDK.

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

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

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

Consultez la documentation du plug-in Secrets Gradle pour en savoir plus sur la manière dont la clé API est ajoutée au fichier manifeste.

Running

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

    • Appareil Android : consultez les 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 le gestionnaire d'appareils virtuels Android (AVD) 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 compilée et lancée, l'application présente à l'utilisateur une page de destination avec une liste d'options.

Les nouveaux utilisateurs du NavSDK 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.

Lorsque vous cliquez sur l'une de ces options, les informations suivantes s'affichent :

  • l'UI 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
  • menu à développer avec plus d'options

Pour commencer, cliquez sur 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 contrôle pour voir ce qui se passe lorsque vous appelez une API. Par exemple, vous pouvez cliquer sur Afficher les méthodes pour essayer de forcer le SDK en mode Nuit afin de voir à quoi il ressemble.

Option SwappingMapAndNavActivity

SwappingMapAndNavActivity présente les modèles courants suivants :

Démo GoogleMap

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

Bâtiment

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

  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 (Compilation), puis examinez les détails de l'implémentation du SDK.

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

    • Dans le fichier XML de mise en page, 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 la manière dont la clé API est ajoutée au fichier manifeste, consultez la section Plug-in Secrets Gradle.

Running

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

    • Appareil Android : consultez les 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 AVD (Android Virtual Device) Manager pour configurer un appareil virtuel. Lorsque vous choisissez un émulateur, veillez à 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.

Lors de sa compilation et de son lancement, l'application présente à l'utilisateur une page de destination d'une liste de démonstrations.

Les utilisateurs des versions de démonstration du SDK Google Maps doivent bien connaître ce modèle de présentation et la structure correspondante du code source. En effet, la démonstration GoogleMap est conçue pour ressembler à 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.

Google encourage généralement les utilisateurs à utiliser 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 un MapView dans les cas où vous utilisez une bibliothèque tierce qui s'attend à interagir avec cette classe.