Ein Datenfeed mit Schritt-für-Schritt-Anleitung bietet Geräte, die keine für die kartenbasierte Navigation. Es bietet bevorstehende Manöver Elemente, die Sie bereitstellen:

• Symbole (links, rechts, wenden)
• Zahlen im Kreisverkehr drehen
• Straßennamen
• geschätzte Entfernungen und Zeit bis zum nächsten Schritt Ziel

Mit dem detaillierten Feed können Sie Erlebnisse schaffen, bei denen die vollständige Die Benutzeroberfläche des Navigations-SDK ist nicht geeignet, z. B. für Android Auto oder für kleine Bildschirm wird angezeigt, wenn kein vollständiger Android-Stack verfügbar ist. Zum Beispiel haben Sie für Zweiräder könnten Sie dies nutzen. Hier können Sie Navigationshinweise, mit denen sie ihr Ziel schneller und schneller erreichen können selbstbewusst mit nur minimalen Ablenkungen.

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

In diesem Dokument erfahren Sie, wie Sie einen Navigationsdienst erstellen und registrieren, empfängt Navigationsinformationen vom SDK und stellt den Navigationsstatus bereit mit dem Empfängergerät.

Übersicht

In diesem Abschnitt wird beschrieben, wie Sie Ihren Projekten die TurnByTurn-Bibliothek hinzufügen und fasst den übergeordneten Ablauf zum Erstellen der Schritt-für-Schritt-Funktionalität zusammen.

Dem Projekt mithilfe von Maven die TurnByTurn-Bibliothek hinzufügen (empfohlen)

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

1. Richten Sie Ihre Umgebung für den Zugriff auf das Maven-Repository des Hosts ein: <ph type="x-smartling-placeholder"></ph>

   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()
   }
       

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

2. 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 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 es.
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 die übergeordneten Schritte zum Aktivieren der Schritt-für-Schritt-Funktion. Die die folgenden Abschnitte enthalten Details zu jedem Schritt.

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 sich an Ihren TurnByTurn-Dienst und Navigationsaktualisierungen über das Android- Messenger . Sie können für diese Updates einen neuen Navigationsdienst erstellen oder einen vorhandenen Navigationsdienst verwenden. .

Wenn ein Dienst Navigationsaktualisierungen erhält, hat er den Vorteil, dass er einen separaten Hintergrundprozess durchlaufen können.

Der Dienst im folgenden Beispiel empfängt Navigationsinformationen und verwendet den TurnByTurnManager, um die Daten in ein NavInfo-Objekt zu konvertieren, enthält die Navigationsdetails.

/**
 *   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 anhand der Message.what der Klasse Message, die auf den Wert von TurnByTurnManager.MSG_NAV_INFO

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, Das Navigation SDK wird an das SDK gebunden. Sie können manuell startService() und stopService(), um die Lebensdauer der Navigation zu steuern Wenn Sie Ihren Dienst jedoch mit der Navigation SDK starten, wird Ihr Dienst automatisch gestartet und wird erst beendet, wenn Sie die Registrierung aufheben. Je nachdem, wie Sie Ihre App eingerichtet haben, wie Sie einen Dienst im Vordergrund starten, Dokumentation Dienste .

Dienst abmelden

Wenn Sie keine Navigationsupdates mehr erhalten möchten, melden Sie den Dienst von der Navigation SDK

navigator.unregisterServiceForNavUpdates();

Navigationsstatus verstehen

Verwenden Sie NavInfo.getNavState(), um den aktuellen Status der Navigation abzurufen: zu verwenden:

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

• Route wird neu berechnet: REROUTING bedeutet, dass die Navigation läuft, aber die sucht Navigator eine neue Route. Der nächste Schritt ist nicht da es noch keine neue Route gibt. In der Beispiel-App wird die Option "Route wird neu berechnet..." Nachricht erscheint in die Anzeige der Navigationsinformationen. Sobald eine Route gefunden wurde, wird die Meldung NavInfo angezeigt. mit dem Status ENROUTE gesendet.

• Angehalten: STOPPED bedeutet, dass die Navigation beendet wurde. Zum Beispiel die Navigation wenn der Nutzer die Navigation in der App beendet. In der Beispiel-App Beim STOPPED-Status wird die Anzeige der Navigationsinformationen gelöscht, um das Verlassen des Schritts zu verhindern nicht mehr angezeigt werden.

Feeddarstellung darstellen

Nachdem Sie die Routenführung eingerichtet haben, werden in diesem Abschnitt visuelle und Textelemente, die Sie zum Ausfüllen der Anleitungskarten für die detaillierte Routenführung.

Informationsfelder der Navigationskarte

Wenn Nutzende die geführte Navigation starten, erscheint oben eine Navigationskarte, mit Navigationsdaten aus dem Navigation SDK Das ähnliche Bild zeigt ein Beispiel grundlegende Navigationselemente.

In dieser Tabelle sind die Felder für Navigationsinformationen und wo sie zu finden sind.

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

Spurführung

Das Navigation SDK stellt Spuren in der Navigation dar. Karte drehen als Fahrspur und LaneDirection Datenobjekte. Ein Lane-Objekt repräsentiert eine bestimmte Spur während der Navigation hat eine Liste mit LaneDirection-Objekten, die alle möglichen Abbiegungen beschreiben. die auf dieser Spur gemacht wurden.

Die empfohlene Richtung, in die Nutzer auf einer Fahrspur fahren sollten, ist durch das isRecommended ein.

Beispiel für die Spurführung

Das folgende Snippet veranschaulicht die Datendarstellung der angezeigten Spuren. oben.

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

Die Maneuver enum definiert alle möglichen Manöver während der Navigation. kann die Manöver für einen bestimmten Schritt aus der StepInfo.getManeuver()-Methode 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 einrichten, z. B. DESTINATION_LEFT und DESTINATION_RIGHT. Da einige Manöver jedoch können Sie einem Symbol mehr als eine Bewegung zuordnen. Für Beispiel: TURN_LEFT und ON_RAMP_LEFT könnten beide dem Symbol zum Abbiegen nach links zugeordnet sein.

<ph type="x-smartling-placeholder">

Einige Manöver enthalten zusätzlich das Label clockwise oder counterclockwise. das das SDK anhand der Fahrerseite eines Landes bestimmt. Beispiel: in denen man auf der linken Straßenseite fahren kann, Kreisverkehr oder Kehrtwende im Uhrzeigersinn, während er sich bei der rechten Seite der Straße befindet Länder im Uhrzeigersinn. Das Navigation SDK erkennt ob eine Abbiegung im Verkehr auf der linken oder rechten Seite erfolgt angemessene Manöver. Daher kann das Manöversymbol im oder gegen den Uhrzeigersinn.

Generierte Symbole verwenden

Um Android Auto-Anwendungsfälle zu erleichtern, Das Navigation SDK unterstützt die Generierung von Abbiege- und Spuren Anleitungssymbole. Diese Symbole entsprechen den Richtlinien zur Bildgröße in Android Auto. Auto-App-Bibliothek, die ein Targeting auf einen Begrenzungsrahmen von 500 x 74 dp empfiehlt. Weitere Informationen finden Sie unter setsLaneImage und CarIcon finden Sie in der Android-Referenzdokumentation.

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-Objekt StepInfo die Felder maneuverBitmap und lanesBitmap mit den Symbolen.

Nächste Schritte

• Android Auto-Apps: <ph type="x-smartling-placeholder">
  </ph>
  • Karte zeichnen und Navigation.