Personalizza l'esperienza dei consumatori per i viaggi on demand consentendo loro 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, nonché classi che puoi utilizzare per creare una visualizzazione ricca 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 dei consumatori.
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 per i viaggi on demand 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 il percorso del veicolo sovrapposto a una mappa, inclusi i dettagli sullo stato di avanzamento che li aiutano a capire dove si trova la loro corsa o consegna.
Cosa puoi fare con l'SDK consumer?
Puoi utilizzare le informazioni di Driver SDK e Fleet Engine per creare esperienze dei consumatori personalizzate, incluse le seguenti funzionalità:
Personalizzare l'interfaccia utente della mappa in base alle esigenze del tuo brand.
Seguire la posizione attuale del veicolo mentre percorre il percorso, con la posizione aggiornata periodicamente.
Mostra l'orario di arrivo stimato (ETA) 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 sul percorso e condividono le sessioni di viaggio nell'app per utenti finali.
L'SDK consumer fornisce anche altre interfacce e classi in modo che tu possa creare un'esperienza con l'app ricca con dettagli come traffico, indicatori della mappa, orario di arrivo stimato e dati del percorso.
Questa tabella mostra il flusso di un viaggio seguito da un'app per utenti finali.
| 1 | L'app per utenti finali 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 per utenti finali richiede l'accesso per seguire il viaggio | L'app per utenti finali 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 lo stato di avanzamento con l'app per utenti finali. |
| 6 | L'app per utenti finali mostra le informazioni sul viaggio | L'app per utenti finali 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 per utenti finali 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 per utenti finali.
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 dei consumatori. 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 lo stato di 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 lo stato di 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 dei consumatori. 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 lo stato di 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 lo stato di 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 dei consumatori. 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 lo stato di 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 e seguire lo stato di 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 dei consumatori 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 tuo server. Per saperne di più, consulta Emettere token JWT.
Implementare un recupero del token di autenticazione nelle tue 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 tappe, nonché feed di dati non elaborati per l'orario di arrivo stimato 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 punti di riferimento 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 lo stato di 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 punti di riferimento e veicoli, descritti nella tabella seguente.
| Posizione monitorata | Descrizione |
|---|---|
| Località di prelievo | La località di prelievo è la località in cui inizia un viaggio. |
| Località di destinazione | La località di destinazione è la località in cui termina un viaggio. Indica la località di destinazione. |
| Località della tappa | Una località del punto di riferimento è qualsiasi località intermedia lungo il percorso di un viaggio monitorato. Sebbene tecnicamente parlando i punti di riferimento possano includere località di prelievo e destinazione, in genere si riferiscono a fermate intermedie lungo il percorso. Ad esempio, le fermate tra le località di prelievo e destinazione su un percorso di consegna sono località di punti di riferimento. Per saperne di più, consulta Punti di riferimento del 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. |
Definire lo stile delle mappe
Gli stili degli indicatori e delle 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.
Controllare 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 punti di riferimento vengono sempre visualizzati sulla mappa. Ad esempio, una località di destinazione di un viaggio o una località di consegna di una spedizione viene sempre visualizzata sulla mappa, indipendentemente dallo stato del viaggio o della consegna.
Passaggi successivi
Consulta la documentazione per la piattaforma su cui vuoi seguire i viaggi: