Un client di Fleet Engine di Google.
Questa classe consente al chiamante di enable
e disableLocationTracking()
di disattivare il monitoraggio della posizione. La frequenza degli aggiornamenti può essere controllata
con setLocationReportingInterval(long, TimeUnit)
.
Questa classe non è sicura per i thread.
Riepilogo dei corsi nidificati
interfaccia | FleetEngine.AuthTokenFactory | Alle istanze di questa interfaccia verrà chiesto di fornire un token di autorizzazione quando vengono eseguite varie operazioni. | |
classe | FleetEngine.ErrorListener | Il client di Fleet Engine utilizzerà le istanze di questa interfaccia per informare lo sviluppatore quando si verificano eccezioni importanti. | |
interfaccia | FleetEngine.FleetEngineConfig | Questa interfaccia è stata ritirata. hook precedente | |
interfaccia | FleetEngine.StatusListener | Listener di aggiornamenti sullo stato. | |
enum | FleetEngine.VehicleState | Indica se un veicolo accetta nuove corse. |
Riepilogo del metodo pubblico
statico void |
clearInstance()
clearInstance interrompe il monitoraggio della posizione, cancella lo stato interno e reimposta il singleton di FleetEngine su null.
|
statico void |
createInstance(Applicazione dell'applicazione, String providerId, String VehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
Crea il singleton
FleetEngine , che può essere utilizzato per accedere al servizio Google Fleet Engine. |
statico void |
createInstance(Applicazione applicazione, String providerId, String VehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
Crea il singleton
FleetEngine , che può essere utilizzato per accedere al servizio Google Fleet Engine. |
void |
disableLocationTracking()
Interrompe il monitoraggio della posizione.
|
void |
enableLocationTracking()
Inizia a caricare i report sulle posizioni nel backend di Fleet Engine.
|
statico FleetEngine |
getInstance()
Restituisce il singleton di FleetEngine.
|
lunghi |
getLocationReportingIntervalMs()
Restituisce l'intervallo di segnalazione della posizione corrente in millisecondi.
|
boolean |
isLocationTrackingEnabled()
Indica se il monitoraggio della posizione è attivo.
|
statico void | |
void |
setLocationReportingInterval(intervallo lungo, TimeUnit intervalUnits)
Imposta l'intervallo minimo con cui i report sulle località verranno inviati al backend di Fleet Engine.
|
statico void |
setNavigator(barra di navigazione Navigatore)
|
void |
Riepilogo del metodo ereditato
Metodi pubblici
pubblici statici void clearInstance ()
clearInstance interrompe il monitoraggio della posizione, cancella lo stato interno e reimposta il singleton di FleetEngine su null.
pubblici statico void createInstance (Applicazione applicazione, String providerId, String VehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
Crea il singleton FleetEngine
, che può essere utilizzato per accedere al servizio Google Fleet Engine. Internamente, questo metodo ottiene un RoadSnappedLocationProvider
utilizzando getRoadSnappedLocationProvider(Application)
, quindi è necessario ottenere Navigator
prima di chiamare questo metodo, altrimenti produrrà un IllegalStateException
. Chiamando due volte createInstance(), si genererà un IllegalStateException
.
Parametri
applicazioni ML | l'attuale Application , non deve essere null |
---|---|
providerId | l'ID del provider |
vehicleId | L'ID del veicolo che verrà collegato a Fleet Engine |
authTokenFactory | il factory che fornisce i token di autorizzazione di Fleet Engine |
errorListener | l'listener che verrà avvisato quando si verificano errori del client di Fleet Engine |
Tiri
IllegalStateException | se l'ID provider non è specificato in AndroidManifest.xml
|
---|
pubblico statico void createInstance (Applicazione applicazione, String providerId, String VehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
Crea il singleton FleetEngine
, che può essere utilizzato per accedere al servizio Google Fleet Engine. Internamente, questo metodo ottiene un RoadSnappedLocationProvider
utilizzando getRoadSnappedLocationProvider(Application)
, quindi è necessario ottenere Navigator
prima di chiamare questo metodo, altrimenti produrrà un IllegalStateException
. Chiamando due volte createInstance(), si genererà un IllegalStateException
.
Parametri
applicazioni ML | l'attuale Application , non deve essere null . |
---|---|
providerId | l'ID del provider. |
vehicleId | L'ID del veicolo che verrà collegato a Fleet Engine |
authTokenFactory | il factory che fornisce i token di autorizzazione di Fleet Engine. |
statusListener | per gli aggiornamenti dello stato. |
errorListener | l'listener che verrà avvisato quando si verificano errori del client di Fleet Engine. |
Tiri
IllegalStateException | se l'ID provider non è specificato in AndroidManifest.xml .
|
---|
Public void disableLocationTracking ()
Interrompe il monitoraggio della posizione. Non viene fatto alcun tentativo per interrompere un report già in corso, ma non verranno generati o trasmessi nuovi report sulle posizioni.
Il monitoraggio può essere ripreso dopo l'interruzione chiamando di nuovo il numero enableLocationTracking()
.
Tiri
IllegalStateException | se il monitoraggio della posizione era già stato interrotto |
---|
Public void enableLocationTracking ()
Inizia a caricare i report sulle posizioni nel backend di Fleet Engine. I report vengono creati periodicamente, per impostazione predefinita, ogni 5 secondi. I report possono essere effettuati con minore frequenza se problemi temporanei, come la perdita di connettività di rete, ne impediscono la consegna.
I report sulla posizione vengono creati in un thread in background e questa chiamata viene restituita immediatamente.
Il monitoraggio della posizione può essere disattivato chiamando il numero disableLocationTracking()
.
L'intervallo dei report può essere modificato con setLocationReportingInterval(long, TimeUnit)
.
Tiri
IllegalStateException | se il monitoraggio della posizione era già stato attivato |
---|
statico pubblico FleetEngine getInstance ()
Restituisce il singleton di FleetEngine. createInstance() deve essere chiamato prima di getInstance(), altrimenti verrà restituito null.
Public long getLocationReportingIntervalMs ()
Restituisce l'intervallo di segnalazione della posizione corrente in millisecondi.
Public booleano isLocationTrackingEnabled ()
Indica se il monitoraggio della posizione è attivo.
pubblico statico void setFleetEngineConfig (configurazione FleetEngine.FleetEngineConfig)
Parametri
config |
---|
Public void setLocationReportingInterval (intervallo lungo, TimeUnit intervalUnits)
Imposta l'intervallo minimo con cui i report sulle località verranno inviati al backend di Fleet Engine. L'intervallo di report predefinito è 10 secondi. L'intervallo di aggiornamento minimo supportato è di 5 secondi. Aggiornamenti più frequenti possono rallentare le richieste e gli errori.
Parametri
interval | |
---|---|
intervalUnits |
pubblici void setVehicleState (stato FleetEngine.VehicleState)
Imposta il valore VehicleState. Se gli aggiornamenti della località sono abilitati, il valore verrà propagato all'aggiornamento della località successivo. Se gli aggiornamenti della posizione sono disattivati, l'aggiornamento viene attivato immediatamente.
L'aggiornamento di VehicleState viene eseguito in un thread in background e la chiamata viene restituita immediatamente.
Parametri
state |
---|
Tiri
IllegalStateException | se VehicleState è impostato su ONLINE quando il monitoraggio della posizione non è ancora abilitato. |
---|