Detaillierten Turn Data-Feed aktivieren

Ein Datenfeed für die detaillierte Routenführung enthält nur Navigationsinformationen für Geräte, die nicht für die kartenbasierte Navigation vorgesehen sind. Er bietet anstehende Manöver mit von Ihnen bereitgestellten Elementen:

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

Sie können den Feed mit detaillierten Wegbeschreibungen verwenden, wenn die vollständige Navigation SDK-Benutzeroberfläche nicht geeignet ist, z. B. für Android Auto oder für kleine Displays, 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 Navigationshinweise zu projizieren, damit sie ihr Ziel schneller und sicherer mit minimalen Ablenkungen erreichen.

Wenn Sie das SDK verwenden möchten, erstellen Sie einen Dienst und registrieren ihn beim Navigation SDK für Android, damit er neue Navigationsinformationen in Echtzeit erhalten 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 den Navigationsstatus an das Empfängergerät weitergibt.

Übersicht

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

Mit Maven die Navigationsanweisungen-Bibliothek zum Projekt hinzufügen (empfohlen)

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

So verwenden Sie eine eigenständige Version der Navigationsbibliothek:

1. Richten Sie Ihre Umgebung so ein, dass sie auf das Maven-Repository des Hosts zugreifen kann:

   Maven

   Fügen Sie der Datei pom.xml Folgendes hinzu:

       <project>
         ...
         <repositories>
           <repository>
             <id>google-maven-repository</id>
             <url>https://maven.google.com</url>
           </repository>
         </repositories>
         ...
       </project>
       
       

   Gradle

   Fügen Sie der Datei build.gradle Folgendes hinzu:

   repositories {
       ...
       google()
   }
       

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'
   }
       

Die Navigationsbibliothek mit einer heruntergeladenen JAR-Datei in Ihr Projekt einbinden (Alternative)

Die Navigationsanfrage-Bibliothek ist in diesem SDK-Ordner als JAR-Datei 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 der Datei build.gradle Folgendes hinzu, um das JAR in Ihren Build aufzunehmen.

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

Die Navigationsbibliothek verwenden

So aktivieren Sie die Funktion für detaillierte Wegbeschreibungen: In den folgenden Abschnitten wird jeder Schritt im Detail beschrieben.

1. Dienst zum Empfangen von Navigationsaktualisierungen erstellen

2. Registrieren Sie den Dienst.

3. Navigationsstatus

Dienst zum Empfangen von Navigationsaktualisierungen erstellen

Das Navigation SDK bindet an Ihren Navigationsdienst und sendet ihm Navigationsaktualisierungen über den Android-Messenger. Sie können einen neuen Navigationsdienst für diese Updates erstellen oder einen vorhandenen Dienst verwenden.

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

Der Dienst im folgenden Beispiel empfängt Navigationsinformationen und verwendet TurnByTurnManager, um die Daten in ein NavInfo-Objekt umzuwandeln, 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, das auf den Wert TurnByTurnManager.MSG_NAV_INFO gesetzt ist.

Hinweis :Der Wertebereich 7200–7299 muss für Nachrichtencodes reserviert bleiben, da das Navigations-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 daran gebunden ist. Sie können startService() und stopService() manuell aufrufen, um den Lebenszyklus des Navigationsdiensts zu steuern. Wenn Sie Ihren Dienst jedoch beim Navigation SDK registrieren, wird er automatisch gestartet und nur beendet, wenn Sie ihn abmelden. Je nachdem, wie Sie Ihre App einrichten, sollten Sie möglicherweise einen Dienst im Vordergrund starten. Weitere Informationen finden Sie in der Android-Dokumentation unter Dienste – Übersicht.

Dienst abmelden

Wenn Sie keine Navigationsupdates mehr erhalten möchten, melden Sie den Dienst im Navigations-SDK ab.

navigator.unregisterServiceForNavUpdates();

Navigationsstatus

Mit NavInfo.getNavState() können Sie den aktuellen Navigationsstatus abrufen. Dieser kann einer der folgenden sein:

• Unterwegs: Der Status ENROUTE bedeutet, dass die Navigation derzeit aktiv ist und sich der Nutzer auf der angegebenen Route befindet. Informationen zum aktuellen und nächsten Fahrmanöver sind verfügbar.

• Weiterleitung: REROUTING bedeutet, dass die Navigation aktiv ist, der Navigationsassistent aber nach einer neuen Route sucht. Der nächste Abbiegeversuch ist nicht verfügbar, da noch keine neue Route vorhanden ist. In der Beispielanwendung wird in der Navigationsinfoanzeige die Meldung „Weiterleitung…“ angezeigt. Sobald eine Route gefunden wurde, wird eine NavInfo-Nachricht mit dem Status ENROUTE gesendet.

• Angehalten: STOPPED bedeutet, dass die Navigation beendet wurde. So wird die Navigation beispielsweise beendet, wenn der Nutzer die Navigation in der App beendet. In der Beispiel-App wird bei einem STOPPED-Status das Navigationsinfo-Display gelöscht, damit keine anhängigen Schrittanleitungen angezeigt werden.

Feedanzeige füllen

Nachdem Sie Ihren Navigationsservice eingerichtet haben, erfahren Sie in diesem Abschnitt, welche visuellen und Textelemente Sie für die Navigationskarten im Navigationsfeed verwenden können.

Informationsfelder für Navigationskarten

Wenn der Nutzer die Navigation startet, wird oben eine Navigationskarte mit Navigationsdaten angezeigt, die aus dem Navigation SDK stammen. Das zugehörige 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
In StepInfo gefunden	In NavInfo gefunden
Vollständiger Straßenname	Verbleibende Zeit
Das Symbol für den Fahrmanöver	Entfernung zum Ziel
Entfernung zum nächsten Schritt
Felder für die Spurführung

Spurführung

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

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

Beispiel für die Spurführung

Im folgenden Snippet ist die Datendarstellung der oben angezeigten Fahrstreifen zu sehen.

// 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. Das Manöver für einen bestimmten Schritt können Sie über die Methode StepInfo.getManeuver() abrufen.

Sie müssen Symbole für die einzelnen Fahrmanöver erstellen und mit den entsprechenden Fahrmanövern verknüpfen. Für einige Manöver können Sie eine Eins-zu-Eins-Zuordnung zu einem Symbol einrichten, z. B. DESTINATION_LEFT und DESTINATION_RIGHT. Da einige Manöver jedoch ähnlich sind, können Sie einem einzigen Symbol mehrere Manöver zuordnen. Beispiel: TURN_LEFT und ON_RAMP_LEFT können beide dem Symbol für die Linksabbiegung zugeordnet werden.

Android Auto-Abbiegevorgänge: Abbiegevorgänge im Navigation SDK werden eins zu eins in Android Auto zugeordnet. Sie müssen die Typen jedoch in das richtige Format für Android Auto konvertieren. Weitere Informationen finden Sie unter Navigation für Android Auto aktivieren im Abschnitt Richtige Abbiegetypen angeben.

Einige Fahrmanö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 auf der linken Straßenseite gefahren wird, fahren Fahrer beispielsweise im Kreisverkehr oder beim Abbiegen im Uhrzeigersinn, während dies in Ländern mit Rechtsverkehr gegen den Uhrzeigersinn geschieht. Das Navigations-SDK erkennt, ob ein Abbiegevorgang bei Links- oder Rechtsverkehr erfolgt, und gibt die entsprechende Abbiegevorgabe aus. Daher kann das Symbol für ein Abbiegen im Uhrzeigersinn von dem für ein Abbiegen gegen den Uhrzeigersinn abweichen.

Maximieren Sie die Ansicht, um Beispielsymbole für verschiedene Manöver zu sehen.

Beispielsymbol	Abbiegevorgaben
	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 die Nutzung von Android Auto zu erleichtern, unterstützt das Navigations-SDK die Generierung von Symbolen für Abbiege- und Fahrstreifeninformationen. Diese Symbole entsprechen den Empfehlungen zur Bildgröße der Android Auto-App-Bibliothek, in der 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, werden die Felder maneuverBitmap und lanesBitmap im StepInfo-Objekt für die Schritt-für-Schritt-Navigation mit den Symbolen ausgefüllt.

Nächste Schritte

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