Visão geral das tarefas programadas do SDK do consumidor
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Personalize a experiência do consumidor para tarefas programadas, permitindo que os clientes acompanhem o progresso das entregas ou pedidos de serviço programados.
O que é o SDK do consumidor para tarefas programadas?
O SDK do consumidor é um recurso do Fleet Engine para tarefas programadas que também
inclui kits de ferramentas para criar a experiência do consumidor. Com eles, é possível
criar telas baseadas em mapas para visualizar o
progresso de um motorista e mostrar o status da tarefa associada a uma parada programada. Ele foi
criado para dois públicos principais:
- Usuários finais consumidores que querem saber o status da entrega de um pedido de
envio individual. Este documento mostra como implementar essa
experiência do consumidor com o SDK Consumer em JavaScript, que fornece a
classe
FleetEngineShipmentLocationProvider e interfaces associadas.
- Operadores de frota que querem rastrear o status de entrega e do veículo de uma frota inteira. Para informações sobre o rastreamento de frotas, consulte o
guia de rastreamento de frotas.
Por que usar o SDK Consumer para tarefas programadas?
Ao integrar o SDK do consumidor aos seus aplicativos de consumidor de tarefas programadas,
você oferece uma experiência abrangente ao consumidor, com atualizações de localização
quase em tempo real e posições ajustadas à via. Seus consumidores podem ver a localização do veículo de entrega e os detalhes do progresso que ajudam a entender onde está a remessa.
O que você pode fazer com o SDK Consumer?
Use o SDK Consumer para compartilhar as seguintes informações de envio com seus
consumidores:
- Posição em tempo real do veículo de entrega em um mapa.
- ETA para a chegada do pacote, ajustada para circunstâncias variáveis, como trânsito.
- Trajeto que o veículo está fazendo.
- Distância e número de paradas restantes antes da entrega.
Você também pode criar outras experiências de consumo integradas com geolocalização no seu app ou site com base nas informações de localização do SDK Driver. Para
detalhes sobre o SDK Driver, consulte a
visão geral das tarefas programadas do SDK Driver.
Componentes do SDK do consumidor
O SDK do consumidor JavaScript contém os seguintes componentes:
- Um componente de mapa JavaScript que é uma substituição direta para uma entidade
google.maps.Map padrão.
- Componentes de dados para conexão com o Fleet Engine.
- Componentes para visualização do veículo e da rota à medida que ela avança para um destino.
- Feeds de dados brutos para a ETA de um motorista ou a distância restante a ser percorrida.
A tabela a seguir descreve os componentes.
| Componente |
Descrição |
|---|
| Visualização de mapa |
A visualização do mapa ilustra o progresso do veículo, atualizando a visualização à medida que ele se move ao longo do trajeto. |
| Provedor de localização de envio |
O provedor de rastreamento de remessas fornece um feed de local para que o mapa possa mostrar informações úteis sobre a remessa, como o local de coleta ou entrega e o local e o trajeto do veículo de entrega.
|
| Buscador de tokens de autenticação |
O buscador de tokens de autenticação recebe JSON Web Tokens (JWTs) do seu
servidor de back-end para autenticar o acesso aos dados de localização armazenados no Fleet
Engine. Você implementa um buscador de tokens de autenticação como parte do seu aplicativo
da Web usando a biblioteca JavaScript Journey Sharing. Você também precisa implementar um serviço de criação de JSON Web Token (JWT) para o Fleet Engine no servidor de back-end. |
| Opções de estilo de mapa |
Você pode usar opções de estilo personalizadas para mudar o estilo padrão do mapa e combinar com o estilo do seu aplicativo da Web. |
Como usar o SDK Consumer
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-12 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-12 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)"]]
