Personalizza l'esperienza dei consumatori per le corse on demand consentendo loro di seguire la corsa per un ordine, una corsa o un altro servizio che offri.
Che cos'è l'SDK per i consumatori?
L'SDK consumer fa parte di Fleet Engine per i viaggi on demand. Fornisce interfacce che modellano i dati dei viaggi e seguono i viaggi in Fleet Engine, nonché classi che utilizzi per creare una visualizzazione completa basata su mappe per condividere i percorsi con i tuoi utenti consumer. Per creare questa esperienza consumer, devi integrare l'SDK consumer nella tua app e impostare i profili dei ruoli appropriati in Fleet Engine.
Le API specifiche della piattaforma dell'SDK Consumer ti consentono di creare la possibilità di condividere i percorsi 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 tue 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 basate sulla strada. I tuoi consumatori possono vedere il percorso del veicolo sovrapposto a una mappa, inclusi i dettagli sull'avanzamento che li aiutano a capire dove si trova la corsa o la consegna.
Che cosa puoi fare con l'SDK Consumer?
Puoi utilizzare le informazioni dell'SDK Driver e di Fleet Engine per creare esperienze personalizzate per i consumatori, tra cui le seguenti funzionalità:
Personalizza l'interfaccia utente della mappa in base alle tue esigenze di branding.
Segui la posizione attuale del veicolo mentre si sposta lungo il percorso, con la posizione aggiornata periodicamente.
Mostra l'orario di arrivo stimato (ETA) per le località di ritiro e consegna.
Mostra la distanza rimanente.
Mostra il traffico in tempo reale sul percorso.
Come funziona l'SDK Consumer
A livello generale, l'SDK Consumer si basa sui seguenti meccanismi:
- Avere i ruoli di 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 la corsa, fornita dal sistema di backend.
- Le classi SDK
TripModeleJourneySharingSessionche modellano i dati dei percorsi e condividono le sessioni dei percorsi nell'app per i consumatori.
L'SDK Consumer fornisce anche altre interfacce e classi per consentirti di creare un'esperienza con app completa con dettagli come traffico, indicatori sulla mappa, orario di arrivo stimato e dati sul percorso.
Questa tabella mostra il flusso di un viaggio seguito da un'app per consumatori.
| 1 | L'app per i consumatori richiede un viaggio | Il server di backend riceve una richiesta di corsa on demand ed esegue quanto segue:
|
| 2 | Il conducente accetta la corsa | L'app del conducente riceve l'ID e le informazioni sulla corsa e il conducente accetta la corsa. |
| 3 | L'app per i consumatori richiede l'accesso per seguire il viaggio | L'app per i consumatori recupera l'ID corsa dal tuo backend e richiede di iniziare a seguire la corsa. |
| 4 | Il conducente avvia il viaggio | Quando il conducente utilizza l'app per indicare che la corsa è iniziata, l'app invia una notifica al server di backend tramite l'SDK Driver. Ad esempio, quando il conducente sta per lasciare il ristorante o si sta dirigendo verso il luogo di ritiro. |
| 5 | Fleet Engine inizia a inviare le informazioni sui viaggi | Fleet Engine inizia a monitorare il viaggio e a condividere il suo avanzamento con l'app del consumatore. |
| 6 | L'app per i consumatori mostra le informazioni sulla corsa | L'app per i consumatori invia una notifica al consumatore e inizia a mostrare le informazioni sulla corsa, aggiornandola man mano che procede. |
| 7 | La corsa è annullata o completata | Quando il conducente annulla o completa la corsa, l'app del conducente disattiva il monitoraggio della posizione e il server di backend indica a Fleet Engine di contrassegnare la corsa come annullata o completata. |
| 8 | L'app per i consumatori smette di seguire il viaggio | La corsa viene visualizzata come annullata o completata. |
| 9 | La procedura viene ripetuta per il viaggio successivo | Viene creato un nuovo viaggio e il processo si ripete. |
Come utilizzare l'SDK consumer
Seleziona la tua piattaforma per scoprire come iniziare a seguire i viaggi nelle tue app per consumatori.
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ù, vedi Ottenere l'SDK Consumer per Android. |
| 2 | Configurare l'interfaccia visiva | Definisci una mappa e aggiungi il supporto delle mappe vettoriali per configurare l'esperienza del consumatore. Per ulteriori informazioni, vedi Configurare una mappa. |
| 3 | Seguire una corsa | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per ulteriori informazioni, vedi Seguire un viaggio. |
| 5 | Aggiornare l'avanzamento della corsa e gestire gli errori | Aggiorna i dettagli dei tuoi viaggi, ad esempio la distanza percorsa e l'orario di arrivo stimato, e gestisci eventuali errori durante un viaggio. Per ulteriori informazioni, consulta Aggiornare lo stato di avanzamento della corsa e Gestire gli errori relativi alla corsa. |
| 5 | Interrompere il monitoraggio al termine di una corsa | Interrompi il monitoraggio di un viaggio per interrompere la condivisione della posizione di un veicolo con il consumatore. Per ulteriori informazioni, vedi Interrompere il monitoraggio di una corsa. |
iOS
| 1 | Configurare l'SDK Consumer in iOS | Per seguire i viaggi on demand nella tua app, configura l'SDK Consumer. Per ulteriori informazioni, consulta la sezione Ottenere l'SDK per i consumatori per iOS. |
| 2 | Configurare l'interfaccia visiva | Inizializza la visualizzazione della mappa e gestisci gli eventi della mappa per configurare l'esperienza del consumatore. Per ulteriori informazioni, vedi Configurare una mappa. |
| 3 | Seguire una corsa | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per ulteriori informazioni, vedi Seguire un viaggio. |
| 5 | Aggiornare l'avanzamento della corsa e gestire gli errori | Aggiorna i dettagli dei tuoi viaggi, ad esempio la distanza percorsa e l'orario di arrivo stimato, e gestisci eventuali errori durante un viaggio. Per ulteriori informazioni, consulta Aggiornare lo stato di avanzamento della corsa e Gestire gli errori relativi alla corsa. |
| 5 | Interrompere il monitoraggio al termine di una corsa | Interrompi il monitoraggio di un viaggio per interrompere la condivisione della posizione di un veicolo con il consumatore. Per ulteriori informazioni, vedi Interrompere il monitoraggio di una corsa. |
JavaScript
| 1 | Configurare l'SDK Consumer in JavaScript | Per seguire i viaggi on demand nella tua app, configura l'SDK Consumer. Per ulteriori informazioni, consulta Configurare l'SDK Consumer JavaScript. |
| 2 | Caricare e personalizzare una mappa | Attiva l'API Maps JavaScript e configura l'autorizzazione per configurare l'esperienza del consumatore. Per ulteriori informazioni, vedi Configurare una mappa. |
| 3 | Seguire una corsa | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per ulteriori informazioni, vedi Seguire un viaggio. |
| 5 | Aggiornare l'avanzamento della corsa e gestire gli errori | Aggiorna i dettagli dei tuoi viaggi, ad esempio la distanza percorsa e l'orario di arrivo stimato, e gestisci eventuali errori durante un viaggio. Per ulteriori informazioni, consulta Aggiornare e monitorare l'avanzamento del viaggio e Gestire gli errori relativi ai viaggi. |
| 5 | Interrompere il monitoraggio al termine di una corsa | Interrompi il monitoraggio di un viaggio per interrompere la condivisione della posizione di un veicolo con il consumatore. Per ulteriori informazioni, vedi Interrompere il monitoraggio di una corsa. |
Componenti
Questa sezione riassume i due componenti necessari per seguire un viaggio:
Se vuoi, puoi anche personalizzare l'esperienza dei consumatori con questi componenti:
Retrieval del token di autenticazione
Per controllare l'accesso ai dati sulla posizione memorizzati in Fleet Engine, devi svolgere i seguenti passaggi:
Implementa un servizio di creazione di token web JSON (JWT) per Fleet Engine sul tuo server. Per ulteriori informazioni, consulta Emettere JWT.
Implementa un'apposita funzionalità nelle tue app web o mobile per autenticare l'accesso ai dati sulla posizione. Per ulteriori informazioni sulla configurazione di un recupero token, consulta la guida alla configurazione per Android, iOS o JavaScript.
Visualizzazione mappa e tracker dei viaggi
Il monitoraggio di un viaggio include componenti per la visualizzazione di veicoli e waypoint, nonché feed di dati non elaborati per l'orario di arrivo stimato di un conducente o la distanza rimanente da percorrere.
La seguente tabella descrive questi componenti:
| Componente | Descrizione |
|---|---|
| Visualizzazione mappa per i consumatori | 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 il polilinea del percorso del veicolo per indicare lo stato di avanzamento del veicolo lungo il percorso. |
| Fornitore di posizione del viaggio in JavaScript | Per le app web JavaScript, il fornitore della posizione della corsa inserisce le informazioni sulla posizione degli oggetti monitorati nella mappa della corsa condivisa. Per ulteriori informazioni, consulta Creare un'istanza di un fornitore di località di viaggio.
Puoi utilizzare il fornitore di dati sulla posizione del viaggio per monitorare i seguenti dettagli di un
viaggio:
|
Oggetti posizione monitorata
Il fornitore di servizi di geolocalizzazione monitora la posizione di oggetti come waypoint e veicoli, descritti nella tabella seguente.
| Posizione monitorata | Descrizione |
|---|---|
| Luogo di ritiro | La stazione di partenza è la stazione di partenza di un viaggio. |
| Località di destinazione | La località di destinazione è la località in cui termina un viaggio. Indica il punto di consegna. |
| Posizione del waypoint | La posizione di una tappa è qualsiasi posizione intermedia lungo il percorso di un viaggio monitorato. Anche se tecnicamente i waypoint possono includere punti di ritiro e di consegna, in genere si riferiscono a fermate intermedie lungo il percorso. Ad esempio, le fermate tra le località di ritiro e di destinazione su un percorso di consegna sono posizioni di waypoint. Per ulteriori informazioni, consulta Waypoint di viaggio nella documentazione di Fleet Engine. |
| Posizione del veicolo | La posizione del veicolo è la posizione segnalata di un veicolo. Per ulteriori informazioni, consulta Posizione del veicolo nella documentazione di Fleet Engine. |
Definire lo stile delle mappe
Gli stili di indicatori e polilinee determinano l'aspetto degli oggetti Posizione monitorata sulla mappa. Puoi utilizzare opzioni di stile personalizzate per abbinare lo stile della tua applicazione web.
Controllare la visibilità delle località monitorate
I fornitori di dati sulla posizione predefiniti in Fleet Engine rispettano queste regole di visibilità per gli oggetti posizione monitorati sulla mappa. Se crei un fornitore di posizione personalizzato o derivato, puoi modificare le regole di visibilità.
I veicoli sono visibili solo quando la corsa è in corso: un veicolo di una corsa è visibile dal momento in cui viene assegnato a una corsa fino al momento del rilascio. Se la corsa viene annullata, il veicolo non è più visibile.
Tutti gli altri indicatori di posizione sono sempre visibili: tutti gli altri indicatori di posizione per partenza, destinazione e punti di passaggio vengono sempre visualizzati sulla mappa. Ad esempio, la località di consegna di un viaggio o di una spedizione viene sempre mostrata sulla mappa, indipendentemente dallo stato del viaggio o della consegna.
Passaggi successivi
Consulta la documentazione della piattaforma su cui vuoi seguire i viaggi: