Dostosuj wrażenia konsumentów podczas przejazdów na żądanie, umożliwiając im śledzenie podróży w przypadku zamówienia, przejazdu lub innej usługi, którą im świadczysz.
Czym jest pakiet Consumer SDK?
Pakiet Consumer SDK jest częścią Fleet Engine do obsługi przejazdów na żądanie. Zawiera interfejsy, które modelują dane o podróży i śledzą podróże w Fleet Engine, oraz klasy, których możesz używać do tworzenia bogatego wyświetlania na mapie, aby udostępniać podróże użytkownikom. Aby stworzyć takie wrażenia użytkownika, zintegruj pakiet Consumer SDK z aplikacją i ustaw odpowiednie profile ról w Fleet Engine.
Interfejsy API pakietu Consumer SDK specyficzne dla platformy umożliwiają wbudowanie funkcji udostępniania podróży w aplikacjach. Pakiet Consumer SDK jest dostępny na tych platformach:
Dlaczego warto korzystać z pakietu Consumer SDK?
Integracja pakietu Consumer SDK z aplikacjami do obsługi przejazdów na żądanie umożliwia zapewnienie kompleksowych wrażeń użytkownika dzięki aktualizacjom lokalizacji w czasie zbliżonym do rzeczywistego i pozycjom dopasowanym do drogi. Użytkownicy mogą zobaczyć trasę pojazdu nałożoną na mapę, w tym szczegóły postępu, które pomagają im zrozumieć, gdzie znajduje się ich przejazd lub dostawa.
Co można zrobić za pomocą pakietu Consumer SDK?
Możesz używać informacji z pakietu Driver SDK i Fleet Engine do tworzenia dostosowanych wrażeń użytkownika, w tym tych funkcji:
Dostosowywanie interfejsu mapy do potrzeb związanych z brandingiem.
Śledzenie bieżącej lokalizacji pojazdu podczas jazdy po trasie, z okresowo aktualizowaną pozycją.
Wyświetlanie szacowanego czasu dotarcia (ETA) do miejsca odbioru i wysiadki.
Wyświetlanie pozostałej odległości.
Wyświetlanie aktualnego natężenia ruchu na trasie.
Jak działa pakiet Consumer SDK
Ogólnie pakiet Consumer SDK opiera się na tych mechanizmach:
- Odpowiednie role Fleet Engine, dzięki którym uwierzytelniona aplikacja może śledzić podróż powiązaną z zamówieniem użytkownika.
- Powiązanie między użytkownikiem a podróżą, zapewnione przez system backendu.
- Klasy pakietu SDK
TripModeliJourneySharingSession, które modelują dane o podróży i udostępniają sesje podróży w aplikacji użytkownika.
Pakiet Consumer SDK udostępnia też inne interfejsy i klasy, dzięki którym możesz tworzyć bogate wrażenia użytkownika aplikacji, w tym szczegóły takie jak ruch, znaczniki mapy, szacowany czas dotarcia na miejsce i dane o trasie.
Ta tabela przedstawia przebieg podróży śledzonej przez aplikację użytkownika.
| 1 | Aplikacja użytkownika prosi o przejazd | Serwer backendu otrzymuje prośbę o przejazd na żądanie i wykonuje te czynności:
|
| 2 | Kierowca akceptuje przejazd | Aplikacja kierowcy otrzymuje identyfikator podróży i informacje o podróży, a kierowca akceptuje przejazd. |
| 3 | Aplikacja użytkownika prosi o dostęp do śledzenia podróży | Aplikacja użytkownika pobiera identyfikator podróży z backendu i prosi o rozpoczęcie śledzenia podróży. |
| 4 | Kierowca rozpoczyna podróż | Gdy kierowca używa aplikacji kierowcy, aby wskazać, że podróż się rozpoczęła, aplikacja powiadamia serwer backendu za pomocą pakietu Driver SDK. Na przykład gdy kierowca ma zamiar wyjechać 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ć jej postęp aplikacji użytkownika. |
| 6 | Aplikacja użytkownika wyświetla informacje o podróży | Aplikacja użytkownika powiadamia użytkownika i zaczyna wyświetlać mu informacje o podróży, aktualizując je w miarę jej postępu. |
| 7 | Podróż zostaje anulowana lub zakończona | Gdy kierowca anuluje lub zakończy podróż, aplikacja kierowcy wyłącza śledzenie lokalizacji, a serwer backendu informuje Fleet Engine, aby oznaczył podróż jako anulowaną lub zakończoną. |
| 8 | Aplikacja użytkownika przestaje śledzić podróż | Podróż jest oznaczona jako anulowana lub zakończona. |
| 9 | Proces powtarza się w przypadku następnej podróży | Tworzona jest nowa podróż i proces się powtarza. |
Jak korzystać z pakietu Consumer SDK
Wybierz platformę, aby dowiedzieć się, jak zacząć śledzić podróże w aplikacjach użytkowników.
Android
| 1 | Konfigurowanie pakietu Consumer SDK na Androidzie | Aby śledzić przejazdy na żądanie w aplikacji, skonfiguruj pakiet Consumer SDK. Więcej informacji znajdziesz w artykule Pobieranie pakietu Consumer SDK na Androida. |
| 2 | Konfigurowanie interfejsu wizualnego | Aby skonfigurować wrażenia użytkownika, zdefiniuj mapę i dodaj obsługę map wektorowych. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Śledzenie podróży | Śledź podróż, aby udostępniać użytkownikowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie podróży. |
| 5 | Aktualizowanie postępu podróży i obsługiwanie błędów podróży | Aktualizuj szczegóły podróży, takie jak odległość i szacowany czas dotarcia, oraz obsługuj błędy podczas podróży. Więcej informacji znajdziesz w artykułach Aktualizowanie postępu podróży i Obsługiwanie błędów podróży. |
| 5 | Gdy podróż się zakończy, przestań śledzić | Przestań śledzić podróż, aby przestać udostępniać użytkownikowi lokalizację pojazdu. Więcej informacji znajdziesz w artykule Przestawanie śledzenia podróży. |
iOS
| 1 | Konfigurowanie pakietu Consumer SDK na iOS | Aby śledzić przejazdy na żądanie w aplikacji, skonfiguruj pakiet Consumer SDK. Więcej informacji znajdziesz w artykule Pobieranie pakietu Consumer SDK na iOS. |
| 2 | Konfigurowanie interfejsu wizualnego | Aby skonfigurować wrażenia użytkownika, zainicjuj widok mapy i obsługuj zdarzenia mapy. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Śledzenie podróży | Śledź podróż, aby udostępniać użytkownikowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie podróży. |
| 5 | Aktualizowanie postępu podróży i obsługiwanie błędów podróży | Aktualizuj szczegóły podróży, takie jak odległość i szacowany czas dotarcia, oraz obsługuj błędy podczas podróży. Więcej informacji znajdziesz w artykułach Aktualizowanie postępu podróży i Obsługiwanie błędów podróży. |
| 5 | Gdy podróż się zakończy, przestań śledzić | Przestań śledzić podróż, aby przestać udostępniać użytkownikowi lokalizację pojazdu. Więcej informacji znajdziesz w artykule Przestawanie śledzenia podróży. |
JavaScript
| 1 | Konfigurowanie pakietu Consumer SDK w JavaScript | Aby śledzić przejazdy na żądanie w aplikacji, skonfiguruj pakiet Consumer SDK. Więcej informacji znajdziesz w artykule Konfigurowanie pakietu Consumer SDK w JavaScript. |
| 2 | Wczytywanie i dostosowywanie mapy | Aby skonfigurować wrażenia użytkownika, włącz interfejs Maps JavaScript API i skonfiguruj autoryzację. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Śledzenie podróży | Śledź podróż, aby udostępniać użytkownikowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie podróży. |
| 5 | Aktualizowanie postępu podróży i obsługiwanie błędów podróży | Aktualizuj szczegóły podróży, takie jak odległość i szacowany czas dotarcia, oraz obsługuj błędy podczas podróży. Więcej informacji znajdziesz w artykułach Aktualizowanie i śledzenie postępu podróży oraz Obsługiwanie błędów podróży. |
| 5 | Gdy podróż się zakończy, przestań śledzić | Przestań śledzić podróż, aby przestać udostępniać użytkownikowi lokalizację pojazdu. Więcej informacji znajdziesz w artykule Przestawanie śledzenia podróży. |
Komponenty
W tej sekcji znajdziesz podsumowanie 2 niezbędnych komponentów do śledzenia podróży:
Opcjonalnie możesz też dostosować wrażenia użytkownika za pomocą tych komponentów:
Moduł pobierania tokena uwierzytelniania
Aby kontrolować dostęp do danych o lokalizacji przechowywanych w Fleet Engine, musisz wykonać te czynności:
Zaimplementuj na serwerze usługę tworzenia tokena internetowego JSON (JWT) dla Fleet Engine. Więcej informacji znajdziesz w artykule Wystawianie tokenów JWT.
Zaimplementuj w aplikacjach internetowych lub mobilnych pobieranie tokena uwierzytelniania, aby uwierzytelnić dostęp do danych o lokalizacji. Więcej informacji o konfigurowaniu pobierania tokena znajdziesz w przewodniku konfiguracji na Android, iOS lub JavaScript.
Widok mapy i śledzenie podróży
Śledzenie podróży obejmuje komponenty do wizualizacji pojazdów i punktów pośrednich, a także nieprzetworzone pliki danych o szacowanym czasie dotarcia na miejsce kierowcy lub pozostałej odległości do przejechania.
W tabeli poniżej znajdziesz opis tych komponentów:
| Komponent | Opis |
|---|---|
| Widok mapy użytkownika | Widok mapy zarządza cyklem życia podróży, wyświetlając punkty pośrednie dla lokalizacji pojazdów w miarę postępu podróży. Jeśli trasa pojazdu jest znana, widok mapy aktualizuje linię łamaną trasy pojazdu, aby wskazać postęp 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 do udostępnionej mapy podróży. Więcej
informacji znajdziesz w
artykule Tworzenie instancji dostawcy lokalizacji podróży.
Za pomocą dostawcy lokalizacji podróży możesz śledzić te szczegóły podróży:
|
Śledzone obiekty lokalizacji
Dostawca lokalizacji śledzi lokalizację obiektów, takich jak punkty pośrednie i pojazdy, opisanych w tabeli poniżej.
| Śledzona lokalizacja | Opis |
|---|---|
| Miejsce odbioru | Miejsce odbioru to lokalizacja, w której rozpoczyna się podróż. |
| Lokalizacja docelowa | Lokalizacja docelowa to miejsce, w którym kończy się podróż. Oznacza miejsce wysiadki. |
| Lokalizacja punktu pośredniego | Lokalizacja punktu pośredniego to dowolna lokalizacja pośrednia na trasie śledzonej podróży. Punkty pośrednie mogą technicznie obejmować miejsca odbioru i wysiadki, ale zwykle odnoszą się do przystanków pośrednich na trasie. Na przykład przystanki między miejscem odbioru a miejscem docelowym na trasie dostawy są lokalizacjami punktów pośrednich. Więcej informacji znajdziesz w dokumentacji Fleet Engine w sekcji Punkty pośrednie podróży. |
| Lokalizacja pojazdu | Lokalizacja pojazdu to zgłoszona lokalizacja pojazdu. Więcej informacji znajdziesz w dokumentacji Fleet Engine w sekcji Lokalizacja pojazdu. |
Nadawanie stylu 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 stylu aplikacji internetowej.
Kontrolowanie widoczności śledzonych lokalizacji
Wstępnie zdefiniowani dostawcy lokalizacji w Fleet Engine przestrzegają tych reguł widoczności w przypadku śledzonych obiektów lokalizacji na mapie. Jeśli utworzysz niestandardowego lub pochodnego dostawcę lokalizacji, możesz zmienić reguły widoczności.
Pojazdy są widoczne tylko wtedy, gdy podróż jest w toku: pojazd podróży jest widoczny od momentu przypisania go do podróży do momentu wysiadki. Jeśli podróż zostanie anulowana, pojazd nie będzie już widoczny.
Wszystkie inne znaczniki lokalizacji są zawsze widoczne: wszystkie inne znaczniki lokalizacji dla miejsca początkowego, docelowego i punktów pośrednich są zawsze widoczne na mapie. Na przykład miejsce wysiadki lub miejsce dostawy przesyłki jest zawsze widoczne na mapie, niezależnie od stanu podróży lub dostawy.
Co dalej?
Zapoznaj się z dokumentacją dotyczącą platformy, na której chcesz śledzić podróże: