Personalizza l'esperienza del consumatore per i percorsi on demand consentendogli di seguire il percorso di un ordine, di una corsa o di un altro servizio che gli fornisci.
Che cos'è l'SDK Consumer?
L'SDK Consumer fa parte di Fleet Engine per i percorsi on demand. Fornisce interfacce che modellano i dati dei percorsi e seguono i percorsi in Fleet Engine, nonché classi che utilizzi per creare una visualizzazione dettagliata basata su mappa per condividere i percorsi con i tuoi utenti consumer. Per creare questa esperienza per i consumatori, 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 funzionalità di condivisione dei 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 corse on-demand ti consente di offrire un'esperienza completa ai consumatori, con aggiornamenti della posizione quasi in tempo reale e posizioni agganciate alla strada. I 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.
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 la UI 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 i luoghi 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 percorso associato all'ordine di un consumatore.
- Un'associazione tra il consumatore e la corsa, fornita dal tuo sistema di backend.
- Le classi SDK
TripModeleJourneySharingSessionche modellano i dati del percorso e condividono le sessioni del percorso nell'app per utenti finali.
L'SDK Consumer fornisce anche altre interfacce e classi per consentirti di creare un'esperienza con l'app completa di dettagli come traffico, indicatori sulla mappa, ora di arrivo stimata e dati sul percorso.
Questa tabella mostra il flusso di un percorso seguito da un'app per utenti finali.
| 1 | L'app per utenti finali richiede una corsa | Il tuo server di backend riceve una richiesta di corsa on demand ed esegue le seguenti operazioni:
|
| 2 | Il conducente accetta la corsa | L'app per i conducenti riceve l'ID e le informazioni sulla corsa e il conducente accetta la corsa. |
| 3 | L'app per utenti finali richiede l'accesso per seguire il percorso | L'app per utenti finali riceve l'ID corsa dal tuo backend e richiede di iniziare a seguire la corsa. |
| 4 | Il conducente inizia la corsa | Quando il conducente utilizza l'app per conducenti per indicare che la corsa è iniziata, l'app invia una notifica al tuo 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 informazioni sulla corsa | Fleet Engine inizia a monitorare la corsa e a condividere i suoi progressi con l'app per utenti finali. |
| 6 | L'app per utenti finali mostra le informazioni sulla corsa | L'app per utenti finali invia una notifica al consumatore e inizia a mostrare le informazioni sulla corsa, aggiornandole man mano che la corsa procede. |
| 7 | La corsa è stata annullata o completata | Quando il conducente annulla o completa la corsa, l'app per i conducenti 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 utenti finali smette di seguire il percorso | La corsa risulta annullata o completata. |
| 9 | Il processo si ripete per la corsa successiva | Viene creato un nuovo percorso e il processo si ripete. |
Come utilizzare l'SDK Consumer
Seleziona la tua piattaforma per scoprire come iniziare a seguire i percorsi nelle tue app per utenti finali.
Android
| 1 | Configura l'SDK Consumer in Android | Per seguire i percorsi on demand nella tua app, configura l'SDK Consumer. Per saperne di più, consulta Scarica l'SDK Consumer per Android. |
| 2 | Configura l'interfaccia visiva | Definisci una mappa e aggiungi il supporto per le mappe vettoriali per configurare l'esperienza utente. Per saperne di più, consulta Configura una mappa. |
| 3 | Segui un percorso | Segui un percorso per condividere la posizione del veicolo appropriato con il consumatore. Per saperne di più, consulta Segui un percorso. |
| 5 | Aggiorna l'avanzamento della corsa e gestisci gli errori della corsa | Aggiorna i dettagli dei tuoi percorsi, come la distanza di viaggio e l'orario di arrivo stimato, e gestisci eventuali errori durante un percorso. Per saperne di più, consulta Aggiorna l'avanzamento del percorso e Gestisci gli errori del percorso. |
| 5 | Interrompi il monitoraggio al termine di un percorso | Interrompi il monitoraggio di un percorso per interrompere la condivisione della posizione di un veicolo con il consumatore. Per saperne di più, consulta Interrompi il monitoraggio di un percorso. |
iOS
| 1 | Configura l'SDK Consumer in iOS | Per seguire i percorsi on demand nella tua app, configura l'SDK Consumer. Per saperne di più, consulta Scarica l'SDK Consumer per iOS. |
| 2 | Configura l'interfaccia visiva | Inizializza la visualizzazione della mappa e gestisci gli eventi della mappa per configurare l'esperienza del consumatore. Per saperne di più, consulta Configura una mappa. |
| 3 | Segui un percorso | Segui un percorso per condividere la posizione del veicolo appropriato con il consumatore. Per saperne di più, consulta Segui un percorso. |
| 5 | Aggiorna l'avanzamento della corsa e gestisci gli errori della corsa | Aggiorna i dettagli dei tuoi percorsi, come la distanza di viaggio e l'orario di arrivo stimato, e gestisci eventuali errori durante un percorso. Per saperne di più, consulta Aggiorna l'avanzamento del percorso e Gestisci gli errori del percorso. |
| 5 | Interrompi il monitoraggio al termine di un percorso | Interrompi il monitoraggio di un percorso per interrompere la condivisione della posizione di un veicolo con il consumatore. Per saperne di più, consulta Interrompi il monitoraggio di un percorso. |
JavaScript
| 1 | Configura l'SDK Consumer in JavaScript | Per seguire i percorsi on demand nella tua app, configura l'SDK Consumer. Per saperne di più, consulta Configura l'SDK Consumer JavaScript. |
| 2 | Carica e personalizza una mappa | Abilita l'API Maps JavaScript e configura l'autorizzazione per configurare l'esperienza del consumatore. Per saperne di più, consulta Configura una mappa. |
| 3 | Segui un percorso | Segui un percorso per condividere la posizione del veicolo appropriato con il consumatore. Per saperne di più, consulta Segui un percorso. |
| 5 | Aggiorna l'avanzamento della corsa e gestisci gli errori della corsa | Aggiorna i dettagli dei tuoi percorsi, come la distanza di viaggio e l'orario di arrivo stimato, e gestisci eventuali errori durante un percorso. Per saperne di più, consulta Aggiorna e segui l'avanzamento del percorso e Gestisci gli errori del percorso. |
| 5 | Interrompi il monitoraggio al termine di un percorso | Interrompi il monitoraggio di un percorso per interrompere la condivisione della posizione di un veicolo con il consumatore. Per saperne di più, consulta Interrompi il monitoraggio di un percorso. |
Componenti
Questa sezione riassume due componenti necessari per seguire un percorso:
Se vuoi, puoi anche personalizzare l'esperienza dei consumatori con questi componenti:
Strumento di recupero dei token di autenticazione
Per controllare l'accesso ai dati sulla posizione archiviati 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 Emetti JWT.
Implementa un recuperatore di 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 recuperatore di token, consulta la guida alla configurazione per Android, iOS o JavaScript.
Visualizzazione mappa e tracker dei viaggi
Il monitoraggio di una corsa 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 tabella seguente descrive questi componenti:
| Componente | Descrizione |
|---|---|
| Visualizzazione mappa dei consumatori | La visualizzazione mappa gestisce il ciclo di vita di una corsa, mostrando i waypoint per la posizione dei veicoli man mano che la corsa 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. |
| Provider di località del percorso in JavaScript | Per le app web JavaScript, il provider di località del percorso inserisce i dati sulla posizione degli oggetti monitorati nella mappa del percorso condiviso. Per saperne di più, consulta Crea un'istanza di un provider di località per la corsa.
Puoi utilizzare il provider di località del percorso per monitorare i seguenti dettagli di un percorso:
|
Oggetti di posizione monitorati
Il provider di posizione monitora la posizione di oggetti come waypoint e veicoli, descritti nella tabella seguente.
| Posizione monitorata | Descrizione |
|---|---|
| Luogo di ritiro | La località di partenza è la località in cui inizia una corsa. |
| Località di destinazione | La località di destinazione è la località in cui termina una corsa. Contrassegna il punto di arrivo. |
| Posizione del waypoint | Una posizione di waypoint è una qualsiasi posizione intermedia lungo il percorso di un viaggio monitorato. Anche se, tecnicamente, i waypoint possono includere luoghi di partenza e di arrivo, 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 località dei waypoint. Per saperne di più, consulta Waypoint del percorso 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. |
Definisci lo stile delle mappe
Gli stili degli indicatori e delle polilinee determinano l'aspetto degli oggetti della posizione monitorata sulla mappa. Puoi utilizzare le opzioni di stile personalizzate per adattarle allo stile della tua applicazione web.
Controlla la visibilità delle località monitorate
I provider di località predefiniti in Fleet Engine seguono queste regole di visibilità per gli oggetti di località monitorati sulla mappa. Se crei un provider di posizione personalizzato o derivato, puoi modificare le regole di visibilità.
I veicoli sono visibili solo quando la corsa è in corso: un veicolo della corsa è visibile dal momento in cui viene assegnato a una corsa fino al momento della consegna. 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 origine, destinazione e tappe intermedie vengono sempre mostrati sulla mappa. Ad esempio, la località di arrivo di una corsa o la località di consegna di una spedizione viene sempre mostrata sulla mappa, indipendentemente dallo stato della corsa o della consegna.
Passaggi successivi
Consulta la documentazione relativa alla piattaforma su cui vuoi seguire i percorsi: