Demo anzeigen

Durch die Integration des Navigation SDK for Android kann Ihre App mehr als nur eine Verknüpfung zu einer externen Kartenansicht bieten. Mit der Google Maps-Navigation kann Ihre App dynamische Abrufe und Berichte mit nur einem Blick auf Daten zur Fahrt eines Nutzers ermöglichen. In dieser Anleitung wird beschrieben, wie Sie die Demoanwendungen für das Navigation SDK ausführen, die auf GitHub verfügbar sind.

Vorbereitung

Für den Einstieg in das Navigation SDK benötigen Sie Folgendes:

• Ein API-Schlüssel, der für die Verwendung mit dem Navigation SDK bereitgestellt wurde. Weitere Informationen zum Erstellen und Einschränken von Schlüsseln finden Sie unter API-Schlüssel verwenden.
• Das SDK-Artefakt. Prüfen Sie, ob Ihr Projekt für die Verwendung von Maven für das Navigation SDK konfiguriert ist.
• Mindestens eine der Demo-Apps.
• 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.

Demo-Apps herunterladen

Google bietet zwei Apps an, mit denen Sie je nach Kenntnisstand nachvollziehen können, was das Navigation SDK zusätzlich zu den Google Maps APIs bietet. Entwickler, die mit den Google Maps APIs vertraut sind, können sich auf die GoogleNavigation-Demo konzentrieren. Entwickler, die noch nicht mit beiden Projekten vertraut sind, werden beide Apps hilfreich finden.

Ab Version 4.1 des Navigation SDK for Android sind die folgenden Demo-Apps auf GitHub zum Herunterladen verfügbar.

• GoogleNavigation-Demo: Hier wird die Integration von API-Verhaltensweisen und ‑Ansichten im Zusammenhang mit der Nutzererfahrung während einer Navigationssitzung veranschaulicht.

• GoogleMap-Demo: Hier werden einzelne Verhaltensweisen der GoogleMap-Schnittstelle demonstriert, mit denen sich das Erscheinungsbild von Karten anpassen lässt.

Die GoogleNavigation-Demo

Die aktuelle GoogleNavigation-Demo ist auf GitHub verfügbar.

Build

1. Importieren Sie die Demo-App in Android Studio und lassen Sie Gradle ausführen.

2. Öffnen Sie local.defaults.properties und aktualisieren Sie den Wert des Attributs MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Klicken Sie auf build und sehen Sie sich die Details der SDK-Implementierung an.

   • Sehen Sie sich den Implementierungscode in der Java-Klasse an.

   • Achten Sie im Layout-XML auf das Layoutdesign und den Text.

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

Weitere Informationen dazu, wie der API-Schlüssel dem Manifest hinzugefügt wird, finden Sie in der Dokumentation zum Secrets Gradle-Plug-in.

Ausführen

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

   • Android-Gerät: Folgen Sie dieser Anleitung, um Entwickleroptionen auf Ihrem Android-Gerät zu aktivieren und Ihr System so zu konfigurieren, dass das Gerät erkannt wird.
   • Emulator: Verwenden Sie den AVD Manager für virtuelle Android-Geräte, um ein virtuelles Gerät zu konfigurieren. Beim Auswählen eines Emulators sollten 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 dann ein Bereitstellungsziel aus.

Wenn die App erstellt und gestartet wird, wird dem Nutzer eine Landingpage mit einer Liste von Optionen angezeigt.

Optionen für NavViewActivity und NavFragmentActivity

Für neue Nutzer des NavSDK sind diese beiden Optionen wahrscheinlich am nützlichsten.

Option 1: NavViewActivity zeigt Verhaltensweisen mit dem NavigationView in Verbindung mit dem Navigator.

Option 2: Die zweite Option mit dem Titel NavFragmentActivity zeigt Verhaltensweisen mit dem NavigationFragment zusammen mit dem Navigator.

Wenn Sie auf eine dieser Optionen klicken, wird Folgendes angezeigt:

• Navigations-UI
• eine Schaltfläche „Ziel festlegen“ im Menü der App
• ein Overlay, mit dem Sie interagieren können, um Methoden in der API dynamisch aufzurufen.
• ein Dreipunkt-Menü mit weiteren Optionen

Klicken Sie auf Ziel festlegen und wählen Sie eine Adresse aus. Die App simuliert dann eine Fahrt von Ihrem aktuellen Standort zu dieser Adresse. Mit dem Overlay für die Steuerfelder können Sie sehen, was passiert, wenn Sie eine API aufrufen. Klicken Sie beispielsweise auf View Methods (Methoden ansehen), um das SDK in den Nachtmodus zu zwingen und zu sehen, wie es aussieht.

Option „SwappingMapAndNavActivity“

Im SwappingMapAndNavActivity werden die folgenden gängigen Muster veranschaulicht:

• MapView wird angezeigt
• Beim Starten der Navigation wird auf eine NavigationView umgeschaltet.
• Rückkehr zu einem MapView nach Ende der Navigation

Die GoogleMap-Demo

Die aktuelle GoogleNavigation-Demo ist auf GitHub verfügbar.

Build

1. Importieren Sie die Demo-App in Android Studio und lassen Sie Gradle ausführen.

2. Öffnen Sie local.defaults.properties und aktualisieren Sie den Wert des Attributs MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Klicken Sie auf build und sehen Sie sich die Details der SDK-Implementierung an.

   • Sehen Sie sich den Implementierungscode in der Java-Klasse an.

   • Achten Sie im Layout-XML auf das Layoutdesign und den Text.

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

Weitere Informationen dazu, wie der API-Schlüssel dem Manifest hinzugefügt wird, finden Sie unter Secrets Gradle Plugin.

Ausführen

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

   • Android-Gerät: Folgen Sie dieser Anleitung, um Entwickleroptionen auf Ihrem Android-Gerät zu aktivieren und Ihr System so zu konfigurieren, dass das Gerät erkannt wird.
   • Emulator: Verwenden Sie den AVD Manager für virtuelle Android-Geräte, um ein virtuelles Gerät zu konfigurieren. Beim Auswählen eines Emulators sollten 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 dann ein Bereitstellungsziel aus.

Wenn die App erstellt und gestartet wird, wird dem Nutzer eine Landingpage mit einer Liste von Demos angezeigt.

Dieses Präsentationsmuster und die entsprechende Struktur des Quellcodes sollten Nutzern der Google Maps SDK-Demos vertraut sein. Das liegt daran, dass die GoogleMap-Demo der Maps API-Demo-App ähneln soll. Der Hauptunterschied besteht darin, dass der Nutzer in der Navigation SDK-Demo auswählen kann, mit welcher Ansichtsklasse er eine Demo ausführen möchte: NavigationView oder MapView, sofern zutreffend.

Google empfiehlt im Allgemeinen, die NavigationView zu verwenden. In dieser Demo können Sie diese Verhaltensweisen in beiden Versionen unserer Demo-App ausprobieren und die für Sie passende Version auswählen. Beispielsweise kann es weiterhin erforderlich sein, ein MapView zu verwenden, wenn Sie eine Drittanbieterbibliothek verwenden, die mit dieser Klasse interagieren soll.