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 kann Ihre App Daten zum Kaufprozess eines Nutzers dynamisch abrufen und in einem einzigen Bericht zusammenfassen. In diesem Leitfaden wird erläutert, wie die Navigation SDK-Demo-Apps ausgeführt werden, 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. Ihr Projekt muss so konfiguriert sein, dass Maven für das Navigation 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.

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 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 neu bei beiden Projekten sind, werden beide Apps hilfreich sein.

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

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

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.

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

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.

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

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.
   • 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 Ausführen (oder das Wiedergabesymbol) und wählen Sie 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 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.

Hinweis: In den meisten Fällen empfehlen wir, SupportNavigationFragment zu verwenden, einen Wrapper für NavigationView, anstatt direkt mit NavigationView zu interagieren. Weitere Informationen finden Sie unter Best Practices für die Interaktion mit Navigationskarten.

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 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. Über das Overlay der Steuerelemente 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“

Hinweis: Diese Option vereinfacht die Umstellung von v1 auf v4. Wir empfehlen nach Möglichkeit die ausschließliche Verwendung von NavigationView. Hier sehen Sie jedoch ein Beispiel dafür, wie beide Tools zusammen verwendet werden können.

SwappingMapAndNavActivity zeigt die folgenden gängigen Muster:

• MapView wird angezeigt
• Wechsel zu einer NavigationView, wenn die Navigation beginnt
• Rückkehr zu einem MapView, wenn die Navigation endet

GoogleMap-Demo

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

Hinweis: Weitere Informationen zur Interaktion mit dem GoogleMap-Objekt in der Anwendung finden Sie unter Best Practices für die GoogleMap-Interaktion.

Gebäude

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

   Hinweis: Die Karte wird erst geladen, wenn Sie „local.defaults.properties“ mit dem bereitgestellten API-Schlüssel aktualisiert haben.

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.

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

Laufen

1. Verbinde ein Android-Gerät mit deinem Computer oder verwende 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 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 dem Erstellen und Starten 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 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 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 in Situationen, in denen Sie eine Drittanbieterbibliothek verwenden, die mit dieser Klasse interagieren soll, immer noch erforderlich sein, eine MapView zu verwenden.

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 müssen Sie warten, bis eine neuere Version automatisch heruntergeladen wird, oder die Play-Dienste manuell über den Google Play Store aktualisieren.