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 |
Resumen de métodos heredados
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 |
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. |
---|