Ein Datenfeed mit Schritt-für-Schritt-Anleitung liefert nur Navigationsinformationen für Geräte, die nicht für die kartenbasierte Navigation entwickelt wurden. Sie liefert Informationen für bevorstehende Manöver mit Elementen, die Sie liefern:
- Symbole (links, rechts, wenden)
- Zahlen im Kreisverkehr drehen
- 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.
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 Ihren Projekten die TurnByTurn-Bibliothek hinzufügen. Außerdem wird der allgemeine Ablauf zum Erstellen der Schritt-für-Schritt-Funktionalität zusammengefasst.
Dem Projekt mithilfe von Maven die TurnByTurn-Bibliothek hinzufügen (empfohlen)
So verwenden Sie eine eigenständige Version der TurnByTurn-Bibliothek:
- Richten Sie Ihre Umgebung für den Zugriff auf das Maven-Repository des Hosts ein:
Maven
Füge deiner Datei
pom.xml
Folgendes hinzu:<project> ... <repositories> <repository> <id>google-maven-repository</id> <url>https://maven.google.com</url> </repository> </repositories> ... </project>
Gradle
Füge deiner Datei
build.gradle
Folgendes hinzu:repositories { ... google() }
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 TurnByTurn-Bibliothek ist als JAR-Datei in diesem SDK-Ordner verfügbar. Wenn Sie keinen Zugriff haben, wenden Sie sich an Ihren Ansprechpartner.
- Laden Sie
google_turnbyturn_*.jar
herunter und entpacken Sie es. - Kopieren Sie die heruntergeladene JAR-Datei in das Verzeichnis
app/libs
Ihres Projekts. 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 folgenden Abschnitte enthalten Details zu jedem Schritt.
Erstellen Sie einen Dienst, um Navigationsaktualisierungen zu erhalten.
Beispiel für die Navigationsdarstellung mit wichtigen Elementen
Dienst erstellen, um Navigationsaktualisierungen zu erhalten
Das Navigation SDK bindet sich an Ihren TurnByTurn-Dienst und sendet ihm Navigationsaktualisierungen über den Android Messenger. Sie können für diese Aktualisierungen einen neuen Navigationsdienst 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 von TurnByTurnManager.MSG_NAV_INFO
festgelegt 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 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 wird erst beendet, wenn Sie seine Registrierung aufheben. 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, heben Sie die Registrierung des Dienstes beim Navigation SDK auf.
navigator.unregisterServiceForNavUpdates();
Navigationsstatus verstehen
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.Route wird neu berechnet:
REROUTING
bedeutet, dass die Navigation läuft, der Navigator aber nach einer neuen Route sucht. Der bevorstehende Fahrschritt ist nicht verfügbar, da es noch keine neue Route gibt. In der Beispiel-App wird in den Navigationsinformationen die Meldung „Route wird neu berechnet...“ angezeigt. Sobald eine Route gefunden wurde, wird eineNavInfo
-Nachricht mit dem StatusENROUTE
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 StatusSTOPPED
die Anzeige der Navigationsinformationen gelöscht, um zu verhindern, dass weitergehende Schrittanleitungen angezeigt werden.
Feeddarstellung darstellen
Nachdem Sie die detaillierte Routenführung eingerichtet haben, werden in diesem Abschnitt die visuellen und Textelemente beschrieben, die Sie zum Ausfüllen der Anleitungskarten für den Schritt-für-Schritt-Feed verwenden können.
Informationsfelder der Navigationskarte
Wenn der Nutzer die geführte Navigation startet, wird oben eine Navigationskarte mit Navigationsdaten aus dem Navigation SDK angezeigt. Das ähnliche Bild zeigt ein Beispiel dieser wesentlichen 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 auf der Abbiegekarte als Datenobjekte Fahrspuren und LaneDirection dar. Ein Lane
-Objekt repräsentiert eine bestimmte Spur während der Navigation und enthält eine Liste von LaneDirection
-Objekten, die alle Abzweigungen beschreiben, die auf dieser Spur möglich sind.
Die empfohlene Richtung, die Nutzer auf einer Fahrspur einschlagen sollten, ist durch das Feld isRecommended gekennzeichnet.
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 der Aufzählung Maneuver
werden alle möglichen Manöver während der Navigation definiert. Sie können die Manöver für einen bestimmten Schritt ü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. So könnten beispielsweise sowohl TURN_LEFT
als auch ON_RAMP_LEFT
dem Symbol zum Abbiegen nach links zugeordnet sein.
Einige Manöver enthalten ein zusätzliches Label clockwise
oder counterclockwise
, das das SDK je nach Fahrerseite eines Landes bestimmt. In Ländern, in denen sich das Fahren beispielsweise auf der linken Straßenseite befindet, biegen Fahrer einen Kreisverkehr oder wenden im Uhrzeigersinn, während sie in Ländern im Uhrzeigersinn fahren. Das Navigation SDK erkennt, ob eine Abbiegung im linken oder rechten Verkehr erfolgt, und gibt die entsprechende Abbiegung aus. Daher kann das Manöversymbol bei einer Manövern im Uhrzeigersinn und bei einer Manöver gegen den Uhrzeigersinn unterschiedlich sein.
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
Um Android Auto-Anwendungsfälle zu erleichtern, unterstützt das Navigation SDK die Generierung von Symbolen für Ablenkungen und Spurführung. Diese Symbole entsprechen den Richtlinien zur Bildgröße in der Android Auto Car App-Bibliothek, die ein Targeting auf einen Begrenzungsrahmen von 500 x 74 dp empfiehlt. 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, füllt das TurnbyTurn-Objekt StepInfo
die Symbole in die Felder maneuverBitmap und lanesBitmap.
Nächste Schritte
- Android Auto-Apps: