Commencer

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 et explique comment intégrer le SDK Navigation et exécuter l'application de démonstration fournie avec le SDK.

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

Avant tout

Pour commencer à utiliser le SDK Navigation pour Android, 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.

    • Fichier ZIP contenant les éléments suivants:

      • Le fichier de bibliothèque statique .aar dans le répertoire libs/ contenant le SDK Navigation en tant que bundle.
      • Fichiers texte pour les licences et liens vers les conditions d'utilisation et les accords
      • Une application de démonstration à importer en tant que nouveau projet dans Android Studio. Fichiers de l'application permettant de créer l'application de démonstration dans Android Studio à l'aide de Gradle et de Maven.

  • 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 le SDK, l'application de démonstration et la documentation

Après avoir téléchargé et décompressé le fichier du SDK, vous pouvez examiner et exécuter l'application de démonstration.

L'application de démonstration fournit un build qui implémente une classe NavigationFragment et une variante qui implémente une classe NavigationView. La variante NavigationFragment s'exécute par défaut et affiche un chemin de navigation, comme illustré dans l'image suivante.

  1. À l'aide de votre gestionnaire de fichiers préféré, accédez au répertoire contenant les fichiers du SDK.

  2. Copiez la bibliothèque du SDK Navigation dans le répertoire app/libs du projet demo:

    Par exemple, vous pouvez exécuter cp libs/*.aar demo/app/libs dans votre terminal Linux.

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

  4. Ouvrez le fichier AndroidManifest.xml de l'application et mettez à jour la valeur de la propriété API_KEY:

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/_AppTheme" >

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
    </application>
</manifest>

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

Exécuter l'application

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

  3. Dans l'application Navigation Demo (Démonstration de navigation), choisissez Set Destination (Définir la destination), puis suivez les invites pour sélectionner un lieu et démarrer la navigation simulée.

Créer la variante de vue

L'application de démonstration inclut une variante View.

  1. Dans Android Studio, ouvrez l'application de démonstration et cliquez sur l'onglet "Build Variants" (Variantes de compilation) de la fenêtre de compilation.

  2. Dans la fenêtre Build Variants (Variantes de compilation), sélectionnez viewDebug pour modifier la liste des fichiers.

  3. Examinez les détails de l'implémentation du SDK pour la classe NavigationView.

    • Dans NavViewActivity.java, notez le code d'implémentation.

    • Dans Activity_Nav_View.xml, notez la mise en page et le texte.

  4. Compilez et exécutez l'application. Le nom de l'application change pour indiquer la version compilée. Sinon, seul l'objet de rendu est différent.

Étape suivante

Intégrez le SDK Navigation pour Android à votre propre application.