FleetEngine

clase pública FleetEngine extiende Object

Un cliente de Fleet Engine de Google.

Esta clase permite que el llamador a enable y disableLocationTracking() inhabilite el seguimiento de ubicación. La frecuencia de las actualizaciones se puede controlar con setLocationReportingInterval(long, TimeUnit).

Esta clase no tiene seguridad en los subprocesos.

Resumen de clases anidadas

Interfaz	FleetEngine.AuthTokenFactory		Se solicitará a las instancias de esta interfaz que proporcionen un token de autorización cuando se ejecuten varias operaciones.
clase	FleetEngine.ErrorListener		El cliente de Fleet Engine usará instancias de esta interfaz para informar al desarrollador cuando se produzcan excepciones importantes.
Interfaz	FleetEngine.FleetEngineConfig		Esta interfaz dejó de estar disponible. hook heredado
Interfaz	FleetEngine.StatusListener		Objeto de escucha para actualizaciones de estado
enum	FleetEngine.VehicleState		Indica si un vehículo está aceptando viajes nuevos.

Resumen de métodos públicos

estático void	clearInstance() clearInstance detiene el seguimiento de ubicación, borra el estado interno y restablece el singleton de FleetEngine a nulo.
estático void	createInstance(aplicación de la aplicación, String providerId, String VehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener) Crea el singleton FleetEngine, que se puede usar para acceder al servicio de Google Fleet Engine.
estático void	createInstance(Aplicación de la aplicación, String providerId, String VehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener) Crea el singleton FleetEngine, que se puede usar para acceder al servicio de Google Fleet Engine.
void	disableLocationTracking() Detiene el seguimiento de ubicación.
void	enableLocationTracking() Comienza a subir informes de posición al backend de Fleet Engine.
FleetEngine estático	getInstance() Muestra el singleton de FleetEngine.
long	getLocationReportingIntervalMs(). Muestra el intervalo de informes de la ubicación actual en milisegundos.
boolean	isLocationTrackingEnabled() Muestra si el seguimiento de ubicación está habilitado.
estático void	setFleetEngineConfig(configuración de FleetEngine.FleetEngineConfig)
void	setLocationReportingInterval(intervalo largo, intervalo de unidades de tiempo) Establece el intervalo mínimo en el que se entregarán los informes de ubicación al backend de Fleet Engine.
estático void	setNavigator(navegador de Navigator)
void	setVehicleState(estado de FleetEngine.VehicleState) Establece el VehicleState.

Resumen de métodos heredados

Desde la clase java.lang.Object

boolean	es igual a(objeto arg0)
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
Cadena	toString()
final void	wait(long arg0, int arg1)
final void	wait(argumento largo)
final void	wait()

Métodos públicos

público estático void clearInstance ()

clearInstance detiene el seguimiento de ubicación, borra el estado interno y restablece el singleton de FleetEngine a nulo.

público estático createInstanceFleetEngine.AuthTokenFactoryFleetEngine.ErrorListener

Crea el singleton FleetEngine, que se puede usar para acceder al servicio de Google Fleet Engine. Internamente, este método obtiene un RoadSnappedLocationProvider usando getRoadSnappedLocationProvider(Application), por lo que debe obtenerse un Navigator de manera correcta antes de llamar a este método; de lo contrario, generará un IllegalStateException. Si llamas a createInstance() dos veces, se generará una IllegalStateException.

Parámetros

basada en reglas	el Application actual, no debe ser null
providerId	el ID del proveedor
vehicleId	el ID del vehículo que se conectará a Fleet Engine
authTokenFactory	el factory que proporciona tokens de autorización de Fleet Engine
errorListener	El listener que recibirá una notificación cuando se produzcan errores de cliente de Fleet Engine

Arroja

IllegalStateException	si el ID del proveedor no se especifica en AndroidManifest.xml

público estático createInstanceFleetEngine.AuthTokenFactoryFleetEngine.StatusListenerFleetEngine.ErrorListener

Crea el singleton FleetEngine, que se puede usar para acceder al servicio de Google Fleet Engine. Internamente, este método obtiene un RoadSnappedLocationProvider usando getRoadSnappedLocationProvider(Application), por lo que debe obtenerse un Navigator de manera correcta antes de llamar a este método; de lo contrario, generará un IllegalStateException. Si llamas a createInstance() dos veces, se generará una IllegalStateException.

Parámetros

basada en reglas	el Application actual, no debe ser null
providerId	el ID del proveedor.
vehicleId	el ID del vehículo que se conectará a Fleet Engine
authTokenFactory	el factory que proporciona tokens de autorización de Fleet Engine.
statusListener	para las actualizaciones de estado.
errorListener	El listener que recibirá una notificación cuando se produzcan errores de cliente de Fleet Engine

Arroja

IllegalStateException	Si el ID del proveedor no se especifica en AndroidManifest.xml.

public void disableLocationTracking ()

Detiene el seguimiento de ubicación. No se intentará detener un informe que ya esté en curso, pero no se generarán ni transmitirán nuevos informes de posición.

El seguimiento se puede reanudar después de detener la llamada a enableLocationTracking() nuevamente.

Arroja

IllegalStateException	Si ya se detuvo el seguimiento de ubicación

public void enableLocationTracking ()

Comienza a subir informes de posición al backend de Fleet Engine. Los informes se realizan periódicamente cada 5 segundos de forma predeterminada. Los informes pueden realizarse con menos frecuencia si hay problemas transitorios, como la pérdida de conectividad de red, que impidan su entrega.

Los informes de posición se realizan en un subproceso en segundo plano. Esta llamada se muestra de inmediato.

Es posible que se inhabilite el seguimiento de ubicación llamando a disableLocationTracking().

El intervalo de informes se puede cambiar con setLocationReportingInterval(long, TimeUnit).

Arroja

IllegalStateException	si el seguimiento de ubicación ya estaba habilitado

público estático FleetEngine getInstance ()

Muestra el singleton de FleetEngine. Se debe llamar a createInstance() antes de getInstance(); de lo contrario, se mostrará un valor nulo.

public long getLocationReportingIntervalMs ()

Muestra el intervalo de informes de la ubicación actual en milisegundos.

public boolean isLocationTrackingEnabled ()

Muestra si el seguimiento de ubicación está habilitado.

público estático void setFleetEngineConfig (configuración de FleetEngine.FleetEngineConfig)

Parámetros

config

público void setLocationReportingInterval (intervalo largo, intervalo de unidades de tiempo)

Establece el intervalo mínimo en el que se entregarán los informes de ubicación al backend de Fleet Engine. El intervalo de informes predeterminado es de 10 segundos. El intervalo de actualización mínimo admitido es de 5 segundos. Las actualizaciones más frecuentes pueden generar solicitudes y errores más lentos.

Parámetros

interval
intervalUnits

público estático void setNavigator (navegador de Navigator)

Parámetros

navegador

public void setVehicleState (FleetEngine.VehicleState)

Establece el VehicleState. Si las actualizaciones de ubicación están habilitadas, el valor se propagará en la próxima actualización de ubicación. Si las actualizaciones de ubicación están inhabilitadas, la actualización se activa de inmediato.

La actualización de VehicleState se realiza en un subproceso en segundo plano, por lo que esta llamada se muestra de inmediato.

Parámetros

state

Arroja

IllegalStateException	si VehicleState se establece en LÍNEA cuando el seguimiento de ubicación aún no está habilitado.