Descripción general de las tareas programadas del SDK de consumidor
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Personaliza la experiencia del consumidor para las tareas programadas permitiendo que los consumidores sigan el progreso de sus pedidos de entrega o servicio programados.
¿Qué es el SDK de Consumer para tareas programadas?
El SDK para el consumidor es una función de Fleet Engine para tareas programadas que también incluye kits de herramientas para crear la experiencia del consumidor. Estos kits de herramientas te permiten crear pantallas basadas en mapas para visualizar el progreso de un conductor y mostrar el estado de la tarea asociada con una parada programada. Está diseñado para dos públicos principales:
- Usuarios finales consumidores que desean conocer el estado de entrega de un pedido de envío individual. En este documento, se explica cómo implementar esa experiencia del consumidor con el SDK de Consumer en JavaScript, que proporciona la clase
FleetEngineShipmentLocationProvider y las interfaces asociadas.
- Operadores de flotas que desean hacer un seguimiento del estado de la entrega y del vehículo de toda una flota. Para obtener información sobre el seguimiento de flotas, consulta la guía de seguimiento de flotas.
¿Por qué usar el SDK de Consumer para tareas programadas?
Integrar el SDK de Consumer en las aplicaciones de consumidor de tareas programadas te permite brindar una experiencia integral al consumidor, con actualizaciones de ubicación casi en tiempo real y posiciones ajustadas a la ruta. Tus clientes pueden ver la ubicación del vehículo de entrega y los detalles del progreso que los ayudan a comprender dónde está su envío.
¿Qué puedes hacer con el SDK de Consumer?
Usa el SDK de Consumer para compartir la siguiente información de envío con tus clientes:
- Posición en tiempo real del vehículo de reparto en un mapa.
- Hora estimada de llegada del paquete, ajustada según las circunstancias cambiantes, como el tráfico.
- Ruta que está tomando el vehículo.
- La distancia y la cantidad de paradas restantes antes de que se entregue el envío.
También puedes crear otras experiencias del consumidor fluidas y habilitadas para la ubicación dentro de tu app o sitio web para el consumidor en función de la información de ubicación del SDK de Driver. Para obtener detalles sobre el SDK de Driver, consulta la descripción general de las tareas programadas del SDK de Driver.
Componentes del SDK para el consumidor
El SDK de JavaScript Consumer contiene los siguientes componentes:
- Es un componente de mapa de JavaScript que reemplaza directamente una entidad
google.maps.Map estándar.
- Son los componentes de datos para conectarse con Fleet Engine.
- Componentes para visualizar el vehículo y la ruta a medida que avanza hacia un destino.
- Feeds de datos sin procesar para la ETA de un conductor o la distancia restante por conducir.
En la siguiente tabla, se describen los componentes.
| Componente |
Descripción |
|---|
| Vista de mapa |
La vista del mapa ilustra el progreso del vehículo y actualiza la vista a medida que el vehículo avanza por su ruta. |
| Proveedor de ubicación del envío |
El proveedor de seguimiento de envíos proporciona un feed de ubicación para que el mapa pueda mostrar información útil sobre el envío, como la ubicación de retiro o entrega, y la ubicación y la ruta del vehículo de entrega.
|
| Recuperador de tokens de autenticación |
El captador de tokens de autenticación obtiene tokens web JSON (JWT) de tu servidor de backend para autenticar el acceso a los datos de ubicación almacenados en Fleet Engine. Implementas un buscador de tokens de autenticación como parte de tu aplicación web con la biblioteca de JavaScript de Journey Sharing. Ten en cuenta que también debes implementar un servicio de creación de tokens web JSON (JWT) para Fleet Engine en tu servidor de backend. |
| Opciones de diseño de mapa |
Puedes usar opciones de diseño personalizadas para cambiar el diseño predeterminado de tu mapa y que coincida con el diseño de tu aplicación web. |
Cómo usar el SDK para consumidores
¿Qué sigue?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 2025-08-31 (UTC)"],[[["\u003cp\u003eThe Consumer SDK enables businesses to provide customers with real-time visibility into the location and progress of their scheduled deliveries or service orders.\u003c/p\u003e\n"],["\u003cp\u003eThis SDK offers tools for creating map-based displays within consumer applications, showing the driver's location, estimated time of arrival, and route information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can integrate the Consumer SDK to create a comprehensive and seamless delivery tracking experience for their customers, improving transparency and satisfaction.\u003c/p\u003e\n"],["\u003cp\u003eKey components of the SDK include a map view, a location provider, authentication mechanisms, and customizable styling options to tailor the experience.\u003c/p\u003e\n"],["\u003cp\u003eTo begin, developers need to set up the JavaScript Consumer SDK, follow a specific shipment for tracking, and customize the map interface as desired.\u003c/p\u003e\n"]]],[],null,["Tailor the consumer experience for scheduled tasks by allowing consumers to\nfollow the progress of their scheduled deliveries or service orders.\n\nWhat is the Consumer SDK for scheduled tasks?\n\nThe Consumer SDK is a feature of Fleet Engine for scheduled tasks that also\nincludes toolkits to create the consumer experience. These toolkits let you\ncreate map-based displays to visualize a driver's\nprogress and show the status of the task associated with a scheduled stop. It's\ndesigned for two primary audiences:\n\n- **Consumer end users** who want to know delivery status for an individual shipment order. This document covers how to implement that consumer experience with the Consumer SDK in JavaScript, which provides the `FleetEngineShipmentLocationProvider` class and associated interfaces.\n- **Fleet operators** who want to track the delivery and vehicle status for an entire fleet of vehicles. For information about tracking fleets, see the [Fleet tracking guide](/maps/documentation/mobility/operations/fleet-tracking).\n\nWhy use the Consumer SDK for scheduled tasks?\n\nIntegrating the Consumer SDK into your scheduled tasks consumer applications\nlets you provide a comprehensive consumer experience, with near real-time\nlocation updates and road-snapped positions. Your consumers can see the delivery\nvehicle's location and progress details that help them understand where their\nshipment is.\n\nWhat can you do with the Consumer SDK?\n\nUse the Consumer SDK to share the following shipment information with your\nconsumers:\n\n- Delivery vehicle's real-time position on a map.\n- ETA for package arrival, adjusted for changing circumstances, such as traffic.\n- Route the vehicle is taking.\n- Distance and number of stops remaining before their shipment is delivered.\n\nYou can also create other seamless geo-enabled consumer experiences inside your\nconsumer app or website based on location information from the Driver SDK. For\ndetails about the Driver SDK, see the\n[Driver SDK scheduled tasks overview](/maps/documentation/mobility/driver-sdk/scheduled).\n\nConsumer SDK components\n\nThe JavaScript Consumer SDK contains the following components:\n\n- A JavaScript map component that is a drop-in replacement for a standard `google.maps.Map` entity.\n- Data components to connect with Fleet Engine.\n- Components for visualization of the vehicle and route as it progresses to a destination.\n- Raw data feeds for a driver's ETA or the remaining distance to drive.\n\nThe following table describes the components.\n\n| Component | Description |\n|------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Map view | The map view illustrates the progress of the vehicle, updating the view as the vehicle moves along its route. |\n| Shipment location provider | The shipment tracking provider provides a location feed so that the map can display useful information about the shipment, such as the pickup or delivery location of the shipment and the location and route of the delivery vehicle. |\n| Authentication token fetcher | The authentication token fetcher gets JSON Web Tokens (JWTs) from your backend server to authenticate access to the location data stored in Fleet Engine. You implement an authentication token fetcher as part of your web application using the JavaScript Journey Sharing Library. Note that you must also implement a JSON Web Token (JWT) creation service for Fleet Engine on your backend server. |\n| Map style options | You can use custom styling options to change the default styling of your map to match the styling of your web application. |\n\nHow to use the Consumer SDK\n\n|---|----------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Set up the JavaScript Consumer SDK** | For more information, see [Set up the JavaScript Consumer SDK](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/setup). |\n| 2 | **Follow a shipment** | Learn how to initialize the map, start following a shipment, and stop following with appropriate clean up. See [Follow a shipment](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/follow). |\n| 3 | **Customize the map interface** | You can use the JavaScript Consumer SDK for scheduled tasks to customize the map interface, provide marker customization, or style polylines. See [Style a map](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/style-map), [Customize markers](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/customize-markers), and [Customize polylines](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/customize-polylines). |\n\nWhat's next\n\n- [Set up the JavaScript Consumer SDK](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/setup)"]]
