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
- Autenticación: clave de API, token web JSON (JWT)
- También habilita lo siguiente: API de Maps JavaScript, servicio de Fleet Engine
- Atribución de uso: ID de transacción de movilidad opcional (beta): Establece
google.maps.Settings.getInstance().experienceIdsen un array de IDs de transacción de movilidad (o IDs relacionados) antes de crear unJourneySharingMapView.experienceIdssolo está disponible en el canalv=betade la API de Maps JavaScript. - Comienza a usar el SDK de consumidor para JavaScript: Configura el SDK de consumidor para JavaScript
- Referencia: Referencia del SDK de consumidor para JavaScript
- Notas de la versión: Notas de la versión del SDK de consumidor para JavaScript
SDK de consumidor de JavaScript: productos relacionados
- Se suele usar con: Servicio de Fleet Engine, API de Maps JavaScript, SDK de Driver para Android, SDK de Driver para iOS
SDK de consumidor de JavaScript: Errores comunes
- Problema: Si no le das al mapa de
JourneySharingMapViewun viewport inicial (centro y zoom), es posible que no se active el evento'ready'del mapa. Solución: Llama amapView.map.setCenter(...)ymapView.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: AgregalocationProvider.addListener('error', ...)y une las llamadas a la biblioteca en bloquestry...catch. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problema: Las clases
google.maps.journeySharingno están disponibles, a menos que cargues la bibliotecajourneySharing. Solución: Agregalibraries=journeySharinga la URL de la secuencia de comandos de la API de Maps JavaScript o carga las clases conawait 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
authTokenFetcherque devuelva el token yexpiresInSeconds. 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
JourneySharingMapViewyJourneySharingMapViewOptions(vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetupy otras): Obsoletas. Reemplazo: OpcionesMarkerCustomizationFunctionyPolylineCustomizationFunctionen 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.locationProvideryJourneySharingMapViewOptions.locationProvider: Obsoleto. Reemplazo:JourneySharingMapView.locationProvidersyJourneySharingMapViewOptions.locationProviders.- Propiedades de la lista de marcadores y polilíneas de
JourneySharingMapView(vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylinesy propiedades de marcadores de tareas): Obsoletas. Reemplazo: Devoluciones de llamada deMarkerCustomizationFunctionyPolylineCustomizationFunctionen 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.
- 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.