Referencia rápida del SDK de Driver para Android

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

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: 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 AuthTokenFactory en 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.grpc y okio. 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#fromLatLng y Navigator#startGuidance(resumeIntent) en la versión 3.0. Consulta la guía de migración.
  • AuthTokenContext ServiceType: 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 quitaron ServiceType y getServiceType() de AuthTokenContext, y setServiceType de AuthTokenContext.Builder en la versión 4.0.0. Consulta la guía de migración.
  • Propiedad Task parentId: 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.