Essayer la démo

L'intégration du SDK Navigation pour Android permet à votre application d'aller plus loin vers une vue plan externe. Avec la navigation Google Maps, votre application peut proposer de récupération et de création de rapports de façon centralisée sur le parcours utilisateur. Ce guide explique comment exécuter les applications de démonstration du SDK Navigation, qui sont disponibles sur GitHub.

Préparez-vous

Pour commencer à utiliser le SDK Navigation, assurez-vous d'avoir les éléments suivants.

  • Un représentant Google Maps Platform pour accéder aux éléments suivants:

    • Une clé API provisionnée pour être utilisée avec SDK Navigation. Vous devez fournir votre que vous trouverez 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 et les versions antérieures. Si vous ne pouvez pas utiliser Maven, pouvez télécharger l'artefact compressé depuis le Google Drive partagé. Le fichier de bibliothèque statique est le fichier .aar Répertoire libs/ contenant le SDK Navigation en tant que Lot AAR.
    • Une ou plusieurs applications de démonstration
    • Sur 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 et de programmation orientée objet. Vous devez également connaître Google Présentez la carte du point de vue de l'utilisateur.

Télécharger les applications de démonstration

Google vous propose deux applications pour vous aider à comprendre le SDK Navigation, en plus API Google Maps, en fonction de votre niveau d'expérience. Développeurs connaissant les API Google Maps nous concentrer sur la démo GoogleNavigation. Les développeurs qui ne connaissent pas les deux projets, les deux applications seront utiles.

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

  • Démonstration de GoogleNavigation: présente l'intégration des comportements de l'API et en fonction de l'expérience utilisateur lors d'une navigation guidée .

  • Démonstration GoogleMap: présente les comportements individuels de la 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 fichier Maven distant à l'aide du plug-in Artifact Registry dans Gradle. Veillez à suivre les instructions de configuration du projet. pour accéder au SDK.

Démonstration de GoogleNavigation

La dernière version de 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 modifiez la valeur de 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 et le texte de la mise en page.

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

Consultez la documentation Secrets Gradle plug-in pour en savoir plus sur l'ajout de la clé API 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 pour détecter l'appareil.
    • Emulator (Émulateur) ; Utiliser l'appareil virtuel Android (AVD) Administrateur pour configurer un appareil virtuel. Lorsque vous choisissez un émulateur, assurez-vous choisissez une image qui inclut les API Google.

  2. Dans Android Studio, cliquez sur l'option de menu Run (Exécuter) ou sur le bouton de lecture. icône) ; 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 sous forme de liste de nombreuses options.

Les nouveaux utilisateurs de NavSDK trouveront probablement ces deux options les plus intéressantes utiles.

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

Option 2: La deuxième option, intitulée NavFragmentActivity, présente comportements à l'aide des SupportNavigationFragment en même temps que Navigator

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

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

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

Option SwappingMapAndNavActivity

Le SwappingMapAndNavActivity présente les modèles courants suivants:

Démonstration de GoogleMap

La dernière version de 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 modifiez la valeur de 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 et le texte de la mise en page.

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

Voir les secrets gradle plug-in pour en savoir plus sur l'ajout de la clé API 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 pour détecter l'appareil.
    • Émulateur : utilisez l'appareil virtuel Android (AVD) Administrateur pour configurer un appareil virtuel. Lorsque vous choisissez un émulateur, assurez-vous choisissez une image qui inclut les API Google.

  2. Dans Android Studio, cliquez sur l'option de menu Run (Exécuter) ou sur le bouton de lecture. icône) ; 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 sous forme de liste de démonstrations.

Ce schéma de présentation et la structure correspondante du code source doivent être connues des utilisateurs des versions de démonstration du SDK Google Maps. En effet, La démo GoogleMap a été conçue de façon à ressembler à la démonstration de l'API Google Maps. l'application Nest. L'instance principale La version de démonstration du SDK Navigation permet à l'utilisateur de choisir la classe de vue ils aimeraient tester une démo sur: NavigationView ou MapView, le cas échéant.

Google encourage généralement les utilisateurs à utiliser le NavigationView Cette démonstration offre la flexibilité nécessaire pour tester ces comportements sur les deux versions dans notre application de démonstration et choisissez celle qui vous convient le mieux. Par exemple, il peut toujours être Il est nécessaire d'utiliser un MapView dans les cas où vous faites appel à un tiers qui s'attend à interagir avec cette classe.