Referencia rápida del SDK de consumidor para JavaScript

El SDK de consumidor para JavaScript permite que una aplicación para consumidores basada en la Web muestre en un mapa la ubicación de los vehículos y otras ubicaciones de interés a las que se les hace un seguimiento en Fleet Engine, de modo que los consumidores puedan seguir el progreso de un viaje a pedido o un envío programado. Se carga como la biblioteca journeySharing de la API de Maps JavaScript.

SDK de consumidor de JavaScript: Datos clave

  • Producto: SDK de JavaScript para consumidores
  • También conocido como: SDK de consumidor para JavaScript, JavaScript de viajes on demand de servicios de movilidad, SDK de JavaScript
  • Categoría: Rutas
  • Plataforma: JavaScript (navegador)
  • 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 JavaScript

SDK de consumidor de JavaScript: Cuándo usarlo

Usa el SDK de consumidor para JavaScript en los siguientes casos:

  • Debes mostrarles a los consumidores la ubicación y la ruta en tiempo real de un vehículo para un viaje a pedido del que Fleet Engine hace un seguimiento, en una página web o app web.
  • Debes permitir que los consumidores sigan el progreso de retiro o entrega de un envío programado del que se hace un seguimiento en Fleet Engine en un navegador.
  • Debes mostrar la hora estimada de llegada, la distancia restante y el tráfico en vivo en la ruta de un viaje en una vista de mapa basada en la Web.
  • Necesitas personalizar los marcadores de viaje, las polilíneas de ruta o el diseño de mapa en una vista de seguimiento del consumidor web.

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

  • Necesitas una experiencia del consumidor de seguimiento de viajes dentro de una app para Android nativa. En su lugar, usa el SDK de Consumer para Android.
  • Necesitas una experiencia del consumidor de seguimiento de viajes dentro de una app para iOS nativa. En su lugar, usa el SDK de Consumer para iOS.
  • Debes informar la ubicación del conductor y el progreso del viaje desde la app para Android del conductor a Fleet Engine. En su lugar, usa el SDK de Driver para Android.
  • Debes informar la ubicación del conductor y el progreso del viaje desde la app para iOS del conductor a Fleet Engine. En su lugar, usa el SDK de Driver para iOS.
  • Necesitas un mapa web general que no siga los viajes ni las tareas de Fleet Engine. En su lugar, usa la API de Maps JavaScript.

SDK de consumidor de JavaScript: Configuración

SDK de consumidor de JavaScript: Errores comunes

  • Problema: Si no le das al mapa de JourneySharingMapView un viewport inicial (centro y zoom), es posible que no se active el evento 'ready' del mapa. Solución: Llama a mapView.map.setCenter(...) y mapView.map.setZoom(...) después de crear la vista de mapa. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problema: Los errores de las solicitudes asíncronas de información de viajes no se arrojan. Solo llegan como eventos 'error' en el proveedor de ubicación, por lo que pasan desapercibidos, a menos que agregues un objeto de escucha. Solución: Agrega locationProvider.addListener('error', ...) y une las llamadas a la biblioteca en bloques try...catch. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problema: Las clases google.maps.journeySharing no están disponibles, a menos que cargues la biblioteca journeySharing. Solución: Agrega libraries=journeySharing a la URL de la secuencia de comandos de la API de Maps JavaScript o carga las clases con await google.maps.importLibrary("journeySharing"). Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problema: Las llamadas a Fleet Engine desde el navegador (un entorno de baja confianza) necesitan JWT que emite tu servidor de backend. Una clave de API por sí sola no autoriza el acceso a los datos de los viajes. Solución: Emite JWT desde tu backend y proporciona un authTokenFetcher que devuelva el token y expiresInSeconds. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.

SDK de Consumer para JavaScript: Funciones heredadas y obsoletas

  • Opciones de configuración de marcadores y polilíneas de JourneySharingMapView y JourneySharingMapViewOptions (vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup y otras): Obsoletas. Reemplazo: Opciones MarkerCustomizationFunction y PolylineCustomizationFunction en el proveedor de ubicación (por ejemplo, vehicleMarkerCustomization). Síntoma: Se programó su eliminación en una versión futura. Consulta la guía de migración.
  • JourneySharingMapView.locationProvider y JourneySharingMapViewOptions.locationProvider: Obsoleto. Reemplazo: JourneySharingMapView.locationProviders y JourneySharingMapViewOptions.locationProviders.
  • Propiedades de la lista de marcadores y polilíneas de JourneySharingMapView (vehicleMarkers, originMarkers, destinationMarkers, waypointMarkers, anticipatedRoutePolylines, takenRoutePolylines y propiedades de marcadores de tareas): Obsoletas. Reemplazo: Devoluciones de llamada de MarkerCustomizationFunction y PolylineCustomizationFunction en el proveedor de ubicación. Consulta la guía de migración.

Qué puedes hacer con el SDK de consumidor para JavaScript

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