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 |
Inherited Method Summary
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 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. |
---|