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
Importieren Sie in Android Studio die Demo-App und lassen Sie Gradle ausführen.
Öffnen Sie
local.defaults.properties
und aktualisieren Sie den Wert vonMAPS_API_KEY
Property:MAPS_API_KEY=YOUR_API_KEY
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
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.
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 Demo von GoogleNavigation ist auf GitHub verfügbar.
Gebäude
Importieren Sie in Android Studio die Demo-App und lassen Sie Gradle ausführen.
Öffnen Sie
local.defaults.properties
und aktualisieren Sie den Wert vonMAPS_API_KEY
Property:MAPS_API_KEY=YOUR_API_KEY
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
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.
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. 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.