Quando utilizzi la condivisione dei percorsi di Fleet Engine per i viaggi on demand, i consumatori Possono monitorare lo stato di avanzamento di un ordine, di una corsa o di altri servizi forniti dall'utente.
Cos'è la condivisione del percorso?
La condivisione del percorso è una funzionalità di Fleet Engine per le corse on demand, utilizzata per SDK consumer. Fornisce interfacce che modellano i dati di viaggio e seguono sessioni in Fleet Engine e fornisce classi che puoi utilizzare per creare visualizzazione basata su mappa per ottenere informazioni di viaggio agli utenti consumer. Puoi integrare SDK nella tua app e imposta i profili dei ruoli appropriati all'interno di Fleet Engine su supportare l'utilizzo del percorso da parte dei consumatori.
La condivisione del percorso fornisce API specifiche per la piattaforma, per consentirti di creare il tuo percorso la condivisione nativa nelle tue applicazioni. L'SDK consumer è disponibile per seguenti piattaforme:
Perché usare la condivisione del percorso?
Integrando la condivisione dei percorsi nelle tue applicazioni per i viaggi on demand, offrono un'esperienza completa di monitoraggio del veicolo, quasi in tempo reale aggiornamenti della posizione e posizioni agganciate alla strada. Il tuo i consumatori possono vedere il percorso del veicolo sovrapposto a una mappa, ad esempio dettagli sui progressi che li aiutano a capire dove si trova la corsa o la consegna.
Cosa puoi fare con la condivisione del percorso?
Puoi utilizzare le informazioni dell'SDK Driver e di Fleet Engine per creare di visualizzazioni SDK mobile e risposte del servizio web che offrono le seguenti funzionalità:
Fornisci personalizzazioni dell'interfaccia utente della mappa in base alle tue esigenze di branding.
La posizione attuale del veicolo lungo il percorso, con la sua posizione veniva aggiornata periodicamente.
L'orario di arrivo stimato (ETA) per le sedi di prelievo e destinazione.
La distanza rimanente.
Traffico in tempo reale sul percorso.
Come funziona la condivisione del percorso
A livello generale, la condivisione del percorso si basa sui seguenti meccanismi:
- I ruoli utente di Fleet Engine appropriati per consentire agli utenti di app autenticati recuperare il viaggio associato all'ordine.
- Un'associazione tra il consumatore e il viaggio, fornita dal tuo di backend.
- L'SDK consumer
TripModeleJourneySharingSession, classi SDK che creare modelli di dati di viaggio e condividere le sessioni di viaggio nell'app consumer.
L'SDK consumer fornisce anche altre interfacce e classi per creare un'interfaccia utente di mappatura per la tua app, in modo che i consumatori un'esperienza con l'app ricca di dettagli come il traffico, gli indicatori di mappa, l'orario di arrivo stimato e i dati sul percorso.
Questa tabella mostra il flusso di un percorso condiviso.
| 1 | L'app consumer richiede un viaggio. | Il tuo server di backend riceve una richiesta di viaggio on demand ed esegue
seguenti:
|
| 2 | Il conducente accetta il viaggio | L'app del conducente recupera l'ID e le informazioni sulla corsa, accetta la corsa. |
| 3 | L'app consumer richiede l'accesso al percorso | L'app consumer riceve l'ID viaggio dal backend e per avviare la condivisione del percorso. |
| 4 | Il conducente inizia il percorso | Quando il conducente utilizza l'app del conducente per indicare che la corsa ha l'app invia una notifica al tuo server di backend tramite l'SDK Driver. Ad esempio, quando il conducente per uscire dal ristorante o andare al punto di prelievo. |
| 5 | Floet Engine inizia a condividere il percorso | Fleet Engine inizia a monitorare il percorso e la condivisione i suoi progressi con l'app consumer. |
| 6 | Un'app consumer mostra il percorso | L'app consumer invia una notifica al consumatore e inizia a visualizzare il viaggio verso di loro, aggiornandolo man mano che avanza. |
| 7 | Viaggio completato o annullato | Quando il conducente annulla la corsa 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 consumer interrompe la condivisione del percorso | Il percorso viene visualizzato come annullato o completato. |
| 9 | La procedura si ripete per il prossimo viaggio | Viene creato un nuovo viaggio e il processo si ripete. |
Come usare la condivisione del percorso
Seleziona la tua piattaforma per scoprire come iniziare a condividere i percorsi.
Android
| 1 | Configurare l'SDK consumer in Android | Per condividere i percorsi per i viaggi on demand nella tua app, configura l'SDK consumer. Per ulteriori informazioni, vedi Scaricare l'SDK Android Consumer. |
| 2 | Configurare l'interfaccia visiva per la condivisione del percorso | Definisci una mappa e aggiungi il supporto per le mappe vettoriali per impostare l'interfaccia del tuo viaggio. Per ulteriori informazioni, consulta la sezione Configurare una mappa. |
| 3 | Condividi un percorso | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per ulteriori informazioni, vedi Seguire un percorso. |
| 5 | Aggiornare l'avanzamento del percorso e gestire gli errori | Aggiorna i dettagli del percorso, come la distanza da percorrere e l'orario di arrivo stimato, e gestisci eventuali errori durante il viaggio. Per ulteriori informazioni, vedi Aggiorna la posizione e Gestire gli errori di emergenza. |
| 5 | Al termine del percorso, interrompere la condivisione | Smetti di seguire un percorso per interrompere la condivisione della posizione di un veicolo con il consumatore. Per ulteriori informazioni, vedi Smettere di seguire un percorso. |
iOS
| 1 | Configurare l'SDK consumer in iOS | Per condividere i percorsi per i viaggi on demand nella tua app, configura l'SDK consumer. Per ulteriori informazioni, consulta la sezione Scaricare l'SDK iOS Consumer. |
| 2 | Configurare l'interfaccia visiva per la condivisione del percorso | Inizializza la visualizzazione mappa e gestisci gli eventi della mappa per configurare l'interfaccia del tuo percorso. Per ulteriori informazioni, consulta la sezione Configurare una mappa. |
| 3 | Condividi un percorso | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per ulteriori informazioni, vedi Seguire un percorso. |
| 5 | Aggiornare l'avanzamento del percorso e gestire gli errori | Aggiorna i dettagli del percorso, come la distanza da percorrere e l'orario di arrivo stimato, e gestisci eventuali errori durante il viaggio. Per ulteriori informazioni, vedi Aggiorna la posizione e Gestire gli errori di emergenza. |
| 5 | Al termine del percorso, interrompere la condivisione | Smettere di seguire un percorso per interrompere la condivisione della posizione di un veicolo con il consumatore.Per ulteriori informazioni, vedi Smettere di seguire un percorso. |
JavaScript
| 1 | Configura la condivisione del percorso in JavaScript | Per condividere i percorsi per i viaggi on demand nella tua app, configura l'SDK consumer. Per ulteriori informazioni, consulta la sezione Configurare l'SDK JavaScript Consumer. |
| 2 | Carica e personalizza la mappa di condivisione del percorso | Attiva l'API Maps JavaScript e configura l'autorizzazione per configurare l'interfaccia del viaggio. Per ulteriori informazioni, consulta la sezione Configurare una mappa. |
| 3 | Condividi un percorso | Segui un viaggio per condividere la posizione del veicolo appropriato con il consumatore. Per ulteriori informazioni, vedi Seguire un percorso. |
| 5 | Aggiornare l'avanzamento del percorso e gestire gli errori | Aggiorna i dettagli del percorso, come la distanza da percorrere e l'orario di arrivo stimato, e gestisci eventuali errori durante il viaggio. Per ulteriori informazioni, vedi Aggiornare e seguire la posizione e Gestire gli errori di emergenza. |
| 5 | Al termine del percorso, interrompere la condivisione | Smetti di seguire un percorso per interrompere la condivisione della posizione di un veicolo con il consumatore. Per ulteriori informazioni, vedi Interrompere la condivisione del percorso. |
Componenti
Questa sezione riassume due componenti necessari per condividere un percorso:
Se vuoi, puoi anche personalizzare l'esperienza di condivisione del tuo percorso con questi componenti:
Recuperatore token di autenticazione
Per controllare l'accesso ai dati sulla posizione archiviati in Fleet Engine, devi eseguire l'operazione seguenti:
Implementare un servizio di creazione di token web JSON (JWT) per Fleet Engine sul tuo server.
Implementa un fetcher di token di autenticazione nelle tue app web o mobile per autenticare l'accesso ai dati sulla posizione.
Per ulteriori informazioni, consulta la guida alla configurazione per Android. iOS o JavaScript.
Visualizzazione mappa e tracker dei viaggi
La condivisione del percorso include componenti per la visualizzazione di veicoli e tappe, nonché feed di dati non elaborati per l'orario di arrivo stimato del conducente o la distanza rimanente da percorrere.
Nella tabella seguente sono descritti questi componenti:
| Componente | Descrizione |
|---|---|
| Visualizzazione mappa per la condivisione del percorso | La visualizzazione mappa gestisce il ciclo di vita di un percorso, mostrando le tappe la posizione dei veicoli nel corso del viaggio. Se il percorso per un veicolo è noto, la visualizzazione mappa aggiorna il percorso del veicolo polilinea per indicare l'avanzamento del veicolo lungo il percorso. |
| Fornitore di luoghi di viaggio in JavaScript | Per le app web JavaScript, il fornitore di servizi di posizione di viaggio invia la posizione dei feed
informazioni sugli oggetti monitorati nella mappa dei percorsi condivisa. Per maggiori informazioni
le informazioni, vedi
Crea un'istanza del fornitore di servizi di localizzazione di un viaggio.
Puoi utilizzare il fornitore della posizione di viaggio per monitorare i seguenti dettagli per una
percorso:
|
Oggetti posizione monitorati
Il fornitore di servizi di localizzazione monitora la posizione di oggetti come waypoint e veicoli, come descritto nella tabella seguente.
| Posizione monitorata | Descrizione |
|---|---|
| Luogo di ritiro | Il punto di prelievo è il luogo da cui inizia un viaggio. Contrassegna il punto di prelievo. |
| Località di destinazione | La località di destinazione è il luogo in cui termina un viaggio. Contrassegna il luogo di consegna. |
| Posizione waypoint | Una tappa è una posizione intermedia lungo il percorso di una tappa percorso monitorato. Anche se tecnicamente i waypoint possono includere le località di prelievo e destinazione; le tappe in genere si riferiscono alle tappe si ferma lungo il percorso. Ad esempio, le fermate tra il punto di prelievo e la destinazione le località di un percorso di consegna sono le località delle tappe. Per ulteriori informazioni, vedi Tappe del viaggio nella documentazione di Fleet Engine. |
| Posizione del veicolo | La posizione del veicolo è la posizione segnalata di un veicolo. Per maggiori informazioni per le informazioni, consulta Posizione del veicolo nella documentazione di Fleet Engine. |
Definizione dello stile delle mappe
Gli stili degli indicatori e delle polilinee determinano l'aspetto e il design del oggetti tracciati tracciati sulla mappa. Puoi utilizzare opzioni di stile personalizzate per cambiare lo stile predefinito in modo che corrisponda 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 tracciati posizione sulla mappa. Se crei una proprietà personalizzata o derivata fornitore del servizio di localizzazione, puoi modificare le regole di visibilità.
I veicoli sono visibili solo quando la corsa è in corso: una corsa. veicolo condiviso è visibile dal momento in cui viene assegnato a una corsa l'orario di riconsegna. 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 origine, destinazione e tappe sono sempre visualizzati sulla mappa. Per Ad esempio, una condivisione del percorso della località di destinazione o della consegna di una spedizione località viene sempre mostrata sulla mappa, indipendentemente dallo stato durante il viaggio o la consegna.
Passaggi successivi
Consulta la documentazione della piattaforma su cui vuoi condividere i percorsi: