Parco risorse

classe pubblica FleetEngine estendere Object

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
setVehicleState(stato FleetEngine.VehicleState)
Imposta il valore VehicleState.

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

Public static void setNavigator (Navigatore navigator)

Parametri
navigatore

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.