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 loro.
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 e fornisce classi che utilizzi per creare una visualizzazione avanzata basata su mappe per condividere i viaggi con i tuoi utenti consumer. Integra l'SDK consumer nella tua app e imposta i profili dei ruoli appropriati in Fleet Engine per creare questa esperienza per i 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 per i consumatori è disponibile per le seguenti piattaforme:
Perché utilizzare il Consumer SDK?
L'integrazione del Consumer SDK nelle tue applicazioni di 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 di avanzamento che li aiutano a capire dove si trova la corsa o la consegna.
Che cosa puoi fare con l'SDK per i consumatori?
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 esigenze del tuo brand.
Segui la posizione attuale del veicolo mentre percorre l'itinerario, con la sua posizione aggiornata periodicamente.
Mostra l'orario di arrivo stimato per le località di prelievo e rilascio.
Mostra la distanza rimanente.
Mostra il traffico in tempo reale sul percorso.
Come funziona l'SDK Consumer
A livello generale, l'SDK per i consumatori 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 backend.
- Le classi SDK
TripModeleJourneySharingSessionche modellano i dati dei viaggi e condividono le sessioni di viaggio nell'app consumer.
L'SDK Consumer fornisce anche altre interfacce e classi per consentirti di creare un'esperienza app completa con dettagli come traffico, indicatori della mappa, ETA e dati del percorso.
Questa tabella mostra il flusso di un viaggio seguito da un'app per i consumatori.
| 1 | L'app per i consumatori richiede una corsa | Il server di backend riceve una richiesta di viaggio on demand ed esegue le
seguenti operazioni:
|
| 2 | L'autista accetta la corsa | L'app per i conducenti riceve l'ID corsa e le informazioni sulla corsa e l'autista accetta la corsa. |
| 3 | L'app per i consumatori richiede l'accesso per seguire il viaggio | L'app per i consumatori riceve l'ID viaggio dal tuo backend e richiede di iniziare a seguire il viaggio. |
| 4 | L'autista inizia la corsa | Quando l'autista utilizza l'app per autisti per indicare che la corsa è iniziata, l'app invia una notifica al server di backend tramite l'SDK Driver. Ad esempio, quando l'autista sta per uscire dal ristorante o guidare fino al punto di ritiro. |
| 5 | Fleet Engine inizia a inviare le informazioni sul viaggio | Fleet Engine inizia a monitorare il viaggio e a condividere i suoi progressi con l'app per i consumatori. |
| 6 | L'app per i consumatori mostra le informazioni sul viaggio | L'app per i consumatori invia una notifica al consumatore e inizia a mostrare le informazioni sul viaggio, aggiornandole man mano che il viaggio procede. |
| 7 | Il viaggio è stato annullato o completato | Quando l'autista annulla o completa la corsa, l'app autista disattiva il monitoraggio della posizione e il tuo 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 | Il processo si ripete 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 i consumatori.
Android
| 1 | Configurare l'SDK Consumer in Android | Per seguire le corse on demand nella tua app, configura l'SDK Consumer. Per saperne di più, consulta Scaricare l'SDK Android Consumer. |
| 2 | Configurare l'interfaccia visiva | Definisci una mappa e aggiungi il supporto per le mappe vettoriali per configurare l'esperienza dei consumatori. 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, come la distanza percorsa e l'orario di arrivo stimato, e gestisci eventuali errori durante un viaggio. Per ulteriori informazioni, vedi Aggiornare l'avanzamento del viaggio e Gestire gli errori del viaggio. |
| 5 | Al termine di una corsa, smetti di seguirla | Smetti di seguire un viaggio per interrompere la condivisione della posizione di un veicolo con il tuo consumatore. Per ulteriori informazioni, vedi Interrompere il monitoraggio di un viaggio. |
iOS
| 1 | Configurare l'SDK Consumer in iOS | Per seguire le corse on demand nella tua app, configura l'SDK Consumer. Per saperne di più, consulta la pagina Scaricare l'SDK Consumer per iOS. |
| 2 | Configurare l'interfaccia visiva | Inizializza la visualizzazione della mappa e gestisci gli eventi della mappa per configurare l'esperienza dei consumatori. 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, come la distanza percorsa e l'orario di arrivo stimato, e gestisci eventuali errori durante un viaggio. Per ulteriori informazioni, vedi Aggiornare l'avanzamento del viaggio e Gestire gli errori del viaggio. |
| 5 | Al termine di una corsa, smetti di seguirla | Smetti di seguire un viaggio per interrompere la condivisione della posizione di un veicolo con il tuo consumatore. Per ulteriori informazioni, vedi Interrompere il monitoraggio di un viaggio. |
JavaScript
| 1 | Configurare l'SDK Consumer in JavaScript | Per seguire le corse on demand nella tua app, configura l'SDK Consumer. Per maggiori informazioni, consulta Configurare l'SDK Consumer JavaScript. |
| 2 | Caricare e personalizzare una mappa | Attiva l'API Maps JavaScript e configura l'autorizzazione per impostare l'esperienza dei consumatori. 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, come la distanza percorsa e l'orario di arrivo stimato, e gestisci eventuali errori in un viaggio. Per ulteriori informazioni, vedi Aggiornare e seguire l'avanzamento del viaggio e Gestire gli errori relativi ai viaggi. |
| 5 | Al termine di una corsa, smetti di seguirla | Smetti di seguire un viaggio per interrompere la condivisione della posizione di un veicolo con il tuo consumatore. Per ulteriori informazioni, vedi Interrompere il monitoraggio di un viaggio. |
Componenti
Questa sezione riassume due componenti necessari per seguire un viaggio:
Se vuoi, puoi anche personalizzare la tua esperienza di consumatore con questi componenti:
Recupero del token di autenticazione
Per controllare l'accesso ai dati sulla posizione memorizzati in Fleet Engine, devi:
Implementa un servizio di creazione di token web JSON (JWT) per Fleet Engine sul tuo server. Per saperne di più, consulta Emettere JWT.
Implementa un programma di recupero dei token di autenticazione nelle tue app web o mobile per autenticare l'accesso ai dati sulla posizione. Per ulteriori informazioni sulla configurazione di un token fetcher, consulta la guida alla configurazione per Android, iOS o JavaScript.
Visualizzazione mappa e tracker di viaggio
Il monitoraggio di una corsa include componenti per la visualizzazione di veicoli e waypoint, nonché feed di dati non elaborati per l'ETA di un conducente o la distanza rimanente da percorrere.
La tabella seguente 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 della mappa aggiorna la polilinea del percorso del veicolo per indicare l'avanzamento del veicolo lungo il percorso. |
| Fornitore di posizione del viaggio in JavaScript | Per le app web JavaScript, il fornitore di posizioni del viaggio inserisce le informazioni sulla posizione degli oggetti monitorati nella mappa del viaggio condivisa. Per ulteriori
informazioni, vedi
Creare un'istanza di un fornitore di località di viaggio.
Puoi utilizzare il fornitore di posizione del viaggio per monitorare i seguenti dettagli di un viaggio:
|
Oggetti di posizione monitorata
Il fornitore di servizi di localizzazione monitora la posizione di oggetti come waypoint e veicoli, descritti nella tabella seguente.
| Posizione monitorata | Descrizione |
|---|---|
| Luogo di ritiro | La posizione di partenza è il punto in cui inizia una corsa. |
| Località di destinazione | La posizione di destinazione è il luogo in cui termina un viaggio. Indica il punto di discesa. |
| Posizione del waypoint | Una posizione di waypoint è qualsiasi posizione intermedia lungo il percorso di un viaggio monitorato. Anche se tecnicamente i waypoint possono includere le località di partenza e arrivo, in genere si riferiscono a fermate intermedie lungo il percorso. Ad esempio, le fermate tra i luoghi di ritiro e di destinazione su un percorso di consegna sono posizioni di waypoint. Per saperne di più, consulta Tappe del 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. |
Personalizzare lo stile delle 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.
Controllare la visibilità delle posizioni 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 servizi di localizzazione 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 riconsegna. 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 tappe intermedie vengono sempre visualizzati sulla mappa. Ad esempio, la destinazione 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: