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 możesz używać do tworzenia bogatych wyświetleń na mapie, aby udostępniać podróże użytkownikom. Aby stworzyć takie funkcje dla konsumentów, zintegruj pakiet SDK dla konsumentów z aplikacją i ustaw odpowiednie profile ról w Fleet Engine.

Interfejsy API Consumer SDK na potrzeby poszczególnych platform umożliwiają udostępnianie ścieżek w natywnym środowisku aplikacji. Pakiet SDK dla konsumentów jest dostępny na tych platformach:

• Android
• iOS
• JavaScript

Dlaczego warto korzystać z Consumer SDK?

Dzięki zintegrowaniu pakietu Consumer SDK z aplikacją do zamawiania przejazdów możesz zapewnić klientom kompleksowe wrażenia, w tym aktualizacje lokalizacji w czasie zbliżonym do rzeczywistego oraz pozycje na mapie. Klienci mogą zobaczyć na mapie trasę przejazdu pojazdu, w tym szczegóły postępu, które pomogą im zrozumieć, gdzie znajduje się ich przejazd lub dostawa.

Co można zrobić z Consumer SDK?

Korzystając z informacji z Driver SDK i Fleet Engine, możesz tworzyć spersonalizowane rozwiązania dla klientów, które obejmują 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.

• wyświetlać natężenie ruchu na trasie w czasie rzeczywistym.

Jak działa pakiet Consumer SDK

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 przybycia i dane trasy.

Ta tabela pokazuje przebieg podróży z użyciem aplikacji dla konsumentów.

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 podróży, a kierowca akceptuje ją.
3	Aplikacja dla konsumenta 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 backendu za pomocą pakietu SDK dla kierowcy. Na przykład, gdy kierowca zamierza wyjechać z restauracji lub udać się do miejsca odbioru.
5	Fleet Engine zaczyna wysyłać informacje o podróży	Silnik floty zaczyna śledzić przejazd i przesyłać informacje o jego postępach do aplikacji dla klienta.
6	Aplikacja dla konsumenta wyświetla informacje o podróży	Aplikacja dla konsumenta wysyła powiadomienie i zaczyna wyświetlać informacje o podróży, aktualizując je w miarę jej trwania.
7	Przejazd został anulowany lub zakończony	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 użytkownika przestaje śledzić podróż	Podróż jest oznaczona jako anulowana lub zakończona.
9	Powtórz ten proces podczas następnej podróży	Tworzona jest nowa podróż i proces się powtarza.

Jak korzystać z pakietu SDK dla konsumentów

Wybierz platformę, aby dowiedzieć się, jak zacząć śledzić przejazdy w aplikacjach 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 aplikacjach mobilnych wdrożyć mechanizm 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 pośrednich, a także pliki danych z nieprzetworzonymi danymi o przewidywanym czasie przybycia kierowcy lub o pozostałym dystansie do przejechania.

W tabeli poniżej opisano te komponenty:

Komponent	Opis
Widok mapy dla klienta	Widok mapy umożliwia zarządzanie cyklem życia podróży, pokazując punkty pośrednie lokalizacji pojazdów w trakcie podróży. Jeśli trasa pojazdu jest znana, widok mapy aktualizuje polilinię trasy pojazdu, aby wskazywać jego postęp 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ę wspólnej podróży. Więcej informacji znajdziesz w artykule Tworzenie wystąpienia dostawcy lokalizacji podróży. Za pomocą dostawcy lokalizacji podróży możesz śledzić te informacje o podróży: Miejsce odbioru lub docelowy punkt podróży. Lokalizacja i trasy pojazdu przypisanego do podróży.

Obiekty monitorowanej lokalizacji

Dostawca lokalizacji śledzi lokalizację obiektów, takich jak punkty pośrednie 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	Miejsce docelowe to miejsce, w którym kończy się podróż. oznacza miejsce dostawy,
Lokalizacja punktu pośredniego	Punkt drogowy to dowolna lokalizacja pośrednia na trasie podróży, która jest śledzona. Chociaż punkty pośrednie mogą obejmować miejsca odbioru i celowe, zwykle odnoszą się do przystanków pośrednich na trasie. Na przykład przystanki między miejscem odbioru a miejscem docelowym na trasie dostawy to punkty pośrednie. 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 dokumentacji Fleet Engine dotyczącej lokalizacji pojazdu.

Nadawanie stylów mapom

Style znaczników i linii łamanych określają wygląd śledzonych obiektów 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 niestandardowy lub pochodny dostawca lokalizacji, możesz zmienić reguły widoczności.

• Pojazdy są widoczne tylko wtedy, gdy są w trakcie realizacji: pojazd jest widoczny od momentu przydzielenia go do przejazdu do momentu jego zakończenia. Jeśli przejazd zostanie anulowany, pojazd przestaje być 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