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 użytkowników, zintegruj pakiet SDK dla konsumentów z aplikacją i ustaw odpowiednie profile ról w Fleet Engine.

Interfejsy API pakietu Consumer SDK przeznaczone do konkretnej platformy umożliwiają udostępnianie ścieżek w natywnej formie 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 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, takie jak:

• 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 dojazdu 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 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 backendu za pomocą pakietu Driver SDK. Na przykład, gdy kierowca ma wyruszyć z restauracji lub dojechać do miejsca odbioru.
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 dla konsumenta wysyła powiadomienie i zaczyna wyświetlać informacje o podróży, aktualizując je w miarę jej trwania.
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	Powtórz ten proces 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 dla konsumentów	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 ścieżkę 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 śledzonego obiektu 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 zdania pojazdu. Lokalizacja i trasy pojazdu przypisane do podróży.

Śledzenie obiektów w 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	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. Chociaż punkty pośrednie mogą obejmować miejsca odbioru i dostarczenia, 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