Voir la démo

En intégrant le SDK Navigation pour Android, votre application peut aller au-delà de la simple connexion à une vue de carte externe. Avec la navigation Google Maps, votre application peut proposer la récupération dynamique et la création de rapports sur un seul aperçu des données sur le trajet d'un conducteur.

Ce guide présente un projet Android Studio, explique comment intégrer le SDK Navigation, puis comment exécuter les applications de démonstration.

Le SDK Navigation est une bibliothèque statique qui vous permet de contrôler l'apparence et le son de la navigation dans votre application. Pour en savoir plus sur cette bibliothèque, consultez la documentation de référence du SDK Navigation (Javadoc) dans une fenêtre distincte.

Avant tout

Important :À partir de la version 3.0 du SDK Navigation pour Android, vous pouvez obtenir la dernière version du SDK Navigation pour Android à partir de notre dépôt Maven. Il s'agit désormais de la méthode privilégiée pour obtenir le SDK. Pour en savoir plus, consultez Configurer votre projet.

Remarque :L'accès au SDK Navigation est contrôlé via un groupe d'espace de travail. Pour en savoir plus, consultez Obtenir l'accès.

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

• Un représentant Google Maps Platform pour avoir accès aux éléments suivants:

  • Clé API provisionnée pour être utilisée avec le SDK Navigation. Vous devez indiquer l'ID de votre projet, qui se trouve dans le tableau de bord principal de la console Google Cloud, sous le nom du projet.
  • Artefact du SDK. Assurez-vous que votre projet est configuré pour utiliser Maven pour le SDK Navigation.
  • Pour les projets utilisant la version 4.99.0 ou antérieure Si vous ne pouvez pas utiliser Maven, vous pouvez télécharger l'artefact compressé à partir du Google Drive partagé. Le fichier de bibliothèque statique est le fichier .aar dans le répertoire libs/ contenant le SDK Navigation en tant que bundle.
  • 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 les concepts de développement Android et de programmation orientée objet. Il est également recommandé de connaître Google Maps du point de vue de l'utilisateur.

Télécharger les applications de démonstration

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

Depuis la version 4.1 du SDK Navigation pour Android, les applications de démonstration suivantes sont toutes deux disponibles dans le Drive Google Drive partagé et peuvent être téléchargées.

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

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

Remarque sur l'utilisation de Maven

Les applications de démonstration sont configurées pour télécharger l'artefact SDK à partir du dépôt Maven distant, à l'aide du plug-in Artifact Registry dans Gradle. Veillez à suivre les instructions de configuration du projet pour accéder au SDK.

Remarque :Pour les versions 4.99.0 et antérieures, si vous souhaitez toujours utiliser le bundle AAR brut dans votre projet, vous pouvez l'ajouter à votre projet dans le répertoire libs. Vous devez ensuite supprimer toutes les références au plug-in artifactregistry et au dépôt distant correspondant, puis déclarer la dépendance AAR suivante dans votre build.gradle au niveau de l'application: api(name: 'google_navigation', ext: 'aar')

Démonstration de GoogleNavigation

La dernière version de démonstration de GoogleNavigation est disponible à la racine du Drive Google partagé. Les versions précédentes de l'application existent dans l'archive. Pour les versions antérieures à la version 4.1, l'application est regroupée avec l'AAR dans le même fichier ZIP.

Bâtiment

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 (compiler) et 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 de la mise en page et le texte.

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

Consultez la documentation du plug-in Secrets Gradle pour savoir comment ajouter la clé API au fichier manifeste.

Démarré

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.
   • Emulatormdash;Utilisez l'AVD (Android Virtual Device) Manager pour configurer un appareil virtuel. Lorsque vous choisissez un émulateur, assurez-vous de choisir 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 création et de son lancement, l'application présente à l'utilisateur une page de destination avec une liste d'options.

Options NavViewActivity et NavFragmentActivity

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

Option 1: NavViewActivity présente les comportements utilisant NavigationView conjointement avec Navigator.

Option 2: la deuxième option, intitulée NavFragmentActivity, présente les comportements utilisant SupportNavigationFragment avec Navigator.

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

• 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
• un 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 entre votre position actuelle et cette adresse. Utilisez la superposition des panneaux de configuration pour voir ce qui se passe lorsque vous appelez une API. Par exemple, vous pouvez cliquer sur View Methods (Afficher les méthodes) pour essayer de forcer le SDK en mode Nuit afin d'obtenir un aperçu.

Option SwappingMapAndNavActivity

Remarque :Cette option vous aide à passer de la version 1 à la version 4. Nous vous recommandons d'utiliser NavigationView exclusivement dans la mesure du possible, mais nous vous présentons ici un exemple d'utilisation des deux méthodes.

SwappingMapAndNavActivity présente les modèles courants suivants:

• afficher une MapView
• passage à NavigationView au début de la navigation
• retour à un MapView à la fin de la navigation

Démonstration GoogleMap

Remarque :Cette application n'est pas disponible pour les versions du SDK antérieures à la version 4.1.

La dernière version de démonstration de GoogleNavigation est disponible à la racine du Drive Google partagé. Les versions précédentes de l'application existent dans l'archive.

Bâtiment

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

   Remarque :L'application ne chargera pas la carte tant que vous n'aurez 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 (compiler) et 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 de la mise en page et le texte.

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

Consultez la section Plug-in Secrets Gradle pour en savoir plus sur l'ajout de la clé API au fichier manifeste.

Démarré

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 l'outil AVD (Android Virtual Device) Manager pour configurer un appareil virtuel. Lorsque vous choisissez un émulateur, assurez-vous de choisir 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 création et de son lancement, l'application présente à l'utilisateur une liste de démonstrations.

Les utilisateurs des démonstrations du SDK Google Maps doivent connaître ce schéma de présentation et la structure correspondante du code source. En effet, la démonstration GoogleMap est conçue pour être semblable à l'application de démonstration de l'API Google Maps. La principale différence est que la version de démonstration du SDK Navigation permet à l'utilisateur de choisir la classe de vue sur laquelle il souhaite tester la démo : 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 toujours être nécessaire d'utiliser un 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 des services Google Play soit installée sur les appareils. Si vous lancez un nouvel émulateur ou si vous rétablissez la configuration d'usine d'un appareil très ancien, l'image Android peut être fournie avec un service Google Play très obsolète préinstallé. Dans ce cas, vous devez attendre qu'une version plus récente soit automatiquement extraite ou mettre à jour manuellement les Services Play via le Google Play Store.