Erste Schritte

Wenn Sie das Navigation SDK for Android einbinden, können Sie in Ihrer App nicht nur Links zu externen Kartenansichten erstellen. Mit der Google Maps-Navigation können Sie in Ihrer App die Daten zur Fahrt dynamisch abrufen und Berichte in einer einzigen Ansicht erstellen.

In diesem Leitfaden erfahren Sie, wie Sie ein Android Studio-Projekt erstellen, das Navigation SDK einbinden und die mit dem SDK gelieferte Demo-App ausführen.

Das Navigation SDK ist eine statische Bibliothek (.aar), mit der Sie die Darstellung und den Ton für die Navigation in Ihrer App steuern können. Weitere Informationen zur Bibliothek finden Sie in einem separaten Fenster unter Navigation SDK-Referenz (Javadoc).

Vorbereitung

Für die Nutzung des Navigation SDK for Android benötigen Sie Folgendes:

• Einen Google Maps Platform-Ansprechpartner für den Zugriff auf Folgendes:

  • Ein API-Schlüssel, der für die Verwendung mit dem Navigation SDK bereitgestellt wird. Sie müssen Ihre Projekt-ID angeben, die Sie im Hauptdashboard der Google Cloud Console unter dem Projektnamen finden.

  • Die ZIP-Datei, die Folgendes enthält:

    • Die statische Bibliotheksdatei .aar im Verzeichnis libs/, die das Navigation SDK als aar-Bundle enthält.
    • Textdateien für die Lizenzierung und Links zu Nutzungsbedingungen und Vereinbarungen.
    • Eine Demo-App zum Importieren als neues Projekt in Android Studio. Die Dateien der App zum Erstellen der Demo-App in Android Studio mit Gradle und Maven.

• Android Studio, die empfohlene Entwicklungsumgebung zum Erstellen einer App mit dem Navigation SDK Diese Dokumentation richtet sich an Personen, die sich mit der Android-Entwicklung und objektorientierten Programmierungskonzepten auskennen. Außerdem sollten Sie mit Google Maps aus Sicht des Nutzers vertraut sein.

SDK, Demo-App und Dokumentation herunterladen

Nachdem Sie die SDK-Datei heruntergeladen und entpackt haben, können Sie sich die Demo-App genauer ansehen und sie ausführen.

Die Demo-App bietet einen Build, der eine NavigationFragment-Klasse und eine Variante implementiert, die eine NavigationView-Klasse implementiert. Die Variante NavigationFragment wird standardmäßig ausgeführt und zeigt einen Navigationspfad an, wie in der folgenden Abbildung dargestellt.

1. Wechseln Sie mit Ihrem bevorzugten Dateimanager zum Verzeichnis mit den SDK-Dateien.

2. Kopieren Sie die Navigation SDK-Bibliothek in das Verzeichnis app/libs des Projekts demo:

   Sie können beispielsweise cp libs/*.aar demo/app/libs in Ihrem Linux-Terminal ausführen.

3. Importiere in Android Studio die Demo-App und erlaube die Ausführung von Gradle.

   Hinweis: Der App-Build schlägt fehl, bis Sie das Manifest der App mit dem bereitgestellten API-Schlüssel aktualisieren.

4. Öffnen Sie das AndroidManifest.xml der App und aktualisieren Sie den Wert der API_KEY-Property:

   <?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. Klicken Sie auf Erstellen und sehen Sie sich die Details zur SDK-Implementierung an.

   • Notieren Sie sich in der Java-Klasse den Implementierungscode.

   • Notieren Sie sich im Layout-XML das Layout-Design und den Text.

   • Beachten Sie in der Datei build.gradle das SDK in den Abhängigkeiten.

Anwendung ausführen

1. Verbinden Sie ein Android-Gerät mit Ihrem Computer oder verwenden Sie einen Emulator.

   • Android-Gerät: instructions, um Entwickleroptionen auf deinem Android-Gerät zu aktivieren und dein System so zu konfigurieren, dass das Gerät erkannt wird.
   • Emulator: Verwenden Sie Android Virtual Device (AVD) Manager, um ein virtuelles Gerät zu konfigurieren. Beim Auswählen eines Emulators müssen Sie ein Image angeben, das die Google-APIs enthält.

2. Klicken Sie in Android Studio auf die Menüoption Run (oder das Wiedergabesymbol) und wählen Sie ein Bereitstellungsziel aus.

3. Wählen Sie in der Navigation Demo-App die Option Ziel festlegen aus und folgen Sie dann den Anweisungen, um einen Standort auszuwählen und die simulierte Navigation zu starten.

Datenansichtsvariante erstellen

Die Demo-App enthält eine „View“-Variante.

1. Öffnen Sie in Android Studio die Demo-App und klicken Sie im Fenster „Build“ auf den Tab „Build Variants“ (Varianten erstellen).

   Hinweis: Der Tab Variante wird vertikal ganz links im Build-Fenster angezeigt.

2. Wählen Sie im Fenster Varianten erstellen die Option viewDebug aus, um die Dateiliste zu ändern.

3. Sehen Sie sich die Details zur SDK-Implementierung für die Klasse NavigationView an.

   • Notieren Sie sich den Implementierungscode in NavViewActivity.java.

   • Notieren Sie sich in Activity_Nav_View.xml das Layoutdesign und den Text.

4. Erstellen Sie die App und führen Sie sie aus. Der App-Name ändert sich, um anzugeben, welche Version erstellt wurde. Andernfalls unterscheidet sich nur das Renderingobjekt.

Nächster Schritt

Integrieren Sie das Navigation SDK for Android in Ihre eigene App.