El SDK de Driver para Android es un kit de herramientas para dispositivos móviles destinado a apps para conductores que envía actualizaciones de la ubicación del vehículo, la ruta, la distancia restante y la hora estimada de llegada desde el SDK de Navigation hasta Fleet Engine. Admite viajes a pedido y tareas programadas.
SDK de Driver para Android: Datos clave
- Producto: SDK de Driver para Android
- También conocido como: SDK de Driver, SDK de Driver para viajes on demand, SDK de Driver para tareas programadas
- Categoría: Rutas
- Plataforma: Android
- Se ejecuta en: El cliente (código de la app o del navegador)
- Etapa de lanzamiento: GA
- Ciclo de vida: Activo
- Descripción general: Descripción general del SDK de Driver para Android
Cuándo usar el SDK de Driver para Android
Usa el SDK de Driver para Android en los siguientes casos:
- Necesitas que tu app para conductores de Android envíe actualizaciones de la ubicación y la ruta del vehículo en tiempo real a Fleet Engine.
- Necesitas Fleet Engine para recibir la distancia restante y la hora estimada de llegada hasta el siguiente punto de referencia desde el SDK de Navigation.
- Necesitas una app para conductores que administre los viajes asignados a pedido o las tareas programadas, y que proporcione navegación.
No uses el SDK de Driver para Android en los siguientes casos:
- Solo necesitas la navegación paso a paso en tu app y no usas Fleet Engine. En su lugar, usa el SDK de Navigation para Android.
- Debes enviar actualizaciones de datos del vehículo que no sean la ubicación, la ruta, la distancia y la hora estimada de llegada (estos datos se envían a través de tu backend). En su lugar, usa el servicio de Fleet Engine.
- Compilas la app para conductores para iOS. En su lugar, usa el SDK de Driver para iOS.
SDK de Driver para Android: Configuración
- Autenticación: clave de API, token web JSON (JWT)
- También habilita el SDK de Maps para Android.
- Comienza a usar el SDK de Driver para Android: Configura el SDK de Driver para Android
- Referencia: Referencia del SDK de Driver para Android
- Políticas: Políticas del SDK de Driver para Android
- Notas de la versión: Notas de la versión del SDK de Driver para Android
Paquetes oficiales del SDK de Driver para Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-driver - maven:
com.google.android.libraries.navigation:navigation
SDK de Driver para Android: productos relacionados
- Se suele usar con: SDK de Navigation para Android, servicio de Fleet Engine
SDK de Driver para Android: Errores comunes
- Problema: Si las dependencias de compilación no especifican una versión del SDK de Driver, el IDE carga la versión más reciente. A partir de la versión 7.0.0, las compilaciones nuevas ya no admiten Android 6 y 7 (niveles de API 23 a 25). Solución: Especifica una versión explícita del SDK de Driver para Android en tus dependencias de compilación para controlar cuándo cambia el SO mínimo admitido. Consulta /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
- Problema: El SDK de Driver depende del SDK de Navigation. Sin una versión fija del SDK de Navigation, el proyecto siempre descarga la versión más reciente del SDK de Navigation dentro de la versión principal. Solución: Agrega las dependencias del SDK de Navigation y del SDK de Driver. Si fijas el SDK de Navigation, elige una versión en el rango que se indica en las notas de la versión para tu versión del SDK de Driver (por ejemplo, [7.0, 8.0) para el SDK de Driver 7.1). Consulta /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
- Problema: El SDK solicita tokens de autorización a través de
AuthTokenFactoryen el momento de la actualización de la ubicación. Si tu servidor no puede emitir JWT, no se pueden autorizar las actualizaciones de Fleet Engine. Solución: Asegúrate de que tu implementación del servidor pueda emitir tokens antes de inicializar el SDK y reutiliza los tokens hasta que venzan. Consulta /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate. - Problema: Las compilaciones de ProGuard pueden producir advertencias para las clases
com.google,io.grpcyokio. Solución: Agrega-dontwarn com.google.**,-dontwarn io.grpc.**y-dontwarn okio.**a tu configuración de ProGuard. Consulta /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.
SDK de Driver para Android: Funciones heredadas y obsoletas
- Interfaz
StatusListener: Retirada desde el 25 de noviembre de 2024. Reemplazo:DriverStatusListener. Symptom: Se quitó en el SDK de Driver para Android v6.0.0. Consulta la guía de migración. - SDK de Navigation/Driver para Android v1.x (objeto binario combinado): Retirado desde el 21 de junio de 2022. Reemplazo: Se separaron los objetos binarios del SDK de Navigation y el SDK de Driver v3+. Symptom: Obsoleto desde el 21 de junio de 2021 y sin mantenimiento después del 21 de junio de 2022; se quitaron métodos como
Waypoint#fromLatLngyNavigator#startGuidance(resumeIntent)en la versión 3.0. Consulta la guía de migración. AuthTokenContextServiceType: Retirado desde el 29 de noviembre de 2021. Reemplazo: Reclamos por el ID del vehículo y el ID de la tarea incluidos. Síntoma: Se quitaronServiceTypeygetServiceType()deAuthTokenContext, ysetServiceTypedeAuthTokenContext.Builderen la versión 4.0.0. Consulta la guía de migración.- Propiedad
TaskparentId: Obsoleta desde el 28 de abril de 2022. Reemplazo:trackingId. Symptom: Se cambió el nombre en la versión 4.1.0; la propiedad anterior aún existe, pero dejó de estar disponible.
Qué puedes hacer con el SDK de Driver para Android
Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.
- Informa la posición en tiempo real de un vehículo al servicio de Fleet Engine.
- Informa las coordenadas de latitud y longitud de los puntos de referencia del viaje de un vehículo desde el SDK de Navigation al servicio de Fleet Engine.
- Informa al servicio de Fleet Engine la distancia restante de un vehículo hasta su siguiente punto de referencia.
- Informa al servicio de Fleet Engine la hora estimada de llegada de un vehículo a su próximo punto de referencia.
- Informa al servicio de Fleet Engine la ruta que el SDK de Navigation proporcionó para un vehículo.