Demo anzeigen

Wenn Sie das Navigation SDK für Android einbinden, kann Ihre App nicht nur mit einer externen Kartenansicht verknüpft werden. Mit der Google Maps-Navigation bietet Ihre App die Möglichkeit, Daten zum Kaufprozess dynamisch und in einem einzigen Look abzurufen. In diesem Leitfaden wird erläutert, wie die Navigation SDK-Demo-Apps ausgeführt werden, die auf GitHub verfügbar sind.

Hinweis :Das Navigation SDK ist derzeit nur für ausgewählte Kunden verfügbar. Das SDK muss aktiviert sein, damit die Demo-App ausgeführt werden kann. Weitere Informationen erhalten Sie von unserem Vertrieb.

Vorbereitung

Wichtig :Ab Version 3.0 des Navigation SDK for Android können Sie die neueste Version des Navigation SDK for Android aus unserem Maven-Repository herunterladen. Dies ist jetzt die bevorzugte Methode zum Abrufen des SDK. Weitere Informationen finden Sie unter Projekt einrichten.

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

• Ein Google Maps Platform-Mitarbeiter, der Zugriff auf Folgendes hat:

  • 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 Haupt-Dashboard der Google Cloud Console unter dem Projektnamen finden.
  • Das SDK-Artefakt. Ihr Projekt muss so konfiguriert sein, dass Maven für das Navigation SDK verwendet wird.
  • Für Projekte mit Version 4.99.0 und niedriger. Wenn Sie Maven nicht verwenden können, können Sie das komprimierte Artefakt aus dem freigegebenen Google Drive herunterladen. Die statische Bibliotheksdatei ist die AAR-Datei im Verzeichnis libs/, die das Navigation SDK als AAR-Bundle enthält.
  • Mindestens eine Demo-App
  • 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.

Hinweis :Wenn in Ihrer App bereits das Maps SDK verwendet wird, ersetzt das Navigation SDK das Maps SDK sowohl für Kartenebenen als auch für Navigationsfunktionen. Das Navigation SDK und das Maps SDK können nicht in derselben App verwendet werden.

Demo-Apps herunterladen

Google stellt zwei Apps zur Verfügung, damit Sie verstehen, was das Navigation SDK zusätzlich zu den Google Maps APIs bietet – je nachdem, wie viel Erfahrung Sie bereits haben. Entwickler, die mit den Google Maps APIs vertraut sind, können sich auf die GoogleNavigation-Demo konzentrieren. Für Entwickler, die neu bei beiden Projekten sind, werden beide Apps hilfreich finden.

Ab Version 4.1 des Navigation SDK for Android stehen die folgenden Demo-Apps auf GitHub zum Download zur Verfügung.

• GoogleNavigation-Demo: Zeigt die Einbindung von API-Verhaltensweisen und -Ansichten in Bezug auf die Nutzererfahrung während einer Sitzung mit geführter Navigation.

• GoogleMap-Demo: Hier werden die einzelnen Verhaltensweisen der GoogleMap-Oberfläche gezeigt, um die Darstellung und Darstellung von Karten anzupassen.

Hinweis zur Verwendung von Maven

Die Demo-Apps sind so konfiguriert, dass das SDK-Artefakt mithilfe des Artifact Registry-Plug-ins in Gradle aus dem Remote-Maven-Repository heruntergeladen wird. Folgen Sie der Anleitung zur Projektkonfiguration, um Zugriff auf das SDK zu erhalten.

Hinweis :Wenn Sie ab Version 4.99.0 das AAR-Roh-Bundle in Ihrem Projekt verwenden möchten, können Sie es Ihrem Projekt im Verzeichnis libs hinzufügen. Anschließend müssen Sie alle Verweise auf das artifactregistry-Plug-in und das entsprechende Remote-Repository entfernen und die folgende AAR-Abhängigkeit in build.gradle auf App-Ebene deklarieren: api(name: 'google_navigation', ext: 'aar')

Die GoogleNavigation-Demo

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

Wird erstellt

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

   Hinweis :Die Karte kann erst geladen werden, wenn Sie local.defaults.properties mit dem bereitgestellten API-Schlüssel aktualisieren.

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

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

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

   • Notieren Sie sich 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.

Läuft

1. Verbinde ein Android-Gerät mit deinem Computer oder verwende einen Emulator.

   • Android-Gerät: Folgen Sie der instructions, um Entwickleroptionen auf Ihrem Android-Gerät zu aktivieren und Ihr System so zu konfigurieren, dass das Gerät erkannt wird.
   • Emulatormdash; Verwenden Sie den 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 dann ein Bereitstellungsziel aus.

Nach der Erstellung und Einführung zeigt die App dem Nutzer eine Landingpage mit einer Liste von Optionen an.

Optionen für NavViewActivity und NavFragmentActivity

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

Option 1: NavViewActivity zeigt Verhaltensweisen mithilfe von NavigationView in Verbindung mit Navigator an.

Option 2: Mit der zweiten Option mit dem Titel NavFragmentActivity werden Verhaltensweisen mithilfe von SupportNavigationFragment und Navigator veranschaulicht.

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

• die Navigations-UI
• Eine Schaltfläche „Ziel festlegen“ im App-Menü
• Ein Overlay, mit dem Sie interagieren können, um dynamisch Methoden in der API aufzurufen
• 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. Über das Overlay der Steuerelemente können Sie sehen, was passiert, wenn Sie eine API aufrufen. Sie können beispielsweise auf View Methods (Methoden anzeigen) klicken, um das SDK in den Nachtmodus zu zwingen und zu sehen, wie es aussieht.

SwappingMapAndNavActivity-Option

Hinweis: Diese Option vereinfacht die Umstellung von v1 auf v4. Wir empfehlen, nach Möglichkeit ausschließlich NavigationView zu verwenden. Wir zeigen dir hier aber, wie du beide Hand in Hand verwenden kannst.

SwappingMapAndNavActivity zeigt die folgenden gängigen Muster:

• Anzeige eines MapView
• Wechsel zu NavigationView, wenn die Navigation beginnt
• Wenn die Navigation beendet ist, kehren Sie zu einem MapView zurück.

GoogleMap-Demo

Hinweis: Diese App ist in älteren SDK-Versionen als Version 4.1 nicht verfügbar.

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

Wird erstellt

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

   Hinweis :Die App kann die Karte erst dann laden, wenn Sie „local.defaults.properties“ mit dem bereitgestellten API-Schlüssel aktualisieren.

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

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

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

   • Notieren Sie sich 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 im Abschnitt zum Gradle-Plug-in für Secrets.

Läuft

1. Verbinde ein Android-Gerät mit deinem Computer oder verwende einen Emulator.

   • Android-Gerät: In der instructions erfährst du, wie du Entwickleroptionen auf deinem Android-Gerät aktivierst und dein System so konfigurierst, dass das Gerät erkannt wird.
   • Emulator: Verwenden Sie den 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 dann ein Bereitstellungsziel aus.

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

Nutzer der Google Maps SDK-Demos sollten dieses Präsentationsmuster und die entsprechende Struktur des Quellcodes kennen. Das liegt daran, dass die GoogleMap-Demo der Maps API-Demo-App ähnelt. Der Hauptunterschied besteht darin, dass der Nutzer in der Navigation SDK-Demo auswählen kann, für welche Ansichtsklasse er eine Demo testen möchte: NavigationView oder MapView (falls zutreffend).

Google empfiehlt Nutzern in der Regel, NavigationView zu verwenden. Diese Demo bietet Ihnen die Flexibilität, diese Verhaltensweisen mit beiden Versionen in unserer Demo-App zu testen und die für Sie am besten geeignete Option auszuwählen. Beispielsweise kann es erforderlich sein, eine MapView zu verwenden, wenn Sie eine Drittanbieterbibliothek verwenden, die eine Interaktion mit dieser Klasse erwartet.

Wichtig :Für die Klassen MapView, MapFragment und SupportMapFragment muss auf den Geräten die Google Play-Dienste-App installiert sein. Wenn du einen neuen Emulator startest oder ein sehr altes Gerät auf die Werkseinstellungen zurücksetzt, sind im Android-Image möglicherweise sehr veraltete Google Play-Dienste vorinstalliert. In solchen Fällen musst du warten, bis automatisch eine neuere Version abgerufen wird, oder die Play-Dienste manuell über den Google Play Store aktualisieren.