Dostosuj wrażenia użytkowników w przypadku przejazdów na żądanie, umożliwiając im śledzenie przejazdu w ramach 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ą przejazdy w Fleet Engine, oraz klasy, których używasz do tworzenia bogatego wyświetlania opartego na mapie, aby udostępniać przejazdy użytkownikom. Aby zapewnić takie wrażenia użytkownikom, zintegruj pakiet Consumer SDK z aplikacją i skonfiguruj 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 użytkownikom kompleksowych wrażeń 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 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 miejsca docelowego.
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ć przejazd powiązany 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 wysyła prośbę 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 przejazdu | Aplikacja użytkownika pobiera identyfikator przejazdu z backendu i prosi o rozpoczęcie śledzenia przejazdu. |
| 4 | Kierowca rozpoczyna przejazd | Gdy kierowca używa aplikacji kierowcy, aby wskazać, że przejazd się rozpoczął, 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ć przejazd i udostępniać jego postęp aplikacji użytkownika. |
| 6 | Aplikacja użytkownika wyświetla informacje o przejeździe | Aplikacja użytkownika powiadamia użytkownika i zaczyna wyświetlać mu informacje o przejeździe, aktualizując je w miarę jego postępu. |
| 7 | Przejazd zostaje anulowany lub zakończony | Gdy kierowca anuluje lub zakończy przejazd, aplikacja kierowcy wyłącza śledzenie lokalizacji, a serwer backendu informuje Fleet Engine, aby oznaczył przejazd jako anulowany lub zakończony. |
| 8 | Aplikacja użytkownika przestaje śledzić podróż | Przejazd jest oznaczony jako anulowany lub zakończony. |
| 9 | Proces powtarza się w przypadku następnej podróży | Tworzony jest nowy przejazd 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ć podróże 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żytkowników, zdefiniuj mapę i dodaj obsługę map wektorowych. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Śledzenie przejazdu | Śledź podróż, aby udostępniać użytkownikowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępu przejazdu i obsługiwanie błędów przejazdu | 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 | Po zakończeniu podróży przestań ją ś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ć podróże 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żytkowników, zainicjuj widok mapy i obsługuj zdarzenia mapy. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Śledzenie przejazdu | Śledź podróż, aby udostępniać użytkownikowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępu przejazdu i obsługiwanie błędów przejazdu | 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 | Po zakończeniu podróży przestań ją ś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ć podróże 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żytkowników, włącz interfejs Maps JavaScript API i skonfiguruj autoryzację. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Śledzenie przejazdu | Śledź podróż, aby udostępniać użytkownikowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępu przejazdu i obsługiwanie błędów przejazdu | 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 | Po zakończeniu podróży przestań ją śledzić | Przestań śledzić podróż, aby przestać udostępniać użytkownikowi lokalizację pojazdu. Więcej informacji znajdziesz w artykule Przestawanie śledzenia podróży. |
Komponenty
Ta sekcja zawiera podsumowanie 2 niezbędnych komponentów do śledzenia przejazdu:
Opcjonalnie możesz też dostosować wrażenia użytkowników 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 przejazdu 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 mapy podróży udostępnionej. 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ę przejazd. |
| Lokalizacja docelowa | Lokalizacja docelowa to miejsce, w którym kończy się przejazd. Oznacza miejsce docelowe. |
| 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 miejsca docelowe, 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 dostarczenia. 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, miejsca docelowego i punktów pośrednich są zawsze widoczne na mapie. Na przykład miejsce docelowe podróży lub miejsce dostawy przesyłki jest zawsze widoczne na mapie, niezależnie od stanu podróży lub dostawy.
Co dalej?
Zapoznaj się z dokumentacją platformy, na której chcesz śledzić podróże: