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
- Autenticación: token web JSON (JWT), clave de API
- También habilita lo siguiente: Servicio de Fleet Engine, SDK de Maps para Android
- Comienza a usar el SDK de consumidor para Android: Configura el SDK de consumidor para Android
- Referencia: Referencia del SDK de Consumer para Android
- Políticas: Políticas del SDK de Consumer para Android
- Notas de la versión: Notas de la versión del SDK de Consumer para Android
Paquetes oficiales del SDK de Consumer para Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
SDK de Consumer para Android: Productos relacionados
- Se suele usar con: Servicio de Fleet Engine, SDK de Driver para Android y SDK de Maps para Android
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-mapsdefinida de forma explícita junto contransportation-consumeren 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, enonDestroy()o cuando el viaje seaCOMPLETE. 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 aConsumerApi.getInstance()y verifica elTaskque 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=falsecuando 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
Tripy anotacionesTrip.TripStatus/Trip.TripType(yTripInfo#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. MarkerStyleOptionsyPolylineStyleOptions: Retiradas desde el 30 de noviembre de 2021. Reemplazo:MarkerOptionsyPolylineOptions(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 deMarkerOptions. 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.
- Agrega un mapa interactivo y personalizable que haga un seguimiento del progreso de un viaje desde Fleet Engine hasta una app para dispositivos móviles.
- Agrega una polilínea de ruta que haga un seguimiento de un viaje desde Fleet Engine hasta un mapa en una página web o app para dispositivos móviles.
- Actualiza el progreso de un viaje de Fleet Engine en una ruta en un mapa de una página web o una app para dispositivos móviles.
- Cambia el estilo de las rutas, las polilíneas y los polígonos en un mapa que hace un seguimiento del progreso de un viaje de Fleet Engine.
- Oculta o muestra componentes de un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine.
- Cambia el estilo de los íconos y las etiquetas de texto en un mapa que hace un seguimiento del progreso de un viaje de Fleet Engine.
- Aplica diferentes diseños de mapa a diferentes niveles de zoom en un mapa que hace un seguimiento del progreso de un viaje de Fleet Engine.
- Cambia la densidad de los lugares en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine. Experimental Nota: La compatibilidad con el diseño de mapas basado en Cloud en el SDK para consumidores tiene DG, mientras que el control de densidad de los lugares de interés es una función experimental del diseño de mapas basado en Cloud (solo se admite en los diseños de mapas claros).
- Cambia el estilo de los edificios en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine. Experimental Nota: La compatibilidad con el diseño de mapas basado en Cloud en el SDK para consumidores tiene DG, mientras que la personalización del diseño de edificios en 3D y de huellas es una función experimental del diseño de mapas basado en Cloud (solo se admite en los diseños de mapas claros).
- Cambiar el estilo de los puntos de referencia en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine Experimental Nota: La compatibilidad con el diseño de mapas basado en Cloud en el SDK de consumidor tiene DG, mientras que la personalización de íconos de puntos de referencia es una función experimental del diseño de mapas basado en Cloud (solo se admite en los diseños de mapas claros).
- Personaliza un marcador en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine.
- Personaliza la polilínea de la ruta en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine.