Demo ansehen

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 wird ein Android Studio-Projekt vorgestellt. Außerdem erfährst du, wie du das Navigation SDK integrieren kannst und wie du die Demo-Apps ausführst.

Das Navigation SDK ist eine statische Bibliothek, 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

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

Hinweis: Der Zugriff auf das Navigation SDK wird über eine Arbeitsbereichsgruppe gesteuert. Weitere Informationen findest du unter Zugriff erhalten.

Für die Nutzung des Navigation SDK 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.
  • Das SDK-Artefakt. Ihr Projekt muss für die Verwendung von Maven für das Navigation SDK konfiguriert sein.
  • Für Projekte mit Version 4.99.0 und älter. Wenn Sie Maven nicht verwenden können, können Sie das ZIP-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.
  • 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 sich mit der Android-Entwicklung und objektorientierten Programmierungskonzepten auskennen. Außerdem sollten Sie mit Google Maps aus Sicht der Nutzenden vertraut sein.

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 nach Ihrer Erfahrung. Entwickler, die mit den Google Maps APIs vertraut sind, können sich auf die GoogleNavigation-Demo konzentrieren. Für Entwickler, die neu in beiden Projekten sind, werden beide Apps nützlich sein.

Ab Version 4.1 des Navigation SDK for Android stehen beide im freigegebenen Google Drive die folgenden Demo-Apps zum Download zur Verfügung.

• GoogleNavigation-Demo: Zeigt die Einbindung von API-Verhaltensweisen und -Ansichten im Hinblick auf die Nutzererfahrung während einer geführten Navigation.

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

Hinweis zur Verwendung von Maven

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

Hinweis: Wenn Sie ab Version 4.99.0 das AAR-Rohpaket 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 AAE-Abhängigkeit in Ihrer build.gradle auf App-Ebene deklarieren: api(name: 'google_navigation', ext: 'aar')

Die GoogleNavigation-Demo

Die neueste GoogleNavigation-Demo ist im Stammverzeichnis von freigegebenem Google Drive verfügbar. Frühere Versionen der App sind im „Archiv“ vorhanden. Bei Versionen vor 4.1 ist die Anwendung neben dem AAR in derselben ZIP-Datei gebündelt.

Gebäude

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

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

2. Öffnen Sie local.defaults.properties und aktualisieren Sie den Wert der Property 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 in der Java-Klasse den Implementierungscode.

   • 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 zum Manifest hinzugefügt wird, finden Sie in der Dokumentation zum Secrets Gradle-Plug-in.

Läuft

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

   • Android-Gerät: Lies die 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 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 ein Bereitstellungsziel aus.

Wenn die App erstellt und gestartet wurde, 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, die NavigationView in Verbindung mit Navigator verwenden.

Option 2: Mit der zweiten Option (NavFragmentActivity) werden Verhaltensweisen veranschaulicht, die SupportNavigationFragment zusammen mit Navigator verwenden.

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

• der Navigations-UI
• Die Schaltfläche „Ziel festlegen“ im Menü der App
• Ein Overlay, mit dem Sie interagieren können, um Methoden in der API dynamisch aufzurufen
• 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. Mithilfe des Steuerfeld-Overlays können Sie sehen, was beim Aufruf einer API passiert. Sie können beispielsweise auf Ansichtsmethoden klicken, um das SDK in den Nachtmodus zu versetzen, um zu sehen, wie dies aussieht.

Option SwappingMapAndNavActivity

Hinweis: Diese Option unterstützt Sie bei der Umstellung von Version 1 auf Version 4. Wir empfehlen, nach Möglichkeit ausschließlich NavigationView zu verwenden. Dies soll aber ein Beispiel dafür sein, wie die Hand in Hand funktioniert.

SwappingMapAndNavActivity weist die folgenden gängigen Muster auf:

• Darstellung von MapView
• zu einem NavigationView wechseln, wenn die Navigation beginnt,
• und zu einem MapView zurückkehren, wenn die Navigation endet.

GoogleMap-Demo

Hinweis :Diese App ist für SDK-Versionen vor Version 4.1 nicht verfügbar.

Die neueste GoogleNavigation-Demo ist im Stammverzeichnis von freigegebenem Google Drive verfügbar. Frühere Versionen der App sind im „Archiv“ vorhanden.

Gebäude

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

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

2. Öffnen Sie local.defaults.properties und aktualisieren Sie den Wert der Property 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 in der Java-Klasse den Implementierungscode.

   • 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 unter Secrets Gradle-Plug-in.

Läuft

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

   • Android-Gerät: In der instructions erfahren Sie, wie Sie Entwickleroptionen auf Ihrem Android-Gerät aktivieren und Ihr System so 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 sollten Sie ein Image angeben, das die Google APIs enthält.

2. Klicken Sie in Android Studio auf die Menüoption Run (Ausführen) oder das Wiedergabesymbol. Wählen Sie dann ein Bereitstellungsziel aus.

Wenn die App erstellt und gestartet wurde, 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 Nutzer in der Navigation SDK-Demo auswählen können, für welche Ansichtsklasse sie die Demo testen möchten: NavigationView oder MapView.

Google empfiehlt Nutzern im Allgemeinen, NavigationView zu verwenden. In dieser Demo können Sie diese Verhaltensweisen in beiden Versionen der Demo-App flexibel ausprobieren und diejenige auswählen, die für Sie am besten geeignet ist. Es kann beispielsweise in Situationen erforderlich sein, in denen Sie eine Drittanbieterbibliothek verwenden, die mit dieser Klasse interagieren möchte.MapView

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