Dostosuj wrażenia użytkowników w przypadku przejazdów na żądanie, umożliwiając im śledzenie podróży związanej z zamówieniem, przejazdem lub inną usługą, którą im świadczysz.
Czym jest pakiet SDK konsumenta?
Pakiet SDK konsumenta jest częścią Fleet Engine do przejazdów na żądanie. Zawiera interfejsy, które modelują dane o podróży i śledzą podróże w Fleet Engine, oraz klasy, których używasz do tworzenia bogatego wyświetlania opartego na mapie, aby udostępniać podróże użytkownikom. Aby zapewnić takie wrażenia użytkownikom, zintegruj pakiet SDK konsumenta z aplikacją i skonfiguruj odpowiednie profile ról w Fleet Engine.
Interfejsy API pakietu SDK konsumenta specyficzne dla platformy umożliwiają wbudowanie w aplikacje funkcji udostępniania podróży. Pakiet SDK konsumenta jest dostępny na tych platformach:
Dlaczego warto korzystać z pakietu SDK konsumenta?
Zintegrowanie pakietu SDK konsumenta z aplikacjami do przejazdów na żądanie umożliwia zapewnienie użytkownikom kompleksowych wrażeń dzięki informacjom o zmianie lokalizacji w czasie zbliżonym do rzeczywistego i pozycjom przyciąganym 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 SDK konsumenta?
Możesz używać informacji z pakietu SDK sterownika i Fleet Engine do tworzenia niestandardowych wrażeń użytkowników, 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 SDK konsumenta
Ogólnie pakiet SDK konsumenta 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óżą, zapewniane 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 SDK konsumenta 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 natężenie ruchu, znaczniki na mapie, 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 SDK sterownika. Na przykład gdy kierowca ma zamiar opuścić restaurację lub pojechać 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ę postępu podróży. |
| 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 SDK konsumenta
Wybierz platformę, aby dowiedzieć się, jak zacząć śledzić podróże w aplikacjach użytkowników.
Android
| 1 | Konfigurowanie pakietu SDK konsumenta na Androidzie | Aby śledzić podróże na żądanie w aplikacji, skonfiguruj pakiet SDK konsumenta. Więcej informacji znajdziesz w artykule Pobieranie pakietu SDK konsumenta na Androida. |
| 2 | Konfigurowanie interfejsu wizualnego | Aby skonfigurować wrażenia użytkowników, 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żytkownikom lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie podróży. |
| 5 | Aktualizowanie postępu podróży i obsługa 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ługa błędów podróży. |
| 5 | Gdy podróż się zakończy, przestań śledzić | Przestań śledzić podróż, aby przestać udostępniać użytkownikom lokalizację pojazdu. Więcej informacji znajdziesz w artykule Przestawanie śledzenia podróży. |
iOS
| 1 | Konfigurowanie pakietu SDK konsumenta na iOS | Aby śledzić podróże na żądanie w aplikacji, skonfiguruj pakiet SDK konsumenta. Więcej informacji znajdziesz w artykule Pobieranie pakietu SDK konsumenta na iOS. |
| 2 | Konfigurowanie interfejsu wizualnego | Aby skonfigurować wrażenia użytkowników, 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żytkownikom lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie podróży. |
| 5 | Aktualizowanie postępu podróży i obsługa 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ługa błędów podróży. |
| 5 | Gdy podróż się zakończy, przestań śledzić | Przestań śledzić podróż, aby przestać udostępniać użytkownikom lokalizację pojazdu. Więcej informacji znajdziesz w artykule Przestawanie śledzenia podróży. |
JavaScript
| 1 | Konfigurowanie pakietu SDK konsumenta w JavaScript | Aby śledzić podróże na żądanie w aplikacji, skonfiguruj pakiet SDK konsumenta. Więcej informacji znajdziesz w artykule Konfigurowanie pakietu SDK konsumenta w JavaScript. |
| 2 | Wczytywanie i dostosowywanie mapy | Aby skonfigurować wrażenia użytkowników, włącz Maps JavaScript API i skonfiguruj autoryzację. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Śledzenie podróży | Śledź podróż, aby udostępniać użytkownikom lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie podróży. |
| 5 | Aktualizowanie postępu podróży i obsługa 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 śledzenie jej oraz Obsługa błędów podróży. |
| 5 | Gdy podróż się zakończy, przestań śledzić | Przestań śledzić podróż, aby przestać udostępniać użytkownikom 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żytkowników za pomocą tych komponentów:
Pobieranie 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 na trasie, a także surowe pliki danych dotyczące szacowanego czasu dotarcia 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 na trasie 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 na trasie 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 na trasie | Lokalizacja punktu na trasie to dowolna lokalizacja pośrednia na trasie śledzonej podróży. Punkty na trasie 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 na trasie. Więcej informacji znajdziesz w artykule Punkty na trasie w dokumentacji Fleet Engine. |
| Lokalizacja pojazdu | Lokalizacja pojazdu to zgłoszona lokalizacja pojazdu. Więcej informacji znajdziesz w artykule Lokalizacja pojazdu w dokumentacji Fleet Engine. |
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 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 na trasie 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: