Panoramica delle attività pianificate dell'SDK per i consumatori
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Personalizza l'esperienza dei consumatori per le attività pianificate consentendo loro di
seguire l'avanzamento delle consegne o degli ordini di servizio pianificati.
Che cos'è l'SDK Consumer per le attività pianificate?
L'SDK consumer è una funzionalità di Fleet Engine per le attività pianificate che include anche
toolkit per creare l'esperienza del consumatore. Questi toolkit ti consentono di
creare visualizzazioni basate su mappe per visualizzare l'avanzamento di un autista
e mostrare lo stato dell'attività associata a una fermata programmata. È
progettato per due segmenti di pubblico principali:
- Utenti finali consumatori che vogliono conoscere lo stato di consegna di un singolo
ordine di spedizione. Questo documento spiega come implementare questa
esperienza del consumatore con l'SDK Consumer in JavaScript, che fornisce la
classe
FleetEngineShipmentLocationProvider e le interfacce associate.
- Operatori di flotte che vogliono monitorare lo stato di consegna e del veicolo per un'intera flotta di veicoli. Per informazioni sul monitoraggio delle flotte, consulta la
guida al monitoraggio delle flotte.
Perché utilizzare il Consumer SDK per le attività pianificate?
L'integrazione dell'SDK Consumer nelle applicazioni consumer per le attività pianificate
ti consente di offrire un'esperienza completa ai consumatori, con aggiornamenti della posizione quasi in tempo reale
e posizioni allineate alla strada. I tuoi consumatori possono vedere la posizione e i dettagli di avanzamento del veicolo di consegna, che li aiutano a capire dove si trova la spedizione.
Che cosa puoi fare con l'SDK per i consumatori?
Utilizza l'SDK per i consumatori per condividere le seguenti informazioni sulla spedizione con i tuoi
consumatori:
- Posizione in tempo reale del veicolo di consegna su una mappa.
- Orario di arrivo stimato del pacco, corretto in base a circostanze variabili, ad esempio
il traffico.
- Il percorso che sta seguendo il veicolo.
- Distanza e numero di fermate rimanenti prima della consegna della spedizione.
Puoi anche creare altre esperienze di consumo geolocalizzate e fluide all'interno della tua
app o del tuo sito web per i consumatori in base alle informazioni sulla posizione dell'SDK Driver. Per
informazioni dettagliate sull'SDK Driver, consulta la
panoramica delle attività pianificate dell'SDK Driver.
Componenti dell'SDK consumer
L'SDK JavaScript Consumer contiene i seguenti componenti:
- Un componente mappa JavaScript che sostituisce un'entità
google.maps.Map standard.
- Componenti di dati da connettere a Fleet Engine.
- Componenti per la visualizzazione del veicolo e del percorso man mano che si avvicina a una
destinazione.
- Feed di dati non elaborati per l'ETA di un autista o la distanza rimanente da percorrere.
La tabella seguente descrive i componenti.
| Componente |
Descrizione |
|---|
| Visualizzazione mappa |
La visualizzazione della mappa mostra l'avanzamento del veicolo, aggiornando la visualizzazione man mano che il veicolo si sposta lungo il percorso. |
| Fornitore della posizione della spedizione |
Il fornitore di monitoraggio delle spedizioni fornisce un feed di posizione in modo che
la mappa possa mostrare informazioni utili sulla spedizione, come il luogo di ritiro
o di consegna della spedizione e la posizione e l'itinerario
del veicolo di consegna.
|
| Recupero del token di autenticazione |
Il recuperatore di token di autenticazione riceve i token JWT (JSON Web Token) dal server di backend per autenticare l'accesso ai dati sulla posizione archiviati in Fleet Engine. Implementi un recuperatore di token di autenticazione come parte della tua applicazione web utilizzando la libreria JavaScript per la condivisione del viaggio. Tieni presente che devi
implementare anche un servizio di creazione di token JWT (JSON Web Token) per Fleet Engine sul tuo
server di backend. |
| Opzioni di stile della mappa |
Puoi utilizzare le opzioni di stile personalizzato per modificare lo stile predefinito della mappa in modo che corrisponda allo stile della tua applicazione web. |
Come utilizzare l'SDK consumer
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 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)"]]
