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:
- 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() }
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') }
Verwenden der TurnByTurn-Bibliothek
Im Folgenden finden Sie die übergeordneten Schritte zum Aktivieren der Schritt-für-Schritt-Funktion. Die 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 Navigationsaktualisierungen über das Android- Messenger . Sie können für diese Aktualisierungen einen neuen Navigationsdienst erstellen oder einen vorhandenen Navigationsdienst verwenden. Service.
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
Übersicht.
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 MeldungNavInfo
angezeigt. mit dem StatusENROUTE
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 BeimSTOPPED
-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.
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.
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, 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: