Detaillierten Turn Data-Feed aktivieren

Ein Datenfeed mit Schritt-für-Schritt-Anleitung liefert nur Navigationsinformationen für Geräte, die nicht für die kartenbasierte Navigation entwickelt wurden. Er bietet anstehende Manöver mit von Ihnen bereitgestellten Elementen:

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

Mit dem Schritt-für-Schritt-Feed kannst du Inhalte erstellen, bei denen die gesamte Navigation SDK-UI nicht geeignet ist, z. B. für Android Auto oder für kleine Displays, bei denen kein vollständiger Android-Stack verfügbar ist. Sie eignet sich beispielsweise für Zweiräder, bei denen Sie eine reine Navigationsführung projizieren, damit diese schneller und sicherer und mit minimalen Ablenkungen ans Ziel kommen.

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 dem empfangenden Gerät den Navigationsstatus bereitstellt.

Ü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.

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

  1. Richten Sie Ihre Umgebung für den Zugriff auf das Maven-Repository des Hosts ein:

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

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

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 es.
  2. Kopieren Sie die heruntergeladene JAR-Datei in das Verzeichnis app/libs Ihres Projekts.
  3. Fügen Sie Folgendes zu Ihrem build.gradle hinzu, um die JAR-Datei in Ihren Build aufzunehmen.

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

Die Navigationsbibliothek verwenden

Im Folgenden finden Sie die übergeordneten Schritte zum Aktivieren der Schritt-für-Schritt-Funktion. In den folgenden Abschnitten wird jeder Schritt im Detail beschrieben.

  1. Erstellen Sie einen Dienst, um Navigationsaktualisierungen zu erhalten.

  2. Registrieren Sie den Dienst.

  3. Navigationsstatus

  4. Beispiel für die Navigationsdarstellung mit wichtigen Elementen

Dienst erstellen, um Navigationsaktualisierungen zu erhalten

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.

Die Verwendung eines Dienstes für den Empfang von Navigationsaktualisierungen hat den Vorteil, dass er 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 zu konvertieren, 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.

Dienst für Navigationsaktualisierungen 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 eingerichtet haben, können Sie einen Dienst im Vordergrund starten. Dies wird in der Android-Dokumentation zu Diensten beschrieben.

Dienst abmelden

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

navigator.unregisterServiceForNavUpdates();

Navigationsstatus

Verwenden Sie NavInfo.getNavState(), um den aktuellen Status der Navigation abzurufen. Dabei handelt es sich um einen der folgenden Status:

  • Enroute: Der Status ENROUTE bedeutet, dass die geführte Navigation derzeit aktiv ist und sich der Nutzer auf der angegebenen Route befindet. Informationen zum aktuell anstehenden Manöverschritt 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 Beispiel-App wird in den Navigationsinformationen die Meldung „Route 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. Die Navigation wird beispielsweise angehalten, wenn der Nutzer die Navigation in der App beendet. In der Beispiel-App wird durch den Status STOPPED die Anzeige der Navigationsinformationen gelöscht, damit keine längeren Schritte angezeigt werden.

Feeddarstellung darstellen

Nachdem Sie Ihren Navigationsservice eingerichtet haben, erfahren Sie in diesem Abschnitt, welche visuellen und Textelemente Sie zum Ausfüllen der Navigationskarten für den Navigationsfeed verwenden können.

Display eines Mobilgeräts, auf dem die nächste Abzweigung von links in die 30 Meter auf die W Ahwanee Avenue zu sehen ist. Am unteren Bildschirmrand beträgt die verbleibende Zeit bis zum Ziel 46 Minuten und die verbleibende Strecke 39 Meilen.

Wenn der Nutzer die Navigation startet, wird oben eine Navigationskarte mit Navigationsdaten angezeigt, die aus dem Navigation SDK stammen. Das ähnliche Bild zeigt ein Beispiel dieser wesentlichen 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 Reise
Gefunden in StepInfo In NavInfo gefunden
Vollständiger Straßenname Verbleibende Zeit
Das Manöversymbol 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.

Eine Beispielkonfiguration für die Spurführung.

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

Sie müssen Manöversymbole erstellen und mit den zugehörigen Manövern verknüpfen. Bei einigen Manövern können Sie eine 1:1-Zuordnung zu einem Symbol wie DESTINATION_LEFT und DESTINATION_RIGHT einrichten. Da einige Manöver jedoch ähnlich sind, möchten Sie möglicherweise mehr als ein Manöver einem einzelnen Symbol zuordnen. Beispiel: TURN_LEFT und ON_RAMP_LEFT können beide dem Symbol für die Linksabbiegung zugeordnet werden.

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 Navigation SDK erkennt, ob eine Abbiegung im linken oder rechten Verkehr erfolgt, und gibt die entsprechende Abbiegung aus. Daher kann das Symbol für ein Abbiegen im Uhrzeigersinn von dem für ein Abbiegen gegen den Uhrzeigersinn abweichen.

Maximieren, um Beispiele für unterschiedliche Manöver zu sehen

Beispielsymbol Turn-by-Turn-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

Eine kleine Liste der vom Navigations-SDK generierten Symbole.

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.

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