Demo anzeigen

Durch die Integration des Navigations-SDK für Android kann Ihre App mehr als nur Verknüpfungen zu einer externen Kartenansicht wechseln. Mit der Google Maps-Navigation kann Ihre App dynamische Abrufen und Single-Look-Berichte von Daten zur User Journey. Dieser Leitfaden wird erläutert, wie die Demo-Apps des Navigation SDK ausgeführt werden. sind auf GitHub verfügbar.

Vorbereitung

Um das Navigation SDK zu nutzen, benötigen Sie die folgenden Elemente.

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

  • Ein API-Schlüssel, der für die Verwendung mit Navigation SDK Sie müssen Ihre Projekt-ID, die Sie im Haupt-Dashboard der Google Cloud Console finden, unter dem Projektnamen.
  • Das SDK-Artefakt. Ihr Projekt muss konfiguriert sein. um Maven für das Navigation SDK zu verwenden.
  • Für Projekte mit Version 4.99.0 und niedriger. Wenn Sie Maven nicht verwenden können, können das komprimierte Artefakt aus dem freigegebenen Google Drive herunterladen. Die statische Bibliotheksdatei ist die .aar-Datei im Verzeichnis libs/ mit dem Navigation SDK als AAE-Bundle:
  • 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 objektorientierte Programmierung. Außerdem sollten Sie mit Google Karten aus der Perspektive des Nutzers.

Demo-Apps herunterladen

Google stellt zwei Apps zur Verfügung, die Ihnen helfen, Navigation SDK bietet zusätzlich zum Google Maps APIs, je nach Erfahrung. Entwickler, die mit den Google Maps APIs vertraut sind sich auf die GoogleNavigation-Demo konzentrieren. Entwickler, die neu bei beiden sind sind beide Apps hilfreich.

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

• GoogleNavigation-Demo: Zeigt die Einbindung von API-Verhaltensweisen und Ansichten, die sich auf die User Experience im Rahmen einer geführten Navigation Sitzung.

• GoogleMap-Demo: Demonstration einzelner Verhaltensweisen von GoogleMap Benutzeroberfläche, um das Gefühl und die Darstellung von Karten anzupassen.

Hinweis zur Verwendung von Maven

Die Demo-Apps sind so konfiguriert, dass das SDK-Artefakt aus dem Remote-Maven heruntergeladen wird mit dem Artifact Registry-Plug-in in Gradle. Achten Sie darauf, Anleitung zur Projektkonfiguration um Zugriff auf das SDK zu erhalten.

Die GoogleNavigation-Demo

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

Gebäude

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

2. Öffnen Sie local.defaults.properties und aktualisieren Sie den Wert von MAPS_API_KEY Property:

     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 finden Sie im Abschnitt zum Gradle-Gradle-Plug-in für Secrets. Plug-in Dokumentation finden Sie weitere Informationen dazu, wie der API-Schlüssel zum Manifest hinzugefügt wird.

Laufen

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

   • Android-Gerät: Weitere Informationen finden Sie in der Anleitung, um Entwickleroptionen auf deinem Android-Gerät aktivieren und dein System konfigurieren um das Gerät zu erkennen.
   • Emulatormdash; Android Virtual Device (AVD) verwenden Administrator zu ein virtuelles Gerät konfigurieren. Wenn du einen Emulator auswählst, wählen Sie ein Bild aus, das die Google-APIs enthält.

2. Klicken Sie in Android Studio auf die Menüoption Run oder die Wiedergabeschaltfläche. icon); und wählen dann ein Bereitstellungsziel aus.

Nach der Entwicklung und Veröffentlichung der App zeigt die App den Nutzenden die Landingpage einer Liste an. mit verschiedenen Optionen.

Optionen für NavViewActivity und NavFragmentActivity

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

Option 1: NavViewActivity stellt Verhaltensweisen mithilfe von NavigationView dar. in Verbindung mit der Navigator

Option 2: Die zweite Option mit dem Titel NavFragmentActivity Verhaltensweisen mithilfe der SupportNavigationFragment neben dem Navigator

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

• die Navigations-UI
• „Ziel festlegen“ im Menü der App
• Ein Overlay, mit dem Sie interagieren können, um dynamisch Methoden im API
• Ein Dreipunkt-Menü mit weiteren Optionen

Klicken Sie zuerst auf Ziel festlegen und wählen Sie eine Adresse aus. Die App eine Fahrt von Ihrem aktuellen Standort zu dieser Adresse simulieren. Steuerelement verwenden werden eingeblendet, um zu sehen, was passiert, wenn Sie eine API aufrufen. Zum Beispiel können Sie Klicken Sie auf View Methods (Methoden anzeigen), um das SDK in den Nachtmodus zu erzwingen. aussehen.

SwappingMapAndNavActivity-Option

SwappingMapAndNavActivity zeigt die folgenden gängigen Muster:

• Anzeige eines MapView
• wird zu NavigationView gewechselt wenn die Navigation beginnt
• zu einem MapView wenn die Navigation endet

GoogleMap-Demo

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

Gebäude

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

2. Öffnen Sie local.defaults.properties und aktualisieren Sie den Wert von MAPS_API_KEY Property:

     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.

Siehe Gradle geheimen Daten Plug-in finden Sie weitere Informationen dazu, wie der API-Schlüssel zum Manifest hinzugefügt wird.

Laufen

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

   • Android-Gerät Weitere Informationen finden Sie in der Anleitung um Entwickleroptionen auf deinem Android-Gerät zu aktivieren und deine um das Gerät zu erkennen.
   • Emulator: Android Virtual Device (AVD) verwenden Administrator ein virtuelles Gerät konfigurieren. Wenn du einen Emulator auswählst, wählen Sie ein Bild aus, das die Google-APIs enthält.

2. Klicken Sie in Android Studio auf die Menüoption Run oder die Wiedergabeschaltfläche. icon); und wählen dann ein Bereitstellungsziel aus.

Nach der Entwicklung und Veröffentlichung der App wird den Nutzenden die Landingpage einer Liste angezeigt. von Demos.

Dieses Präsentationsmuster und die entsprechende Struktur des Quellcodes sollte den Nutzern der Google Maps SDK-Demos bekannt sein. Das liegt daran, dass der Die GoogleMap-Demo ist ähnlich aufgebaut wie die Maps API-Demoversion. App. Die primäre Der Unterschied besteht darin, dass Nutzer in der Navigation SDK-Demo die Ansichtsklasse auswählen können. die sie gerne testen möchten: NavigationView oder MapView, sofern zutreffend.

Google empfiehlt Nutzern in der Regel, die NavigationView Diese Demo bietet Ihnen die Flexibilität, diese Verhaltensweisen mit beiden Versionen in unsere Demo-App und wählen Sie die für Sie am besten passende aus. Es kann beispielsweise immer noch erforderlich, um MapView in Situationen zu verwenden, in denen Sie einen Drittanbieter die mit diesem Kurs interagieren soll.