Demo anzeigen

Durch die Integration des Navigation SDK for Android kann Ihre App mehr als nur eine Verknüpfung zu einer externen Kartenansicht bieten. Mit der Google Maps-Navigation kann Ihre App Daten zur Fahrt eines Nutzers dynamisch abrufen und in einem einzigen Bericht zusammenfassen. In dieser Anleitung wird erklärt, wie Sie die Navigation SDK-Demoanwendungen ausführen, die auf GitHub verfügbar sind.

Vorbereitung

Für die ersten Schritte mit dem Navigation SDK benötigen Sie Folgendes:

• Einen 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. Prüfen Sie, ob Ihr Projekt konfiguriert ist, um Maven für das Navigation SDK zu verwenden.
• Mindestens eine der Demoanwendungen.
• 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. Sie sollten Google Maps auch aus Nutzersicht kennen.

Hinweis: Wenn Ihre App bereits das Maps SDK verwendet, ersetzt das Navigation SDK das Maps SDK sowohl für die Kartenebene als auch für die Navigations funktionen. Sie können das Navigation SDK und das Maps SDK nicht in derselben App verwenden.

Demoanwendungen abrufen

Google bietet zwei Apps, mit denen Sie je nach Kenntnisstand die zusätzlichen Funktionen des Navigation SDK im Vergleich zu den Google Maps APIs kennenlernen können. Entwickler, die mit den Google Maps APIs vertraut sind, können sich auf die GoogleNavigation-Demo konzentrieren. Entwickler, die beide Projekte noch nicht kennen, finden beide Apps hilfreich.

Ab dem Navigation SDK for Android v4.1 sind die folgenden Demoanwendungen beide auf GitHub zum Herunterladen verfügbar.

• GoogleNavigation-Demo: Hier wird die Integration von API-Verhaltensweisen und Ansichten im Hinblick auf die Nutzererfahrung während einer geführten Navigationssitzung veranschaulicht.

• GoogleMap-Demo: Hier werden einzelne Verhaltensweisen der GoogleMap Schnittstelle veranschaulicht, um das Erscheinungsbild von Karten anzupassen.

GoogleNavigation-Demo

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

Build

1. Importieren Sie in Android Studio die Demoanwendung und lassen Sie Gradle ausführen.

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

2. Öffnen Sie local.defaults.properties und aktualisieren Sie den Wert der Eigenschaft MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Klicken Sie auf Build und sehen Sie sich die Details zur SDK-Implementierung an.

   • Beachten Sie in der Java-Klasse den Implementierungscode.

   • Beachten Sie in der XML-Layoutdatei das Layoutdesign und den Text.

   • Beachten Sie in der Datei build.gradle das SDK in den Abhängigkeiten.

Weitere Informationen zum Hinzufügen des API-Schlüssels zum Manifest finden Sie in der Dokumentation zum Secrets Gradle Plugin.

Ausführen

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.
   • Emulator: Verwenden Sie den 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 dann ein Bereitstellungsziel aus.

Nachdem 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 Navigation SDK sind diese beiden Optionen wahrscheinlich am nützlichsten.

Option 1: NavViewActivity veranschaulicht Verhaltensweisen mit NavigationView in Verbindung mit dem Navigator.

Option 2: Die zweite Option mit dem Titel NavFragmentActivity veranschaulicht Verhaltensweisen mit SupportNavigationFragment zusammen mit Navigator.

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

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

• Die Navigationsbenutzeroberfläche
• Eine Schaltfläche „Ziel festlegen“ im Menü der App
• Ein Overlay, mit dem Sie interagieren können, um Methoden dynamisch in der API aufzurufen
• Ein Dreipunkt-Menü mit weiteren Optionen

Klicken Sie zum Starten auf Ziel festlegen und wählen Sie eine Adresse aus. Die App simuliert dann eine Fahrt von Ihrem aktuellen Standort zu dieser Adresse. Im Overlay mit den Steuerfeldern können Sie sehen, was passiert, wenn Sie eine API aufrufen. Klicken Sie beispielsweise auf Methoden ansehen , um zu erzwingen, dass das SDK in den Nachtmodus wechselt, und zu sehen, wie es 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, bieten diese Option aber als Beispiel dafür, wie Sie beide zusammen verwenden können.

Die SwappingMapAndNavActivity veranschaulicht die folgenden gängigen Muster:

• Anzeigen einer MapView
• Wechseln zu einer NavigationView wenn die Navigation beginnt
• Zurückkehren zu einer MapView wenn die Navigation endet

GoogleMap-Demo

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

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

Build

1. Importieren Sie in Android Studio die Demoanwendung und lassen Sie Gradle ausführen.

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

2. Öffnen Sie local.defaults.properties und aktualisieren Sie den Wert der Eigenschaft MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Klicken Sie auf Build und sehen Sie sich die Details zur SDK-Implementierung an.

   • Beachten Sie in der Java-Klasse den Implementierungscode.

   • Beachten Sie in der XML-Layoutdatei das Layoutdesign und den Text.

   • Beachten Sie in der Datei build.gradle das SDK in den Abhängigkeiten.

Weitere Informationen zum Hinzufügen des API-Schlüssels zum Manifest finden Sie unter Secrets Gradle Plugin.

Ausführen

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.
   • Emulator : Verwenden Sie den 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 dann ein Bereitstellungsziel aus.

Nachdem die App erstellt und gestartet wurde, wird dem Nutzer eine Landingpage mit einer Liste von Demos angezeigt.

Dieses Präsentationsmuster und die entsprechende Struktur des Quellcodes sollten Nutzern der Google Maps SDK-Demos bekannt sein. Das liegt daran, dass die GoogleMap-Demo der Maps API-Demo anwendung ähnelt. Der Haupt unterschied besteht darin, dass der Nutzer in der Navigation SDK-Demo auswählen kann, welche Ansichtsklasse er testen möchte: NavigationView oder MapView, sofern zutreffend.

Google empfiehlt Nutzern im Allgemeinen, die NavigationView zu verwenden. Diese Demo bietet die Flexibilität, diese Verhaltensweisen in beiden Versionen in unserer Demoanwendung auszuprobieren und die für Sie passende Version auszuwählen. Es kann beispielsweise weiterhin erforderlich sein, eine MapView zu verwenden, wenn Sie eine Drittanbieterbibliothek verwenden, die mit dieser Klasse interagieren muss.

Wichtig: Für die Klassen MapView, MapFragment und SupportMapFragment muss die Google Play-Dienste-App auf den Geräten installiert sein. Wenn Sie einen neuen Emulator starten oder ein sehr altes Gerät auf die Werkseinstellungen zurücksetzen, ist im Android-Image möglicherweise eine sehr alte Version der 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.