Navigator

Public Interface Navigator

Ein Singleton, das Methoden zur Steuerung der Navigation bereitstellt.

Alle Methoden sind Thread-sicher, mit Ausnahme von setAudioGuidance und setHeadsUpNotificationEnabled, die im UI-Thread aufgerufen werden müssen.

Zusammenfassung für geschachtelte Klassen

Oberfläche	Navigator.ArrivalListener		Definiert Signaturen für Methoden, die aufgerufen werden, wenn der Treiber an einem Wegpunkt ankommt.
@Interface	Navigator.AudioGuidance		AudioGuidance besteht aus einer Reihe von Flags, mit denen angegeben wird, welche Arten von Audiowarnungen und -warnungen bei der Navigation verwendet werden.
Oberfläche	Navigator.RemainingTimeOrDistanceChangedListener		Definiert Signaturen für Methoden, die aufgerufen werden, wenn sich die verbleibende Zeit oder Entfernung zum nächsten Ziel ändert.
Oberfläche	Navigator.RouteChangedListener		Definiert Signaturen für Methoden, die aufgerufen werden, wenn sich die Route ändert.
enum	Navigator.RouteStatus		Ein RouteStatus ist ein Statuscode, der das Ergebnis einer Routenberechnung darstellt, auf die über das von setDestination(Waypoint) zurückgegebene Future zugegriffen wird.

Public Method Summary

Abstrakt void	cleanup() Bereinigen Sie den internen Status des Navigators.
Abstrakt void	clearDestinations() Löscht alle zuvor festgelegten Ziele und entfernt alle berechneten Routen von der Karte.
Abstrakt void	clearLicensePlateRestrictionInfo() Löscht die Kfz-Kennzeichen des aktuellen Fahrers.
Abstrakt void	clearRemainingTimeOrDistanceChangedListener() Löscht den Listener auf Änderungen der verbleibenden Zeit oder Entfernung.
Zusammenfassung Wegpunkt	continueToNextDestination() Entfernt das aktuelle Ziel.
Abstrakte ListenableResultFuture<RouteInfo>	fetchRouteInfo(Waypoint-Wegpunkt, RoutingOptions-routingOptions) Gibt Routeninformationen für Routen basierend auf den einzelnen RoutingOptions.RoutingStrategy-Werten zurück.
Zusammenfassung RouteSegment	getCurrentRouteSegment() Gibt den aktuellen Abschnitt der Reise zurück.
Zusammenfassung TimeAndDistance	getCurrentTimeAndDistance() Gibt die geschätzte Zeit und Entfernung von der aktuellen Position zum aktuellen Ziel zurück.
abstrakt List<RouteSegment>	getRouteSegments() Gibt eine Liste von Routensegmenten zurück.
Zusammenfassung Simulator	getSimulator() Gibt ein Simulator-Objekt zur Verwendung während des Tests zurück.
Zusammenfassung List<TimeAndDistance>	getTimeAndDistanceList() Gibt eine Liste mit Zeiten und Entfernungen für jedes Ziel in der aktuellen Route zurück, die die geschätzte Zeit und Entfernung von der aktuellen Position zum jeweiligen Ziel darstellt.
Zusammenfassung List<LatLng>	getTraveledRoute() Gibt die Route zurück, die in dieser Anleitungssitzung bisher zurückgelegt wurde (seit dem letzten Aufruf von startGuidance()).
Abstrakt boolesch	isGuidanceRunning() Gibt true zurück, wenn die Anleitung gerade ausgeführt wird.
Abstrakt void	setArrivalListener(Navigator.ArrivalListener-Listener) Registriert einen Listener für Ankunftsereignisse.
Abstrakt void	setAudioGuidance(int Anleitung) Legt fest, welche Arten der Audioführung (einschließlich Vibration) aktiviert sind.
Abstrakt ListenableResultFuture<Navigator.RouteStatus>	setDestination(Waypoint-Ziel, RoutingOptions-routingOptions, DisplayOptions displayOptions) Legt ein einzelnes Ziel für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.
Abstrakt ListenableResultFuture<Navigator.RouteStatus>	setDestination(Wegpunkt-Ziel, RoutingOptions-Optionen) Legt ein einzelnes Ziel für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.
Abstrakt ListenableResultFuture<Navigator.RouteStatus>	setDestination(Wegpunkt-Ziel) Legt ein einzelnes Ziel für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.
Abstrakt ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint>-Ziele, RoutingOptions-Optionen) Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.
Abstrakt ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Wegpunkt>-Ziele, RoutingOptions-routingOptions, DisplayOptions displayOptions) Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.
Abstrakt ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint>-Ziele) Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.
Abstrakt void	setHeadsUpNotificationEnabled(boolesch aktiviert) Legt fest, ob Vorabbenachrichtigungen angezeigt werden sollen.
Abstrakt void	setLicensePlateRestrictionInfo(int rawLicensePlateLastDigit, String lizenzPlateCountryCode) Hiermit wird das Nummernschild des aktuellen Fahrers festgelegt.
Abstrakt void	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, intdistanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener-Listener) Registriert einen Listener, wenn sich die verbleibende Zeit oder Entfernung zum Ziel um mehr als einen angegebenen Grenzwert ändert.
Abstrakt void	setRouteChangedListener(Navigator.RouteChangedListener-Listener) Registriert einen Listener für Ereignisse über geänderte Routen.
Abstrakt void	setSpeedingListener(SpeedingListener speedingListener) Registriert einen SpeedingListener für den Prozentsatz über der Geschwindigkeitsbegrenzung, mit der der Fahrer derzeit fährt.
Abstrakt void	startGuidance(Intent resumeIntent) Entspricht startGuidance(), wobei jedoch ein Intent angegeben wird, mit dem die Anwendung in der Benachrichtigung der Statusleiste im Navigator fortgesetzt werden kann.
Abstrakt void	startGuidance() Wenn ein Ziel festgelegt und dafür eine Route berechnet wurde, wird die detaillierte Routenführung für die Route gestartet.
Abstrakt void	stopGuidance() Stoppt die detaillierte Routenführung.

Public Methods

public abstrakt void Cleanup ()

Bereinigen Sie den internen Status des Navigators.

Hinweis: Durch Aufrufen dieser Methode werden alle ausstehenden Anfragen an setDestinations(List) abgebrochen.

public abstrakt void clearDestinations ()

Löscht alle zuvor festgelegten Ziele und entfernt alle berechneten Routen von der Karte. Wenn die Navigation läuft, wird sie automatisch beendet.

public abstrakt void clearLicensePlateRestrictionInfo ()

Löscht die Kfz-Kennzeichen des aktuellen Fahrers. Dies gilt nur für „setDestination“-Aufrufe, die nach dem Festlegen dieses Werts erfolgen.

public abstrakt void clearRemainingTimeOrDistanceChangedListener ()

Löscht den Listener auf Änderungen der verbleibenden Zeit oder Entfernung.

öffentlich abstrakt Wegpunkt continueToNextDestination ()

Entfernt das aktuelle Ziel. Im Anschluss an diesen Anruf erhältst du eine Wegbeschreibung zum nächsten Ziel und zum alten Ziel sind keine Informationen verfügbar.

Rückgaben

• die Wegpunktführung nun auf oder null ist, wenn keine Wegpunkte mehr übrig sind

public abstrakt ListenableResultFuture<RouteInfo> fetchRouteInfo (Wegpunkt Wegpunkt, RoutingOptionsroutingOptions)

Gibt Routeninformationen für Routen basierend auf den einzelnen RoutingOptions.RoutingStrategy-Werten zurück. RoutingOptions.RoutingStrategy wird ignoriert, da diese Methode die Routeninformationen für alle Routingstrategien zurückgibt.

Hinweis: Diese wird bei jedem Anruf neu berechnet und stimmt möglicherweise nicht mit den Routen überein, die derzeit von der Navigation genutzt werden, da der Verkehr und andere Faktoren in der Zwischenzeit möglicherweise aktualisiert wurden.

Parameter

Wegpunkt	Ziel-Wegpunkt für die Route
routingOptions	die Optionen zum Abrufen der Routeninformationen

Rückgaben

• zurückgegebene Future

public Abstrakt RouteSegment getCurrentRouteSegment ()

Gibt den aktuellen Abschnitt der Reise zurück. Die Startposition dieses RouteSegments ist die zuletzt bekannte (einrastende) Position des Geräts.

Rückgaben

• ein Routensegmentobjekt oder null, wenn keine aktuelle Route vorhanden ist

öffentlich abstrakt TimeAndDistance getCurrentTimeAndDistance ()

Gibt die geschätzte Zeit und Entfernung von der aktuellen Position zum aktuellen Ziel zurück.

Rückgaben

• Ein Zeit- und Entfernungsobjekt oder null, wenn keine aktuelle Route vorhanden ist

public abstrakt List<RouteSegment> getRouteSegments ()

Gibt eine Liste von Routensegmenten zurück. Das Ziel jedes zurückgegebenen Segments entspricht einem Ziel, das durch setDestination(s) festgelegt wird.

public abstrakt Simulator getSimulator ()

Gibt ein Simulator-Objekt zur Verwendung während des Tests zurück.

public abstrakt List<TimeAndDistance> getTimeAndDistanceList ()

Gibt eine Liste mit Zeiten und Entfernungen für jedes Ziel in der aktuellen Route zurück, die die geschätzte Zeit und Entfernung von der aktuellen Position zum jeweiligen Ziel darstellt.

public abstrakt List<LatLng> getTraveledRoute ()

Gibt die Route zurück, die während dieser Anleitungssitzung bisher zurückgelegt wurde (seit dem letzten Aufruf von startGuidance()). Die aufgezeichnete Route besteht aus den Orten, die an der Straße eingerastet wurden, wie sie von RoadSnappedLocationProvider zurückgegeben werden würde. Die Route wird vereinfacht, um redundante Punkte zu entfernen, z. B. durch die Umwandlung aufeinanderfolgender kolinearer Punkte in ein einzelnes Liniensegment.

public abstrakt boolesch isGuidanceRunning ()

Gibt true zurück, wenn die Anleitung gerade ausgeführt wird. Die Routenführung erfolgt erst, nachdem eine Route zu einem Ziel berechnet und startGuidance() aufgerufen wurde.

public abstrakt void setArrivalListener (Navigator.ArrivalListener-Listener)

Registriert einen Listener für Ankunftsereignisse. Überschreibt alle zuvor registrierten Listener.

Hinweis: Zur Vermeidung von Speicherlecks sollte setNavArrivalListener(null) aufgerufen werden, wenn der Listener nicht mehr benötigt wird.

Parameter

Listener	Listener, der registriert werden soll. Kann auf null gesetzt werden, um einen zuvor registrierten Listener zu löschen.

public abstrakt void setAudioGuidance (int guide)

Legt fest, welche Arten der Audioführung (einschließlich Vibration) aktiviert sind. Standardmäßig sind Vibration, Sprache und Sprachausgabe über Bluetooth (falls verfügbar) aktiviert.

Diese Methode muss im UI-Thread aufgerufen werden.

Parameter

Anleitung	eine Kombination von Navigator.AudioGuidance-Flags, die angeben, welche Arten der Audioführung aktiviert werden sollen

public abstrakt ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint-Ziel, RoutingOptionsroutingOptions, DisplayOptions displayOptions)

Legt ein einzelnes Ziel für die Navigation fest und überschreibt alle zuvor festgelegten Ziele. Der zurückgegebene Future-Wert wird auf OK gesetzt, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel gefunden wird.

Parameter

Ziel	das neue Ziel,
routingOptions	die Optionen zum Generieren der Route
displayOptions	die Optionen zum Anzeigen der Route

Rückgaben

• zurückgegebene Future

Löst aus

NullPointerException	Das angegebene Ziel ist null.

public abstrakt ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint-Ziel, RoutingOptions-Optionen)

Legt ein einzelnes Ziel für die Navigation fest und überschreibt alle zuvor festgelegten Ziele. Der zurückgegebene Future-Wert wird auf OK gesetzt, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel gefunden wird. Die Standardeinstellung DisplayOptions wird zum Anzeigen der Route verwendet.

Parameter

Ziel	das neue Ziel,
Optionen	die Optionen zum Generieren der Route

Rückgaben

• zurückgegebene Future

Löst aus

NullPointerException	Das angegebene Ziel ist null.

public abstrakt ListenableResultFuture<Navigator.RouteStatus> setDestination (Wegpunkt Ziel)

Legt ein einzelnes Ziel für die Navigation fest und überschreibt alle zuvor festgelegten Ziele. Der zurückgegebene Future-Wert wird auf OK gesetzt, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel gefunden wird. Der Standard-RoutingOptions wird verwendet, um die Route zu finden, und der Standard-DisplayOptions, um sie anzuzeigen.

Parameter

Ziel	das neue Ziel,

Rückgaben

• zurückgegebene Future

Löst aus

NullPointerException	Das angegebene Ziel ist null.

public abstrakt ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> Ziele, RoutingOptions-Optionen)

Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele. Der zurückgegebene Future-Wert wird auf OK gesetzt, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel gefunden wird. Die Standardeinstellung DisplayOptions wird zum Anzeigen der Route verwendet.

Parameter

Ziele	wird die neue Zielliste
Optionen	die Optionen zum Generieren der Route

Rückgaben

• zurückgegebene Future

public abstrakt ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Wegpunkt> Ziele, RoutingOptions routerOptions, DisplayOptions displayOptions)

Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele. Der zurückgegebene Future-Wert wird auf OK gesetzt, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel gefunden wird.

Parameter

Ziele	wird die neue Zielliste
routingOptions	die Optionen zum Generieren der Route
displayOptions	die Optionen zum Anzeigen der Route

Rückgaben

• zurückgegebene Future

public abstrakt ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Wegpunkt> Ziele)

Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele. Der zurückgegebene Future-Wert wird auf OK gesetzt, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel gefunden wird. Der Standard-RoutingOptions wird verwendet, um die Route zu finden, und der Standard-DisplayOptions, um sie anzuzeigen.

Parameter

Ziele	wird die neue Zielliste

Rückgaben

• zurückgegebene Future

public abstrakt void setHeadsUpNotificationEnabled (boolean enabled)

Legt fest, ob Vorabbenachrichtigungen angezeigt werden sollen. Standardmäßig ist die Benachrichtigung aktiviert. „Vorsicht“-Ereignisse sind Anleitungen wie Abbiegen usw., die angezeigt werden, wenn keine Karte sichtbar ist.

Diese Methode muss im UI-Thread aufgerufen werden.

Parameter

aktiviert	Eine Markierung zur Angabe, ob Vorabbenachrichtigungen aktiviert werden sollen

public abstrakt void setLicensePlateRestrictionInfo (int rawLicensePlateLastDigit, String LicensePlateCountryCode)

Hiermit wird das Nummernschild des aktuellen Fahrers festgelegt. Dadurch können wir bestimmte Straßenbeschränkungen aufgrund von Kfz-Kennzeichen umgehen. Dies gilt nur für „setDestination“-Aufrufe, die nach dem Festlegen dieses Werts erfolgen. Idealerweise rufen Sie es direkt nach der Bedienung an.

Parameter

rawLicensePlateLastDigit	Die letzte Ziffer des Kfz-Kennzeichens (muss zwischen 0 und 9 liegen).
licensePlateCountryCode	Derzeit unterstützen wir Indonesien (ID) und Brasilien (BZ). In Zukunft werden möglicherweise weitere Unterstützungen für Indonesien (ID) und Brasilien (BZ) unterstützt. Du kannst diese Informationen proaktiv zur Verfügung stellen.

public abstrakt void setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds, intdistanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener-Listener)

Registriert einen Listener, wenn sich die verbleibende Zeit oder Entfernung zum Ziel um mehr als einen angegebenen Grenzwert ändert. Überschreibt alle zuvor registrierten Listener.

Der Listener kann beispielsweise bei einer Nutzerbewegung, einer Änderung der Verkehrslage, einer Änderung der Route, eines Ziels oder wenn die verbleibende Zeit und die verbleibende Entfernung bekannt werden.

Hinweis: Zur Vermeidung von Speicherlecks sollte clearNavProgressionListener() aufgerufen werden, wenn der Listener nicht mehr benötigt wird.

Parameter

timeChangeThresholdSeconds	Wenn die absolute Änderung in der verbleibenden Zeit in Sekunden größer oder gleich diesem Wert ist, wird der Listener aufgerufen. Dieser Grenzwert darf nicht negativ sein.
distanceChangeThresholdMeters	Wenn die absolute Änderung in der verbleibenden Entfernung in Metern größer oder gleich diesem Wert ist, wird der Listener aufgerufen. Dieser Grenzwert darf nicht negativ sein.
Listener	Listener, der registriert werden soll. Darf nicht null sein.

public abstrakt void setRouteChangedListener (Navigator.RouteChangedListener-Listener)

Registriert einen Listener für Ereignisse über geänderte Routen. Überschreibt alle zuvor registrierten Listener.

Hinweis: Zur Vermeidung von Speicherlecks sollte setNavRouteChangeListener(null) aufgerufen werden, wenn der Listener nicht mehr benötigt wird.

Parameter

Listener	Listener, der registriert werden soll. Kann auf null gesetzt werden, um einen zuvor registrierten Listener zu löschen.

public abstrakt void setSpeedingListener (SpeedingListenerspeedingListener)

Registriert einen SpeedingListener für den Prozentsatz über der Geschwindigkeitsbegrenzung, mit der der Fahrer derzeit fährt.

Wenn du einen null-SpeedingListener festlegst oder keinen Wert festlegst, erhältst du keine Daten zur Beschleunigung von Feeds.

Parameter

speedingListener

public abstrakt void startGuidance (IntentresumeIntent)

Entspricht startGuidance(), wobei jedoch ein Intent angegeben wird, mit dem die Anwendung in der Benachrichtigung der Statusleiste im Navigator fortgesetzt werden kann. Ohne diesen Intent ist es nicht möglich, die Anwendung über die Statusleiste fortzusetzen.

Parameter

resumeIntent	Intent für die Fortsetzung der Anwendung. In den meisten Fällen ist der von android.app.Activity#getIntent() zurückgegebene Wert geeignet.

public abstrakt void startGuidance ()

Wenn ein Ziel festgelegt und dafür eine Route berechnet wurde, wird die detaillierte Routenführung für die Route gestartet. Wenn noch keine Route berechnet wurde, wird danach die detaillierte Routenführung gestartet.

Sie müssen stopGuidance() explizit aufrufen, um den Navigationsdienst zu beenden. Der Navigationsdienst stoppt nicht automatisch bei der Ankunft. Wenn Sie den Navigationsdienst bei Ankunft beenden möchten, müssen Sie stopGuidance() im NavArrivalListener aufrufen.

Hinweis: Diese Methode ändert nicht die Position von Camera.

public abstrakt void stopGuidance ()

Stoppt die detaillierte Routenführung.