Logo: FleetEngine

öffentliche Klasse FleetEngine erweitert Objekt

Ein Client für die Fleet Engine von Google.

Diese Klasse ermöglicht dem Anrufer, dass enable und disableLocationTracking() die Standortermittlung deaktivieren. Die Häufigkeit der Updates kann mit setLocationReportingInterval(long, TimeUnit) gesteuert werden.

Diese Klasse ist nicht Thread-sicher.

Zusammenfassung für geschachtelte Klassen

Oberfläche	FleetEngine.AuthTokenFactory		Instanzen dieser Schnittstelle werden bei verschiedenen Vorgängen aufgefordert, ein Autorisierungstoken anzugeben.
Klasse	FleetEngine.ErrorListener		Der Fleet Engine-Client verwendet Instanzen dieser Schnittstelle, um den Entwickler über wichtige Ausnahmen zu informieren.
Oberfläche	FleetEngine.FleetEngineConfig		Diese Benutzeroberfläche wurde eingestellt. Legacy-Hook
Oberfläche	FleetEngine.StatusListener		Listener für Statusaktualisierungen
enum	FleetEngine.VehicleState		Gibt an, ob ein Fahrzeug neue Fahrten akzeptiert.

Public Method Summary

Static void	clearInstance() ClearInstance beendet die Standortverfolgung, löscht den internen Status und setzt das FleetEngine Singleton-Objekt auf null zurück.
Static void	createInstance(Anwendungsanwendung, String-Anbieter-ID, String Fahrzeug-ID, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener) Erstellt das Singleton FleetEngine, mit dem auf den Google Fleet Engine-Dienst zugegriffen werden kann.
Static void	createInstance(Anwendung, String providerId, String FahrzeugId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener) Erstellt das Singleton FleetEngine, mit dem auf den Google Fleet Engine-Dienst zugegriffen werden kann.
void	disableLocationTracking() Beendet die Standortermittlung.
void	enableLocationTracking() Laden Sie Positionsberichte in das Fleet Engine-Back-End hoch.
statisch FleetEngine	getInstance() Gibt das FleetEngine-Singleton zurück.
long	getLocationReportingIntervalMs() Gibt das aktuelle Intervall für Standortberichte in Millisekunden zurück.
boolean	isLocationTrackingEnabled() Gibt an, ob die Standortermittlung aktiviert ist.
Static void	setFleetEngineConfig(FleetEngine.FleetEngineConfig-Konfiguration)
void	setLocationReportingInterval(langes Intervall, TimeUnitIntervalUnits) Legt das Mindestintervall fest, in dem Standortberichte an das Fleet Engine-Back-End gesendet werden.
Static void	setNavigator(Navigator Navigator)
void	setVehicleState(FleetEngine.VehicleState-Status) Legt den VehicleState fest.

Inherited Method Summary

Aus Klasse java.lang.Object

boolean	equals(Objekt arg0)
finaler Kurs<?>	getClass()
int	hashCode()
endgültige Gültigkeit	notify()
endgültige Gültigkeit	notifyAll()
String	toString()
endgültige Gültigkeit	wait(long arg0, int arg1)
endgültige Gültigkeit	wait(long arg0)
endgültige Gültigkeit	wait()

Public Methods

public static void clearInstance ()

ClearInstance beendet die Standortverfolgung, löscht den internen Status und setzt das FleetEngine Singleton-Objekt auf null zurück.

public static void createInstance (Anwendungsanwendung, String-Anbieter-ID, String-Fahrzeug-ID, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)

Erstellt das Singleton FleetEngine, mit dem auf den Google Fleet Engine-Dienst zugegriffen werden kann. Intern ruft diese Methode eine RoadSnappedLocationProvider mithilfe von getRoadSnappedLocationProvider(Application) ab, sodass vor dem Aufruf dieser Methode ein Navigator erfolgreich abgerufen werden muss. Andernfalls wird ein IllegalStateException ausgelöst. Ein zweimaliger Aufruf von createInstance() führt zu einem IllegalStateException.

Parameter

Anwendungen	die aktuelle Application, darf nicht null sein
providerId	ID des Anbieters
vehicleId	Die ID des Fahrzeugs, das mit der Fleet Engine verbunden wird
authTokenFactory	factory, die Fleet Engine-Autorisierungstokens bereitstellt
errorListener	listener, der benachrichtigt wird, wenn Fleet Engine-Clientfehler auftreten

Löst aus

IllegalStateException	Anbieter-ID ist nicht in AndroidManifest.xml angegeben

public static void createInstance (Anwendungsanwendung, String-Anbieter-ID, String-Fahrzeug-ID, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)

Erstellt das Singleton FleetEngine, mit dem auf den Google Fleet Engine-Dienst zugegriffen werden kann. Intern ruft diese Methode eine RoadSnappedLocationProvider mithilfe von getRoadSnappedLocationProvider(Application) ab, sodass vor dem Aufruf dieser Methode ein Navigator erfolgreich abgerufen werden muss. Andernfalls wird ein IllegalStateException ausgelöst. Ein zweimaliger Aufruf von createInstance() führt zu einem IllegalStateException.

Parameter

Anwendungen	die aktuelle Application, darf nicht null sein.
providerId	Die ID des Anbieters.
vehicleId	Die ID des Fahrzeugs, das mit der Fleet Engine verbunden wird
authTokenFactory	Die factory, die Fleet Engine-Autorisierungstokens bereitstellt.
statusListener	Listener für Statusaktualisierungen.
errorListener	Die listener, die benachrichtigt wird, wenn Fleet Engine-Clientfehler auftreten.

Löst aus

IllegalStateException	Anbieter-ID ist nicht in AndroidManifest.xml angegeben.

public void disableLocationTracking ()

Beendet die Standortermittlung. Es wird nicht versucht, einen laufenden Bericht zu stoppen. Es werden jedoch keine neuen Positionsberichte generiert oder übertragen.

Das Tracking kann nach dem Beenden fortgesetzt werden, indem Sie enableLocationTracking() noch einmal aufrufen.

Löst aus

IllegalStateException	Die Standortermittlung wurde bereits angehalten.

public void enableLocationTracking ()

Laden Sie Positionsberichte in das Fleet Engine-Back-End hoch. Berichte werden in regelmäßigen Abständen erstellt, standardmäßig alle 5 Sekunden. Berichte werden möglicherweise seltener erstellt, wenn vorübergehende Probleme wie der Verlust der Netzwerkverbindung die Zustellung von Berichten verhindern.

Positionsberichte werden in einem Hintergrundthread erstellt. Dieser Aufruf wird sofort zurückgegeben.

Die Standortermittlung kann durch Aufrufen von disableLocationTracking() deaktiviert werden.

Das Berichtsintervall kann mit setLocationReportingInterval(long, TimeUnit) geändert werden.

Löst aus

IllegalStateException	wenn die Standortermittlung bereits aktiviert war.

public static FleetEngine getInstance ()

Gibt das FleetEngine-Singleton zurück. createInstance() muss vor getInstance() aufgerufen werden. Andernfalls wird null zurückgegeben.

public long getLocationReportingIntervalMs ()

Gibt das aktuelle Intervall für Standortberichte in Millisekunden zurück.

public boolesch isLocationTrackingEnabled ()

Gibt an, ob die Standortermittlung aktiviert ist.

public static void setFleetEngineConfig (FleetEngine.FleetEngineConfig-Konfiguration)

Parameter

config

public void setLocationReportingInterval (langes Intervall, TimeUnitIntervalUnits)

Legt das Mindestintervall fest, in dem Standortberichte an das Fleet Engine-Back-End gesendet werden. Das Standardintervall für Berichte beträgt 10 Sekunden. Das Mindestintervall für Updates beträgt 5 Sekunden. Häufigere Updates können zu langsameren Anfragen und Fehlern führen.

Parameter

interval
intervalUnits

public static void setNavigator (Navigator navigator)

Parameter

navigator

public void setVehicleState (FleetEngine.VehicleState Zustand)

Legt den VehicleState fest. Wenn Standortaktualisierungen aktiviert sind, wird der Wert beim nächsten Standortupdate weitergegeben. Sind Standortaktualisierungen deaktiviert, wird die Aktualisierung sofort ausgelöst.

Die VehicleState-Aktualisierung erfolgt in einem Hintergrundthread. Dieser Aufruf wird sofort zurückgegeben.

Parameter

state

Löst aus

IllegalStateException	wenn VehicleState auf ONLINE gesetzt ist und die Standortermittlung noch nicht aktiviert ist.