Detaillierten Turn Data-Feed aktivieren

Ein Datenfeed für die detaillierte Routenführung liefert reine Navigationsinformationen für Geräte, die nicht für die kartenbasierte Navigation ausgelegt sind. Sie liefert Informationen zu anstehenden Manövern mit den von Ihnen bereitgestellten Elementen:

• Symbole (links, rechts, wenden)
• Abbiegenummern in Kreisverkehren
• Straßennamen
• Geschätzte Entfernungen und Zeit bis zum nächsten Navigationsschritt oder Endziel

Sie können den Feed mit detaillierter Routenführung verwenden, um Funktionen zu erstellen, bei denen die vollständige Navigation SDK-Benutzeroberfläche nicht geeignet ist, z. B. für Android Auto oder für kleine Bildschirme, auf denen kein vollständiger Android-Stack verfügbar ist. Sie können diese Funktion beispielsweise für Fahrer von Zweirädern verwenden, um ihnen nur die Navigation anzuzeigen. So können sie ihr Ziel schneller und sicherer erreichen, ohne abgelenkt zu werden.

Wenn Sie das SDK verwenden möchten, müssen Sie einen Dienst erstellen und im Navigation SDK for Android registrieren, damit es neue Navigationsinformationen in Echtzeit empfangen kann (während der Navigation etwa einmal pro Sekunde).

In diesem Dokument erfahren Sie, wie Sie einen Navigationsdienst erstellen und registrieren, der Navigationsinformationen vom SDK empfängt und den Navigationsstatus an das Empfängergerät weitergibt.

Übersicht

In diesem Abschnitt wird der allgemeine Ablauf zum Aktivieren der detaillierten Routenführung zusammengefasst.

TurnByTurn-Funktion verwenden

Hier sind die allgemeinen Schritte zum Aktivieren der detaillierten Routenführung. In den folgenden Abschnitten finden Sie Details zu den einzelnen Schritten.

1. Dienst zum Empfangen von Navigationsupdates erstellen

2. Dienst registrieren

3. Navigationsstatus

Dienst zum Empfangen von Navigationsupdates erstellen

Das Navigation SDK wird an Ihren TurnByTurn-Dienst gebunden und sendet ihm Navigationsupdates über den Android Messenger. Sie können für diese Updates einen neuen Navigationsdienst erstellen oder einen vorhandenen Dienst 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 verwendet den TurnByTurnManager, um die Daten in ein NavInfo-Objekt mit den Navigationsdetails zu konvertieren.

/**
 *   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, das auf den Wert von TurnByTurnManager.MSG_NAV_INFO gesetzt ist.

Hinweis: Der Wertebereich 7200–7299 sollte für Nachrichtencodes reserviert werden, da das Navigation SDK in Zukunft möglicherweise Nachrichtencodes in diesem Bereich verwendet.

Dienst für Navigationsupdates registrieren

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 ist. Sie können startService() und stopService() manuell aufrufen, um den Lebenszyklus des Navigationsdienstes zu steuern. Wenn Sie Ihren Dienst jedoch beim Navigation SDK registrieren, wird er automatisch gestartet und erst beendet, wenn Sie die Registrierung aufheben. Je nachdem, wie Sie Ihre App eingerichtet haben, sollten Sie einen Dienst im Vordergrund starten, wie in der Android-Dokumentation Dienste – Übersicht beschrieben.

Dienst abmelden

Wenn Sie keine Navigationsupdates mehr erhalten möchten, melden Sie den Dienst vom Navigation SDK ab.

navigator.unregisterServiceForNavUpdates();

Navigationsstatus verstehen

Verwenden Sie NavInfo.getNavState(), um den aktuellen Navigationsstatus abzurufen. Dieser kann einen der folgenden Werte haben:

• Unterwegs: Der Status ENROUTE bedeutet, dass die geführte Navigation aktiv ist und der Nutzer sich auf der angegebenen Route befindet. Informationen zum aktuellen bevorstehenden Manöverschritt sind verfügbar.

• Route neu berechnen: REROUTING bedeutet, dass die Navigation läuft, aber der Navigator nach einer neuen Route sucht. Der nächste Manöverschritt ist nicht verfügbar, da noch keine neue Route vorhanden ist. In der Beispiel-App wird in der Navigationsinfo die Meldung „Route wird neu berechnet…“ angezeigt. Sobald eine Route gefunden wurde, wird eine NavInfo-Nachricht mit dem Status ENROUTE gesendet.

• Beendet: STOPPED bedeutet, dass die Navigation beendet wurde. Die Navigation wird beispielsweise beendet, wenn der Nutzer die Navigation in der App beendet. In der Beispiel-App wird die Anzeige der Navigationsinformationen durch den Status STOPPED gelöscht, damit keine verbleibenden Schrittanleitungen angezeigt werden.

Feedanzeige füllen

Nachdem Sie den Dienst für die detaillierte Routenführung eingerichtet haben, geht es in diesem Abschnitt um die visuellen und Textelemente, mit denen Sie die Navigationskarten für den Feed mit detaillierter Routenführung füllen können.

Informationsfelder auf der Navigationskarte

Wenn der Nutzer die geführte Navigation startet, wird oben eine Navigationskarte mit Navigationsdaten aus dem Navigation SDK angezeigt. Das Bild zeigt ein Beispiel für diese wichtigen Navigationselemente.

In dieser Tabelle sind die Felder für Navigationsinformationen und ihre Position aufgeführt.

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

Spurführung

Im Navigation SDK werden Fahrspuren in der Abbiegekarte der Navigation als Datenobjekte vom Typ Lane und LaneDirection dargestellt. Ein Lane-Objekt stellt eine bestimmte Fahrspur während der Navigation dar und enthält eine Liste von LaneDirection-Objekten, die alle Abbiegemöglichkeiten von dieser Fahrspur beschreiben.

Die empfohlene Richtung, die ein Nutzer auf einer Spur einschlagen sollte, wird durch das Feld isRecommended gekennzeichnet.

Beispiel für Spurführung

Das folgende Snippet veranschaulicht die Datendarstellung der oben gezeigten Lanes.

// 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

Das Enum Maneuver definiert alle möglichen Manöver, die während der Navigation auftreten können. Sie können das Manöver für einen bestimmten Schritt mit der Methode StepInfo.getManeuver() abrufen.

Sie müssen Symbole für Fahrmanöver erstellen und sie mit den entsprechenden Fahrmanövern verknüpfen. Für einige Manöver können Sie eine 1:1-Zuordnung zu einem Symbol einrichten, z. B. DESTINATION_LEFT und DESTINATION_RIGHT. Da einige Manöver jedoch ähnlich sind, kann es sinnvoll sein, mehrere Manöver einem einzigen Symbol zuzuordnen. Beispielsweise könnten sowohl TURN_LEFT als auch ON_RAMP_LEFT dem Symbol für „Links abbiegen“ zugeordnet werden.

Android Auto-Manöver: Manöver im Navigation SDK werden eins zu eins auf Android Auto abgebildet. Sie müssen die Typen jedoch in das richtige Format für Android Auto konvertieren. Weitere Informationen finden Sie unter Korrekte Manövertypen prüfen im Hilfeartikel Navigation für Android Auto aktivieren.

Einige Manöver enthalten ein zusätzliches clockwise- oder counterclockwise-Label, das vom SDK anhand der Straßenseite bestimmt wird, auf der in einem Land gefahren wird. In Ländern mit Linksverkehr fahren Fahrer beispielsweise im Uhrzeigersinn in einen Kreisverkehr oder machen eine Kehrtwende, während in Ländern mit Rechtsverkehr im Uhrzeigersinn gefahren wird. Das Navigation SDK erkennt, ob ein Manöver im Links- oder Rechtsverkehr stattfindet, und gibt das entsprechende Manöver aus. Daher kann das Symbol für ein Manöver im Uhrzeigersinn anders aussehen als für ein Manöver gegen den Uhrzeigersinn.

Maximieren, um Beispielsymbole für verschiedene Manöver 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

Zur Unterstützung von Android Auto-Anwendungsfällen unterstützt das Navigation SDK die Generierung von Symbolen für Manöver und Fahrspurhinweise. Diese Symbole entsprechen den Richtlinien zur Bildgröße der Android Auto Car App-Mediathek, die einen Begrenzungsrahmen von 500 × 74 dp empfehlen. 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, werden die Felder maneuverBitmap und lanesBitmap im TurnbyTurn-Objekt StepInfo mit den Symbolen gefüllt.

Nächste Schritte

• Für Android Auto-Apps:
  • Karte zeichnen und Navigation aktivieren