Personalizza l'esperienza del consumatore per i viaggi on demand consentendo ai consumatori di seguire il viaggio per un ordine, una corsa o un altro servizio che fornisci.
Che cos'è l'SDK consumer?
L'SDK consumer fa parte di Fleet Engine per i viaggi on demand. Fornisce interfacce che modellano i dati di viaggio e seguono i viaggi in Fleet Engine e fornisce classi che puoi utilizzare per creare una visualizzazione avanzata basata su mappa per condividere i viaggi con i tuoi utenti consumatori. Integra l'SDK consumer nella tua app e imposta i profili di ruolo appropriati in Fleet Engine per creare questa esperienza del consumatore.
Le API specifiche della piattaforma dell'SDK consumer ti consentono di integrare la funzionalità di condivisione dei viaggi in modo nativo nelle tue applicazioni. L'SDK consumer è disponibile per le seguenti piattaforme:
Perché utilizzare l'SDK consumer?
L'integrazione dell'SDK consumer nelle applicazioni di viaggi on demand ti consente di offrire un'esperienza completa al consumatore, con aggiornamenti della posizione quasi in tempo reale e posizioni allineate alla strada. I tuoi consumatori possono vedere il percorso del veicolo sovrapposto a una mappa, inclusi i dettagli di avanzamento che li aiutano a capire dove si trova la loro corsa o consegna.
Che cosa puoi fare con l'SDK consumer?
Puoi utilizzare le informazioni di Driver SDK e Fleet Engine per creare esperienze personalizzate per i consumatori, tra cui le seguenti funzionalità:
Personalizzare l'interfaccia utente della mappa in base alle esigenze di branding.
Seguire la posizione attuale del veicolo mentre percorre il percorso, con la posizione aggiornata periodicamente.
Mostrare l'orario di arrivo previsto (ATE) per le località di prelievo e destinazione.
Mostrare la distanza rimanente.
Mostrare il traffico in tempo reale sul percorso.
Come funziona l'SDK consumer
A livello generale, l'SDK consumer si basa sui seguenti meccanismi:
- Disporre dei ruoli Fleet Engine appropriati in modo che un'app autenticata possa seguire il viaggio associato all'ordine di un consumatore.
- Un'associazione tra il consumatore e il viaggio, fornita dal tuo sistema di backend.
- Le classi SDK
TripModeleJourneySharingSessionche modellano i dati di viaggio e condividono le sessioni di viaggio nell'app consumer.
L'SDK consumer fornisce anche altre interfacce e classi in modo che tu possa creare un'esperienza app avanzata completa di dettagli come traffico, indicatori della mappa, ATE e dati del percorso.
Questa tabella mostra il flusso di un viaggio seguito da un'app consumer.
| 1 | L'app consumer richiede un viaggio | Il server di backend riceve una richiesta di viaggio on demand ed esegue le
seguenti operazioni:
|
| 2 | L'autista accetta il viaggio | L'app per gli autisti riceve l'ID viaggio e le informazioni sul viaggio e l'autista accetta il viaggio. |
| 3 | L'app consumer richiede l'accesso per seguire il viaggio | L'app consumer riceve l'ID viaggio dal tuo backend e richiede di iniziare a seguire il viaggio. |
| 4 | L'autista inizia il viaggio | Quando l'autista utilizza l'app per gli autisti per indicare che il viaggio è iniziato, l'app invia una notifica al server di backend tramite Driver SDK. Ad esempio, quando l'autista sta per lasciare il ristorante o guidare verso la località di prelievo. |
| 5 | Fleet Engine inizia a inviare informazioni sul viaggio | Fleet Engine inizia a monitorare il viaggio e a condividere i suoi progressi con l'app consumer. |
| 6 | L'app consumer mostra le informazioni sul viaggio | L'app consumer invia una notifica al consumatore e inizia a mostrargli le informazioni sul viaggio, aggiornandolo man mano che procede. |
| 7 | Il viaggio viene annullato o completato | Quando l'autista annulla o completa il viaggio, l'app per gli autisti disattiva il monitoraggio della posizione e il server di backend indica a Fleet Engine di contrassegnare il viaggio come annullato o completato. |
| 8 | L'app consumer smette di seguire il viaggio | Il viaggio viene visualizzato come annullato o completato. |
| 9 | La procedura si ripete per il viaggio successivo | Viene creato un nuovo viaggio e la procedura si ripete. |
Come utilizzare l'SDK consumer
Seleziona la tua piattaforma per scoprire come iniziare a seguire i viaggi nelle tue app consumer.
Android
| 1 | Configurare l'SDK consumer in Android | Per seguire i viaggi on demand nella tua app, configura l'SDK consumer. Per saperne di più, consulta Scaricare l'SDK consumer per Android. |
| 2 | Configurare l'interfaccia visiva | Definisci una mappa e aggiungi il supporto per le mappe vettoriali per configurare l'esperienza del consumatore. Per saperne di più, consulta Configurare una mappa. |
| 3 | Seguire un viaggio | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per saperne di più, consulta Seguire un viaggio. |
| 5 | Aggiornare l'avanzamento del viaggio e gestire gli errori del viaggio | Aggiorna i dettagli dei tuoi viaggi, come la distanza percorsa e l'orario di arrivo previsto, e gestisci eventuali errori durante un viaggio. Per saperne di più, consulta Aggiornare l'avanzamento del viaggio e Gestire gli errori del viaggio. |
| 5 | Quando un viaggio è completato, smetti di seguirlo | Smetti di seguire un viaggio per interrompere la condivisione della posizione di un veicolo con il consumatore. Per saperne di più, consulta Smettere di seguire un viaggio. |
iOS
| 1 | Configurare l'SDK consumer in iOS | Per seguire i viaggi on demand nella tua app, configura l'SDK consumer. Per saperne di più, consulta Scaricare l'SDK consumer per iOS. |
| 2 | Configurare l'interfaccia visiva | Inizializza la visualizzazione mappa e gestisci gli eventi della mappa per configurare l'esperienza del consumatore. Per saperne di più, consulta Configurare una mappa. |
| 3 | Seguire un viaggio | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per saperne di più, consulta Seguire un viaggio. |
| 5 | Aggiornare l'avanzamento del viaggio e gestire gli errori del viaggio | Aggiorna i dettagli dei tuoi viaggi, come la distanza percorsa e l'orario di arrivo stimato, e gestisci eventuali errori durante un viaggio. Per saperne di più, consulta Aggiornare l'avanzamento del viaggio e Gestire gli errori del viaggio. |
| 5 | Quando un viaggio è completato, smetti di seguirlo | Smetti di seguire un viaggio per interrompere la condivisione della posizione di un veicolo con il consumatore. Per saperne di più, consulta Smettere di seguire un viaggio. |
JavaScript
| 1 | Configurare l'SDK consumer in JavaScript | Per seguire i viaggi on demand nella tua app, configura l'SDK consumer. Per saperne di più, consulta Configurare l'SDK consumer per JavaScript. |
| 2 | Caricare e personalizzare una mappa | Attiva l'API Maps JavaScript e configura l'autorizzazione per configurare l'esperienza del consumatore. Per saperne di più, consulta Configurare una mappa. |
| 3 | Seguire un viaggio | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per saperne di più, consulta Seguire un viaggio. |
| 5 | Aggiornare l'avanzamento del viaggio e gestire gli errori del viaggio | Aggiorna i dettagli dei tuoi viaggi, come la distanza percorsa e l'orario di arrivo previsto, e gestisci eventuali errori durante un viaggio. Per saperne di più, consulta Aggiornare e seguire l'avanzamento del viaggio e Gestire gli errori del viaggio. |
| 5 | Quando un viaggio è completato, smetti di seguirlo | Smetti di seguire un viaggio per interrompere la condivisione della posizione di un veicolo con il consumatore. Per saperne di più, consulta Smettere di seguire un viaggio. |
Componenti
Questa sezione riassume due componenti necessari per seguire un viaggio:
Facoltativamente, puoi anche personalizzare l'esperienza del consumatore con questi componenti:
Recupero del token di autenticazione
Per controllare l'accesso ai dati sulla posizione archiviati in Fleet Engine, devi:
Implementare un servizio di creazione di token JWT (JSON Web Token) per Fleet Engine sul server. Per saperne di più, consulta Emettere token JWT.
Implementare un recupero del token di autenticazione nelle app web o mobile per autenticare l'accesso ai dati sulla posizione. Per saperne di più sulla configurazione di un recupero del token, consulta la guida alla configurazione per Android, iOS, o JavaScript.
Visualizzazione mappa e tracker di viaggio
Seguire un viaggio include componenti per la visualizzazione di veicoli e waypoint, nonché feed di dati non elaborati per l'ATE di un autista o la distanza rimanente da percorrere.
La tabella seguente descrive questi componenti:
| Componente | Descrizione |
|---|---|
| Visualizzazione mappa consumer | La visualizzazione mappa gestisce il ciclo di vita di un viaggio, mostrando i waypoint per la posizione dei veicoli man mano che il viaggio procede. Se il percorso di un veicolo è noto, la visualizzazione mappa aggiorna la polilinea del percorso del veicolo per indicare l'avanzamento del veicolo lungo il percorso. |
| Fornitore di posizioni di viaggio in JavaScript | Per le app web JavaScript, il fornitore di posizioni di viaggio inserisce le informazioni sulla posizione degli oggetti monitorati nella mappa di viaggio condivisa. Per saperne di più, consulta
Creare un'istanza di un fornitore di posizioni di viaggio.
Puoi utilizzare il fornitore di posizioni di viaggio per monitorare i seguenti dettagli di un viaggio:
|
Oggetti di posizione monitorati
Il fornitore di posizioni monitora la posizione di oggetti come waypoint e veicoli, descritti nella tabella seguente.
| Posizione monitorata | Descrizione |
|---|---|
| Luogo di ritiro | Il luogo di ritiro è il luogo in cui inizia un viaggio. |
| Località di destinazione | La località di destinazione è il luogo in cui termina un viaggio. Indica il luogo di destinazione. |
| Posizione del waypoint | Una posizione del waypoint è qualsiasi posizione intermedia lungo il percorso di un viaggio monitorato. Anche se tecnicamente i waypoint possono includere luoghi di prelievo e destinazione, in genere si riferiscono a fermate intermedie lungo il percorso. Ad esempio, le fermate tra il luogo di ritiro e la località di destinazione su un percorso di consegna sono posizioni del waypoint. Per saperne di più, consulta Waypoint di viaggio nella documentazione di Fleet Engine. |
| Posizione del veicolo | La posizione del veicolo è la posizione segnalata di un veicolo. Per saperne di più, consulta Posizione del veicolo nella documentazione di Fleet Engine. |
Applica uno stile alle mappe
Gli stili di indicatori e polilinee determinano l'aspetto degli oggetti di posizione monitorati sulla mappa. Puoi utilizzare opzioni di stile personalizzate per adattare lo stile della tua applicazione web.
Controlla la visibilità delle località monitorate
I fornitori di posizioni predefiniti in Fleet Engine seguono queste regole di visibilità per gli oggetti di posizione monitorati sulla mappa. Se crei un fornitore di posizioni personalizzato o derivato, puoi modificare le regole di visibilità.
I veicoli sono visibili solo quando il viaggio è in corso: un veicolo di viaggio è visibile dal momento in cui viene assegnato a un viaggio fino al momento della destinazione. Se il viaggio viene annullato, il veicolo non è più visibile.
Tutti gli altri indicatori di posizione sono sempre visibili: tutti gli altri indicatori di posizione per origine, destinazione e waypoint vengono sempre visualizzati sulla mappa. Ad esempio, un luogo di destinazione di un viaggio o un luogo di consegna di una spedizione viene sempre visualizzato sulla mappa, indipendentemente dallo stato del viaggio o della consegna.
Passaggi successivi
Consulta la documentazione per la piattaforma su cui vuoi seguire i viaggi: