Panoramica dei viaggi on demand dell'SDK consumer

Personalizza l'esperienza del consumatore per i viaggi on demand consentendo ai consumatori di seguire durante il viaggio per un ordine, una corsa o un altro servizio da te fornito.

App consumer che segue un viaggio

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 per la piattaforma SDK consumer consentono di condividere i percorsi in modo nativo nelle 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 fornire un'esperienza consumatore completa, con aggiornamenti della posizione quasi in tempo reale e posizioni bloccate 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 di 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:

  • Disporre dei ruoli Fleet Engine appropriati per consentire a un'app autenticata di seguire la corsa associata all'ordine di un consumatore.
  • Un'associazione tra il consumatore e la corsa, fornita dal tuo sistema di backend.
  • Le classi SDK TripModel e JourneySharingSession che modellano i dati delle corse e condividono le sessioni delle corse nell'app consumer.

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.

come funziona l'SDK consumer

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:
  • Crea un viaggio in Fleet Engine.
  • Assegna il viaggio a un veicolo.
2 Il conducente accetta il viaggio 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 inizia il percorso 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 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 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ù, 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, come la distanza da percorrere e l'orario di arrivo previsto, e gestisci eventuali errori durante una corsa. 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 Smetti di seguire un percorso 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 Scaricare 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 percorso.
5 Aggiornare l'avanzamento della corsa e gestire gli errori Aggiorna i dettagli dei tuoi viaggi, come la distanza da percorrere e l'orario di arrivo previsto, e gestisci eventuali errori durante una corsa. 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 la sezione Configurare l'SDK JavaScript Consumer.
2 Caricare e personalizzare una mappa Attiva l'API Maps JavaScript e configura l'autorizzazione per configurare la tua esperienza utente. 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 da percorrere e l'orario di arrivo previsto, e gestisci eventuali errori durante i viaggi. 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 Smettere di seguire un percorso.

Componenti

Questa sezione riassume i due componenti necessari per seguire un viaggio:

Facoltativamente, puoi anche personalizzare l'esperienza del consumatore con questi componenti:

Retrieval del token di autenticazione

Per controllare l'accesso ai dati sulla posizione archiviati in Fleet Engine, devi:

  1. Implementa un servizio di creazione di token web JSON (JWT) per Fleet Engine sul tuo server. Per ulteriori informazioni, consulta Emettere JWT.

  2. 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:
  • Il punto di partenza o di arrivo di una corsa.
  • La posizione e il percorso del veicolo assegnato al 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 è il luogo in cui termina una corsa. Indica il luogo 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 posizioni di prelievo e destinazione su un percorso di consegna sono le posizioni delle tappe. 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.

Controlla la visibilità delle località monitorate

I provider di località predefiniti in Fleet Engine seguono queste regole di visibilità per gli oggetti tracciati basati sulla posizione 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 corsa è visibile dal momento in cui viene assegnato a una corsa fino al momento della discesa. Se la corsa viene annullata, il veicolo è più visibile.

  • Tutti gli altri indicatori di posizione sono sempre visibili: tutti gli altri indicatori di posizione per partenza, destinazione e waypoint vengono sempre visualizzati sulla mappa. Ad esempio, la località di consegna di un viaggio o di una spedizione viene sempre visualizzata sulla mappa, indipendentemente dallo stato del viaggio o della consegna.

Passaggi successivi

Consulta la documentazione della piattaforma su cui vuoi seguire i viaggi: