Demo anzeigen

Wenn Sie das Navigation SDK for Android einbinden, kann Ihre App nicht nur mit einer externen Kartenansicht verknüpft werden. Mit der Google Maps-Navigation kann Ihre App Daten zum Kaufprozess eines Nutzers dynamisch abrufen und in einem einzigen Bericht zusammenfassen. In diesem Leitfaden wird erläutert, wie Sie die Demo-Apps des 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. Achten Sie darauf, dass Ihr Projekt so konfiguriert ist, dass Maven für das Navigations-SDK verwendet wird.
  • Eine oder mehrere der Demo-Apps
  • Android Studio: die empfohlene Entwicklungsumgebung zum Erstellen einer App mit dem Navigation SDK.

Diese Dokumentation richtet sich an Personen, die mit der Android-Entwicklung und objektorientierten Programmierungskonzepten vertraut sind. Außerdem sollten Sie mit Google Maps aus Sicht des Nutzers vertraut sein.

Demo-Apps herunterladen

Google bietet zwei Apps an, mit denen Sie sich je nach Erfahrung mit den Google Maps APIs ein Bild davon machen können, was das Navigation SDK zusätzlich bietet. Entwickler, die mit den Google Maps APIs vertraut sind, können sich auf die GoogleNavigation-Demo konzentrieren. Für Entwickler, die mit beiden Projekten noch nicht vertraut sind, sind beide Apps hilfreich.

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

  • GoogleNavigation-Demo: Hier wird die Integration von API-Verhalten und ‑Ansichten gezeigt, die sich auf die Nutzererfahrung während einer Navigationssitzung beziehen.

  • Google Maps-Demo: Hier werden individuelle Verhaltensweisen der GoogleMap-Oberfläche gezeigt, um das Erscheinungsbild und die Darstellung von Karten anzupassen.

Die GoogleNavigation-Demo

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

Gebäude

  1. Importieren Sie die Demo-App in Android Studio und erlauben Sie die Ausführung von Gradle.

  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 prüfen Sie die Details zur SDK-Implementierung.

    • Achten Sie in der Java-Klasse auf den Implementierungscode.

    • Achten Sie in der Layout-XML-Datei auf das Layoutdesign und den Text.

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

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

Laufen

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

    • Android-Gerät: Folgen Sie der Anleitung, um Entwickleroptionen auf Ihrem Android-Gerät zu aktivieren und Ihr System so zu konfigurieren, dass das Gerät erkannt wird.
    • Emulator: Mit dem Android Virtual Device (AVD) Manager können Sie ein virtuelles Gerät 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 Ausführen (oder das Wiedergabesymbol) und wählen Sie dann ein Bereitstellungsziel aus.

Nach dem Erstellen und Starten der App wird dem Nutzer eine Landingpage mit einer Liste von Optionen angezeigt.

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

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

Option 2: Die zweite Option mit dem Titel NavFragmentActivity zeigt Verhaltensweisen, bei denen die SupportNavigationFragment zusammen mit der Navigator verwendet wird.

Wenn Sie auf eine dieser Optionen klicken, werden folgende Optionen angezeigt:

  • Navigations-UI
  • eine Schaltfläche „Ziel festlegen“ im Menü der App
  • ein Overlay, mit dem du Methoden in der API dynamisch aufrufen kannst
  • ein Dreipunkt-Menü mit weiteren Optionen

Klicken Sie zuerst 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 Steuerfelder können Sie sehen, was passiert, wenn Sie eine API aufrufen. Sie können beispielsweise auf Methoden ansehen klicken, um den Nachtmodus des SDKs zu erzwingen und sich das Ergebnis anzusehen.

Option „SwappingMapAndNavActivity“

Die SwappingMapAndNavActivity zeigt die folgenden gängigen Muster:

Die GoogleMap-Demo

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

Gebäude

  1. Importieren Sie die Demo-App in Android Studio und erlauben Sie die Ausführung von Gradle.

  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 prüfen Sie die Details zur SDK-Implementierung.

    • Achten Sie in der Java-Klasse auf den Implementierungscode.

    • Achten Sie in der Layout-XML-Datei auf das Layoutdesign und den Text.

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

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

Laufen

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

    • Android-Gerät: Folgen Sie der Anleitung, um Entwickleroptionen auf Ihrem Android-Gerät zu aktivieren und Ihr System so zu konfigurieren, dass das Gerät erkannt wird.
    • Emulator: Mit dem Android Virtual Device (AVD) Manager können Sie ein virtuelles Gerät 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 Ausführen (oder das Wiedergabesymbol) und wählen Sie dann ein Bereitstellungsziel aus.

Nach dem Erstellen und Starten der App wird dem Nutzer eine Landingpage mit einer Liste von Demos angezeigt.

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

Google empfiehlt Nutzern im Allgemeinen, NavigationView zu verwenden. In dieser Demo können Sie diese Verhaltensweisen in beiden Versionen unserer Demo-App ausprobieren und die für Sie am besten geeignete auswählen. Beispielsweise kann es in Situationen, in denen Sie eine Drittanbieterbibliothek verwenden, die mit dieser Klasse interagieren soll, immer noch erforderlich sein, eine MapView zu verwenden.