Omówienie podróży na żądanie z pakietu SDK dla klientów indywidualnych

Dostosuj wrażenia klientów w przypadku przejazdów na żądanie, umożliwiając im śledzenie przejazdu podczas zamówienia, przejazdu lub innej usługi, którą im świadczysz.

Czym jest pakiet SDK dla konsumentów?

Pakiet konsumencki SDK jest częścią Fleet Engine przeznaczoną do podróży na żądanie. Udostępnia ona interfejsy, które modelują dane o podróży i śledzą ją w Fleet Engine, a także klasy, których używasz do tworzenia bogatego wyświetlacza opartego na mapie, aby udostępniać podróże użytkownikom. Zintegrujesz pakiet Consumer SDK z aplikacją i ustawisz odpowiednie profile ról w Fleet Engine, aby utworzyć takie środowisko dla użytkowników indywidualnych.

Interfejsy API przeznaczone do platformy pakietu SDK dla klientów indywidualnych pozwalają na natywne udostępnianie ścieżek w aplikacjach. Pakiet SDK dla konsumentów jest dostępny na tych platformach:

• Android
• iOS
• JavaScript

Dlaczego warto korzystać z Consumer SDK?

Zintegrowanie pakietu Consumer SDK z aplikacją do zamawiania przejazdów pozwala zapewnić klientom kompleksowe wrażenia, w tym aktualizacje lokalizacji w czasie zbliżonym do rzeczywistego oraz pozycje na mapie. Klienci widzą trasę przejazdu nałożoną na mapę, w tym szczegóły postępów, które pomagają im zorientować się, gdzie znajduje się przejazd lub dostawa.

Co można zrobić z Consumer SDK?

Na podstawie informacji z pakietu Driver SDK i Fleet Engine możesz tworzyć spersonalizowane wrażenia użytkowników obejmujące te funkcje:

• Dostosuj interfejs mapy do swoich potrzeb związanych z brandingiem.

• Śledź aktualną lokalizację pojazdu na trasie, która jest okresowo aktualizowana.

• wyświetlać szacowany czas dotarcia na miejsce odbioru i wydania pojazdu;

• Pokaż pozostały dystans.

• Pokaż bieżący ruch na trasie.

Jak działa pakiet SDK dla klientów indywidualnych

Ogólnie rzecz biorąc, pakiet Consumer SDK korzysta z tych mechanizmów:

• Posiadanie odpowiednich ról w Fleet Engine, aby uwierzytelniona aplikacja mogła śledzić przejazd powiązany z zamówieniem klienta.
• Powiązanie konsumenta z podróżą, które zapewnia Twój system backendowy.
• Klasy pakietu SDK TripModel i JourneySharingSession, które modelują dane podróży i udostępniają sesje podróży w aplikacji dla użytkowników.

Pakiet Consumer SDK udostępnia też inne interfejsy i klasy, dzięki którym możesz tworzyć bogate aplikacje z dodatkowymi funkcjami, takimi jak informacje o ruchu drogowym, znaczniki mapy, szacowany czas dojazdu i dane trasy.

Ta tabela przedstawia przepływ podróży, a następnie aplikacja konsumenta.

1	Aplikacja konsumenta prosi o przejazd	Serwer backendu otrzymuje żądanie przejazdu na żądanie i wykonuje te czynności: Tworzy przejazd w Fleet Engine. Przypisuje przejazd do pojazdu.
2	Kierowca akceptuje przejazd	Aplikacja kierowcy otrzymuje identyfikator i informacje o przejeździe, a kierowca akceptuje przejazd.
3	Aplikacja dla konsumentów prosi o dostęp do śledzenia podróży	Aplikacja dla użytkownika pobiera identyfikator podróży z Twojego backendu i prosi o rozpoczęcie śledzenia podróży.
4	Kierowca rozpoczyna podróż	Gdy kierowca w aplikacji dla kierowcy wskaże, że przejazd się rozpoczął, aplikacja powiadomi Twój serwer backendowy za pomocą pakietu Driver SDK. Na przykład, gdy kierowca ma wyruszyć z restauracji lub podjechać po pasażera.
5	Fleet Engine zaczyna wysyłać informacje o podróży	Fleet Engine zaczyna śledzić podróż i udostępniać informacje o jej postępach aplikacji dla klienta.
6	Aplikacja dla konsumenta wyświetla informacje o podróży	Aplikacja powiadamia konsumenta i zaczyna wyświetlać mu informacje o podróży, aktualizując jej postępy.
7	Podróż została anulowana lub zakończona	Gdy kierowca anuluje lub zakończy przejazd, aplikacja kierowcy wyłącza śledzenie lokalizacji, a serwer backendowy poinformuje Fleet Engine, aby oznaczył przejazd jako anulowany lub zakończony.
8	Aplikacja dla konsumenta przestaje śledzić podróż	Podróż jest oznaczona jako anulowana lub zakończona.
9	Powtarzanie tego procesu w przypadku kolejnej podróży	Tworzona jest nowa podróż i proces się powtarza.

Jak korzystać z pakietu SDK dla konsumentów

Wybierz platformę, aby dowiedzieć się, jak rozpocząć śledzenie przejazdów w aplikacji dla użytkowników.

Komponenty

W tej sekcji znajdziesz podsumowanie 2 elementów niezbędnych do śledzenia podróży:

• Pobieranie tokenu uwierzytelniania.
• Widok mapy i śledzenie trasy.

Opcjonalnie możesz też dostosować doświadczenie klienta za pomocą tych komponentów:

• Nadaj styl mapom.
• Kontrolowanie widoczności śledzonych lokalizacji.

Pobieranie tokena uwierzytelniania

Aby kontrolować dostęp do danych o lokalizacji przechowywanych w Fleet Engine, musisz:

1. Wdrożyć na serwerze usługę tworzenia tokena sieciowego JSON (JWT) dla Fleet Engine. Więcej informacji znajdziesz w artykule Wydawanie tokenów JWT.

2. W swojej witrynie lub aplikacji mobilnej wdrożyć funkcję pobierania tokena uwierzytelniania, aby uwierzytelniać dostęp do danych o lokalizacji. Więcej informacji o konfigurowaniu pobierania tokenów znajdziesz w przewodniku konfiguracji na Android, iOS lub JavaScript.

Widok mapy i śledzenie przejazdu

Śledzenie podróży obejmuje komponenty do wizualizacji pojazdów i punktów orientacyjnych, a także pliki danych w postaci surowych danych dotyczących przewidywanego czasu przybycia kierowcy lub pozostałej odległości do przejechania.

W tabeli poniżej opisano te komponenty:

Komponent	Opis
Widok mapy klienta	Widok mapy umożliwia zarządzanie cyklem życia przejazdu, pokazując punkty pośrednie lokalizacji pojazdów w trakcie przejazdu. Jeśli trasa pojazdu jest znana, widok mapy aktualizuje linię łamaną trasy pojazdu, aby odzwierciedlić postępy pojazdu na trasie.
Dostawca lokalizacji podróży w JavaScript	W przypadku aplikacji internetowych w JavaScript dostawca lokalizacji podróży przekazuje informacje o lokalizacji śledzonych obiektów na mapę udostępnionej podróży. Więcej informacji znajdziesz w artykule o uruchamianiu wyszukiwania dostawcy lokalizacji podróży. Za pomocą dostawcy lokalizacji podróży możesz śledzić te informacje o podróży: Miejsce odbioru lub zdania pojazdu. Lokalizacja i trasy pojazdu przypisane do podróży.

Śledzenie obiektów w lokalizacji

Dostawca lokalizacji śledzi lokalizację obiektów takich jak punkty drogi i pojazdy, jak opisano w tabeli poniżej.

Śledzenie lokalizacji	Opis
Miejsce odbioru	Miejsce odbioru to miejsce, w którym rozpoczyna się podróż.
Lokalizacja docelowa	Lokalizacja docelowa to lokalizacja, w której kończy się podróż. oznacza miejsce dostawy,
Lokalizacja punktu na trasie	Punkt drogowy to dowolna lokalizacja pośrednia na trasie podróży śledzonej. Z technicznego punktu widzenia punkty na trasie mogą obejmować miejsca, w których chcesz odebrać lub wsiąść, ale punkty pośrednie zwykle są punktami pośrednimi na trasie. Na przykład przystanki między miejscem odbioru a miejscem docelowym na trasie dostawy to lokalizacje punktów pośrednich. Więcej informacji znajdziesz w dokumentacji Fleet Engine w sekcji Punkty pośrednie trasy.
Lokalizacja pojazdu	Lokalizacja pojazdu to zgłoszona lokalizacja pojazdu. Więcej informacji znajdziesz w sekcji Lokalizacja pojazdu w dokumentacji Fleet Engine.

Nadawanie stylów mapom

Style znaczników i linii łamanych określają wygląd i styl obiektów śledzonej lokalizacji na mapie. Możesz użyć niestandardowych opcji stylizacji, aby dopasować styl do aplikacji internetowej.

Kontrolowanie widoczności śledzonych lokalizacji

Zdefiniowani w Fleet Engine dostawcy lokalizacji przestrzegają tych reguł widoczności obiektów lokalizacji śledzonych na mapie. Jeśli utworzysz własnego lub pochodnego, możesz zmienić reguły widoczności.

• Pojazdy są widoczne tylko podczas trwania podróży: pojazd jest widoczny od momentu przypisania do wycieczki do momentu zatrzymania. Jeśli podróż zostanie odwołana, pojazd będzie widoczny.

• Wszystkie inne znaczniki lokalizacji są zawsze widoczne: wszystkie inne znaczniki lokalizacji, takie jak punkt początkowy, punkt docelowy i punkty pośrednie, są zawsze widoczne na mapie. Na przykład lokalizacja odbioru lub dostawy jest zawsze wyświetlana na mapie niezależnie od stanu podróży lub dostawy.

Co dalej?

Zapoznaj się z dokumentacją platformy, na której chcesz śledzić podróże:

• Android
• iOS
• JavaScript