Referencia rápida del SDK de Consumer para Android

El SDK de consumidor para Android forma parte de Fleet Engine para viajes on demand. Proporciona interfaces que modelan los datos de los viajes y los siguen en Fleet Engine, y clases para crear una visualización basada en mapas que comparte el progreso de un viaje (ubicación del vehículo, ruta, hora estimada de llegada, distancia restante, tráfico) con los consumidores en una app para Android.

SDK de consumidor para Android: Datos clave

  • Producto: SDK de Consumer para Android
  • También conocido como: SDK de consumidores para Android, SDK de consumidores, SDK de consumidores para Android de viajes on demand de los servicios de movilidad
  • 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 consumidor para Android

Cuándo usar el SDK de consumidor para Android

Usa el SDK de Consumer para Android en los siguientes casos:

  • Necesitas que los consumidores de tu app para Android sigan un viaje on demand (viaje, pedido o entrega) del que tu backend hace un seguimiento en Fleet Engine.
  • Debes mostrar la ubicación y la ruta de un vehículo casi en tiempo real y ajustadas a la ruta en un mapa en una aplicación para consumidores de Android.
  • Debes mostrar la hora estimada de llegada de la recogida y la entrega, la distancia restante y el tráfico en tiempo real para un viaje de Fleet Engine en Android.
  • Necesitas personalizar los marcadores de viaje, las polilíneas de ruta o el diseño de mapa para un mapa de uso compartido del recorrido en Android.

No uses el SDK de consumidor para Android en los siguientes casos:

  • Necesitas compartir el recorrido para los viajes on demand en una app para iOS. En su lugar, usa el SDK de Consumer para iOS.
  • Necesitas compartir el recorrido en una página web o realizar un seguimiento de las tareas programadas, como los envíos, para los consumidores. En su lugar, usa el SDK de consumidor para JavaScript.
  • Debes informar la ubicación del conductor y el progreso del viaje desde la app para Android del conductor. En su lugar, usa el SDK de Driver para Android.

SDK de consumidor para Android: Configuración

Paquetes oficiales del SDK de Consumer para Android:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

SDK para consumidores para Android: Errores comunes

  • Problema: Si la dependencia del SDK de Maps no se establece en una versión explícita, el SDK para consumidores usa la versión mínima requerida del SDK de Maps, lo que puede provocar fallas en las apps que dependen de funciones de versiones posteriores del SDK de Maps. Solución: Declara una versión de play-services-maps definida de forma explícita junto con transportation-consumer en Gradle o Maven. Consulta /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project.
  • Problema: No detener el uso compartido del recorrido después de que finaliza un viaje genera solicitudes de red innecesarias a Fleet Engine y fugas de memoria. Solución: Llama a JourneySharingSession.stop() cuando ya no se necesite el viaje, por ejemplo, en onDestroy() o cuando el viaje sea COMPLETE. Consulta /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey.
  • Problema: ConsumerApi.initialize() arroja una excepción si ya existe una instancia de la API (2.0.0 y versiones posteriores). Solución: Primero, llama a ConsumerApi.getInstance() y verifica el Task que se muestra para determinar si ya existe una instancia. Consulta /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android.
  • Problema: El SDK de consumidor v3 y versiones anteriores no admiten el modo R8 completo. Las apps que se orientan al AGP 8.0 y versiones posteriores pueden tener problemas de compilación o de tiempo de ejecución. Solución: Establece android.enableR8.fullMode=false cuando se oriente a AGP 8.0 o versiones posteriores, y usa AGP 7.3 o versiones posteriores con Kotlin 2.0 para el SDK de consumidor 3.0 o versiones posteriores. Consulta /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.

SDK para consumidores para Android: Funciones heredadas y obsoletas

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: Retirado desde el 15 de septiembre de 2023. Reemplazo: TripModel, TripModelCallback, TripModelManager, TripModelOptions. Consulta la guía de migración.
  • Clase Trip y anotaciones Trip.TripStatus / Trip.TripType (y TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): Obsoleta desde el 15 de septiembre de 2023. Reemplazo: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. Consulta la guía de migración.
  • MarkerStyleOptions y PolylineStyleOptions: Retiradas desde el 30 de noviembre de 2021. Reemplazo: MarkerOptions y PolylineOptions (compartido con el SDK de Maps). Síntoma: El SDK de consumidor aplica su propio estilo predeterminado por marcador o tipo de polilínea, no los valores predeterminados de MarkerOptions. Consulta la guía de migración.
  • Canal de distribución de repositorio privado: Obsoleto. Reemplazo: Repositorio de Maven de Google (versiones 2.1.0 y posteriores) Consulta la guía de migración.

Qué puedes hacer con el SDK de consumidor para Android

Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.