Detaillierten Turn Data-Feed aktivieren

Ein Datenfeed mit detaillierter Routenführung bietet nur Navigationsinformationen für Geräte, die nicht für die kartenbasierte Navigation entwickelt wurden. Sie ermöglicht bevorstehende Vorgehensweisen mit den von Ihnen bereitgestellten Elementen:

• Symbole (links, rechts, wenden)
• Nummern in Kreisverkehren abbiegen
• Straßennamen
• geschätzte Entfernungen und die Fahrzeit bis zum nächsten Navigationsschritt oder zum endgültigen Ziel

Mit dem detaillierten Feed können Sie Erlebnisse erstellen, bei denen die vollständige Benutzeroberfläche des Navigation SDK nicht geeignet ist, z. B. für Android Auto oder für kleine Bildschirme, für die kein vollständiger Android-Stack verfügbar ist. Sie können diese Methode beispielsweise für Fahrgäste mit Zweirädern verwenden, bei denen Sie eine nur Navigation bezogene Anleitung so projektieren können, dass sie ihre Ziele schneller und sicherer mit minimaler Ablenkung erreichen.

Um das SDK zu verwenden, erstellen Sie einen Dienst und registrieren ihn beim Navigation SDK for Android, damit er neue Navigationsinformationen in Echtzeit empfangen kann (etwa einmal pro Sekunde während der Navigation).

In diesem Dokument erfahren Sie, wie Sie einen Navigationsdienst erstellen und registrieren, der Navigationsinformationen vom SDK empfängt und dem empfangenden Gerät den Navigationsstatus bereitstellt.

Überblick

In diesem Abschnitt wird beschrieben, wie Sie die TurnByTurn-Bibliothek Ihren Projekten hinzufügen. Außerdem wird der allgemeine Ablauf zum Erstellen von Schritt-für-Schritt-Funktionen zusammengefasst.

Fügen Sie Ihrem Projekt die TurnByTurn-Bibliothek mit Maven hinzu (empfohlen)

Hinweis :Sie können diesen Schritt überspringen, wenn Sie Ihre App bereits mit dem Navigation SDK eingerichtet haben, das selbst die TurnByTurn-Bibliothek enthält.

So verwenden Sie eine eigenständige Version der TurnByTurn-Bibliothek:

1. Richten Sie Ihre Umgebung für den Zugriff auf das Maven-Host-Repository ein, wie unter Erste Schritte mit dem Driver SDK in der Trip and Order-Dokumentation beschrieben.

2. Fügen Sie Ihrer Maven- oder Gradle-Konfiguration die folgende Abhängigkeit hinzu:

   Maven

   <dependencies>
     ...
     <dependency>
       <groupId>com.google.android.maps</groupId>
       <artifactId>google_turnbyturn</artifactId>
       <version>1.0.0</version>
     </dependency>
   </dependencies>
   

   Gradle

   dependencies {
     ...
     implementation 'com.google.android.maps:google_turnbyturn:1.0.0'
   }
   

Fügen Sie Ihrem Projekt die TurnByTurn-Bibliothek mit einer heruntergeladenen JAR-Datei hinzu (alternativ)

Die TurnByTurn-Bibliothek ist als JAR-Datei in diesem SDK-Ordner verfügbar. Wenn Sie keinen Zugriff haben, wenden Sie sich an Ihren Ansprechpartner.

1. Laden Sie google_turnbyturn_*.jar herunter und entpacken Sie die Datei.
2. Kopieren Sie die heruntergeladene JAR-Datei in das Verzeichnis app/libs Ihres Projekts.

3. Fügen Sie Folgendes zu build.gradle hinzu, um die JAR-Datei in Ihren Build aufzunehmen.

   dependencies {
      ...
      api fileTree(include: ['*.jar'], dir: 'libs')
   }
   

TurnByTurn-Bibliothek verwenden

Im Folgenden finden Sie allgemeine Schritte zum Aktivieren der Schritt-für-Schritt-Funktion. Die folgenden Abschnitte enthalten Details zu den einzelnen Schritten.

1. Einen Dienst erstellen, um Navigationsupdates zu erhalten.

2. Registrieren Sie den Dienst.

3. Informationen zu Navigationsstatus

4. Beispiel für eine Navigationsanzeige mit wesentlichen Elementen

Dienst erstellen, um Navigationsupdates zu erhalten {#service}

Das Navigation SDK stellt eine Bindung zu Ihrem TurnByTurn-Dienst her und sendet ihm Navigationsaktualisierungen über den Android Messenger. Sie können für diese Aktualisierungen einen neuen Navigationsdienst erstellen oder einen vorhandenen verwenden.

Der Vorteil der Verwendung eines Dienstes zum Empfangen von Navigationsupdates besteht darin, dass der Dienst in einem separaten Hintergrundprozess ausgeführt werden kann.

Der Dienst im folgenden Beispiel empfängt Navigationsinformationen und konvertiert die Daten mithilfe von TurnByTurnManager in ein NavInfo-Objekt, das die Navigationsdetails enthält.

/**
 *   Receives turn-by-turn navigation information forwarded from NavSDK.
 */
public class NavInfoReceivingService extends Service {
  /** The messenger used by the service to receive nav step updates. */
  private Messenger incomingMessenger;
  private TurnByTurnManager turnByTurnManager;

  private final class IncomingNavStepHandler extends Handler {
    public IncomingNavStepHandler(Looper looper) {
      super(looper);
    }

    @Override
    public void handleMessage(Message msg) {
      // Identify the message through the msg.what field.
      if (TurnByTurnManager.MSG_NAV_INFO == msg.what) {
        // Extract the NavInfo object using the TurnByTurnManager.
        NavInfo navInfo = turnByTurnManager
          .readNavInfoFromBundle(msg.getData()));
      // Do something with the NavInfo
    }
  }
}

@Nullable
@Override
public IBinder onBind(Intent intent) {
  return incomingMessenger.getBinder();
}

@Override
public void onCreate() {
  turnByTurnManager = TurnByTurnManager.createInstance();
  HandlerThread thread =
    new HandlerThread("NavInfoReceivingService",
      Process.THREAD_PRIORITY_DEFAULT);
  thread.start();
  incomingMessenger = new Messenger(
    new IncomingNavStepHandler(thread.getLooper()));
}

Nachrichtencodes

NavInfo-Nachrichten können über das Feld Message.what der Klasse Message identifiziert werden, für das der Wert TurnByTurnManager.MSG_NAV_INFO festgelegt ist.

Hinweis :Lassen Sie für die Nachrichtencodes den Wertebereich 7200–7299 aus, da das Navigation SDK in Zukunft möglicherweise Nachrichtencodes in diesem Bereich verwendet.

Dienst für Navigationsaktualisierungen registrieren {#register}

Mit den folgenden Code-Snippets wird der Navigationsdienst registriert.

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

Dienst starten und beenden

Der Navigationsdienst ist aktiv, solange das Navigation SDK an ihn gebunden wird. Sie können startService() und stopService() manuell aufrufen, um den Lebenszyklus des Navigationsdienstes zu steuern. Wenn Sie Ihren Dienst jedoch mit dem Navigation SDK registrieren, wird er automatisch gestartet und wird nur beendet, wenn Sie die Registrierung aufheben. Je nachdem, wie Sie Ihre App eingerichtet haben, können Sie einen Dienst im Vordergrund starten, wie in der Übersicht der Dienste in der Android-Dokumentation beschrieben.

Dienst abmelden

Wenn Sie keine Navigationsupdates mehr erhalten möchten, heben Sie die Registrierung des Dienstes im Navigation SDK auf.

navigator.unregisterServiceForNavUpdates();

Navigationsstatus verstehen {#states}

Verwenden Sie NavInfo.getNavState(), um den aktuellen Navigationsstatus abzurufen:

• Enroute: Der Status ENROUTE bedeutet, dass die geführte Navigation derzeit aktiv ist und sich der Nutzer auf der angegebenen Route befindet. Es sind Informationen über den aktuell anstehenden Schritt verfügbar.

• Neue Route: REROUTING bedeutet, dass die Navigation zwar noch läuft, in der Navigation aber nach einer neuen Route gesucht wird. Der nächste Schritt für das Manövrieren ist nicht verfügbar, da es noch keine neue Route gibt. In der Beispiel-App wird in der Navigationsinfoanzeige die Meldung „Rerouting...“ (Weiterleitung wird neu berechnet) angezeigt. Sobald eine Route gefunden wurde, wird eine NavInfo-Nachricht mit dem Status ENROUTE gesendet.

• Angehalten: STOPPED bedeutet, dass die Navigation beendet wurde. Beispielsweise wird die Navigation beendet, wenn der Nutzer die Navigation in der App beendet. In der Beispiel-App wird die Anzeige mit den Navigationsinformationen durch den Status STOPPED gelöscht, damit keine anhaltenden Schrittanweisungen angezeigt werden.

Feed-Anzeige ausfüllen

Nachdem Sie Ihren detaillierten Routendienst eingerichtet haben, werden in diesem Abschnitt die visuellen und Textelemente beschrieben, mit denen Sie die Anleitungskarten für den detaillierten Feed ausfüllen können.

Informationsfelder für Navigationskarten

Wenn der Fahrer die geführte Navigation einfährt, wird oben eine Navigationskarte mit dem Navigationsdatum aus dem Navigation SDK angezeigt. Das zugehörige Bild zeigt ein Beispiel für diese wesentlichen Navigationselemente.

In dieser Tabelle sehen Sie die Felder für Navigationsinformationen und deren jeweilige Position.

Felder für die einzelnen Navigationsschritte	Felder für die gesamte Fahrt
Gefunden in StepInfo	Gefunden in NavInfo
Vollständiger Straßenname	Verbleibende Zeit
Das Manöver-Symbol	Entfernung zum Ziel
Entfernung zum nächsten Schritt
Felder für die Spurführung

Spurführung

Das Navigation SDK stellt Fahrspuren auf der Navigationskarte als Datenobjekte Lane und LaneDirection dar. Ein Lane-Objekt stellt eine bestimmte Fahrspur während der Navigation dar und enthält eine Liste mit LaneDirection-Objekten, die alle Abzweigungen beschreiben, die auf dieser Fahrspur möglich sind.

Die empfohlene Richtung auf einer Spur ist im Feld isRecommended angegeben.

Beispiel für die Spurführung

Das folgende Snippet veranschaulicht die Datendarstellung der oben dargestellten Fahrspuren.

// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
                  {/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]

// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]

Symbole für Manöver erstellen

Mit dem Enum Maneuver wird jede mögliche Manöver während der Navigation definiert. Die Bewegung für einen bestimmten Schritt lässt sich mit der Methode StepInfo.getManeuver() abrufen.

Sie müssen Symbole für Manöver erstellen und mit den entsprechenden Manövern koppeln. Bei einigen Manövern können Sie eine 1:1-Zuordnung zu einem Symbol einrichten, z. B. DESTINATION_LEFT und DESTINATION_RIGHT. Da sich einige Manövern jedoch ähneln, kann es sinnvoll sein, einem Symbol mehr als eine Bewegung zuzuordnen. Beispielsweise könnten TURN_LEFT und ON_RAMP_LEFT beide dem Linksabbiegesymbol zugeordnet werden.

Bedienelemente in Android Auto: Manöver im Navigation SDK sind genau mit Android Auto verknüpft. Sie müssen die Typen jedoch in das richtige Format für Android Auto konvertieren. Weitere Informationen finden Sie im Artikel Navigation für Android Auto aktivieren unter Richtige Manövertypen sicherstellen.

Manche Manöver enthalten ein zusätzliches clockwise- oder counterclockwise-Label, das vom SDK basierend auf der Fahrseite eines Landes bestimmt wird. In Ländern, in denen Fahrzeuge auf der linken Straßenseite fahren, nehmen sie beispielsweise einen Kreisverkehr im Uhrzeigersinn oder kehren im Uhrzeigersinn ab, während Länder mit Rechtsverkehr im Uhrzeigersinn fahren. Das Navigation SDK erkennt, ob eine Bewegung im linken oder rechten Verkehr erfolgt, und gibt das entsprechende Manöver aus. Daher kann das Bewegungssymbol für eine Bewegung im Uhrzeigersinn von einer Bewegung gegen den Uhrzeigersinn abweichen.

Maximieren, um Beispielsymbole für verschiedene Manövern zu sehen

Beispielsymbol	TurnByTurn-Manöver
	DEPART UNKNOWN
	STRAIGHT ON_RAMP_UNSPECIFIED OFF_RAMP_UNSPECIFIED NAME_CHANGE
	TURN_RIGHT ON_RAMP_RIGHT
	TURN_LEFT ON_RAMP_LEFT
	TURN_SLIGHT_RIGHT ON_RAMP_SLIGHT_RIGHT OFF_RAMP_SLIGHT_RIGHT
	TURN_SLIGHT_LEFT ON_RAMP_SLIGHT_LEFT OFF_RAMP_SLIGHT_LEFT
	TURN_SHARP_RIGHT ON_RAMP_SHARP_RIGHT OFF_RAMP_SHARP_RIGHT
	TURN_SHARP_LEFT ON_RAMP_SHARP_LEFT OFF_RAMP_SHARP_LEFT
	TURN_U_TURN_COUNTERCLOCKWISE ON_RAMP_U_TURN_COUNTERCLOCKWISE OFF_RAMP_U_TURN_COUNTERCLOCKWISE
	TURN_U_TURN_CLOCKWISE ON_RAMP_U_TURN_CLOCKWISE OFF_RAMP_U_TURN_CLOCKWISE
	ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
	ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
	ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
	ROUNDABOUT_RIGHT_CLOCKWISE
	ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
	ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
	ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
	ROUNDABOUT_STRAIGHT_CLOCKWISE
	ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
	ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
	ROUNDABOUT_LEFT_COUNTERCLOCKWISE
	ROUNDABOUT_LEFT_CLOCKWISE
	ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
	ROUNDABOUT_SHARP_LEFT_CLOCKWISE
	ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
	ROUNDABOUT_U_TURN_CLOCKWISE
	ROUNDABOUT_COUNTERCLOCKWISE
	ROUNDABOUT_CLOCKWISE
	ROUNDABOUT_EXIT_COUNTERCLOCKWISE
	ROUNDABOUT_EXIT_CLOCKWISE
	MERGE_RIGHT OFF_RAMP_RIGHT
	MERGE_LEFT OFF_RAMP_LEFT
	FORK_RIGHT TURN_KEEP_RIGHT ON_RAMP_KEEP_RIGHT OFF_RAMP_KEEP_RIGHT
	FORK_LEFT TURN_KEEP_LEFT ON_RAMP_KEEP_LEFT OFF_RAMP_KEEP_LEFT
	MERGE_UNSPECIFIED
	DESTINATION
	DESTINATION_RIGHT
	DESTINATION_LEFT
	FERRY_BOAT
	FERRY_TRAIN

Generierte Symbole verwenden

Um Android Auto-Anwendungsfälle zu erleichtern, unterstützt das Navigation SDK die Generierung von Symbolen für Manöver und Spurführung. Diese Symbole entsprechen den Richtlinien zur Bildgröße der Android Auto App-Bibliothek, für die ein Begrenzungsrahmen von 500 × 74 dp empfohlen wird. Weitere Informationen finden Sie in der Android-Referenzdokumentation unter setsLaneImage und CarIcon.

Hinweis: Die Symbolgenerierung ist standardmäßig deaktiviert.

Beispiel für die Symbolgenerierung

NavigationUpdatesOptions options =
  NavigationUpdatesOptions.builder()
             .setNumNextStepsToPreview(numNextStepsToPreview)
             .setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
             .setDisplayMetrics(getResources().getDisplayMetrics())
             .build();
boolean isRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(),
              NavInfoReceivingService.class.getName(),
              options);

Nachdem Sie die Symbolgenerierung aktiviert haben, füllt das TurnbyTurn-StepInfo-Objekt die Felder maneuverBitmap und lanesBitmap mit den Symbolen aus.

Nächste Schritte

• Android Auto-Apps:
  • Zeichnen Sie die Karte und aktivieren Sie die Navigation.