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 używasz do tworzenia bogatego wyświetlacza opartego na mapie, aby udostępniać podróże użytkownikom. Zintegrujesz pakiet Consumer SDK z aplikacją i ustawisz odpowiednie profile ról w Fleet Engine, aby utworzyć takie środowisko dla użytkowników indywidualnych.
Interfejsy API przeznaczone do platformy pakietu SDK dla klientów indywidualnych pozwalają na natywne udostępnianie ścieżek w aplikacjach. Pakiet SDK dla konsumentów jest dostępny na tych platformach:
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 widzą trasę przejazdu nałożoną na mapę, w tym szczegóły postępów, które pomagają im zorientować się, gdzie znajduje się przejazd lub dostawa.
Co można zrobić z Consumer SDK?
Na podstawie informacji z pakietu Driver SDK i Fleet Engine możesz tworzyć spersonalizowane wrażenia użytkowników obejmujące 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.
Pokaż bieżący ruch na trasie.
Jak działa pakiet SDK dla klientów indywidualnych
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
TripModeliJourneySharingSession, 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 przedstawia przepływ podróży, a następnie aplikacja konsumenta.
| 1 | Aplikacja konsumenta prosi o przejazd | Serwer backendu otrzymuje żądanie przejazdu na żądanie i wykonuje te czynności:
|
| 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 backendowy za pomocą pakietu Driver SDK. Na przykład, gdy kierowca ma wyruszyć z restauracji lub podjechać po pasażera. |
| 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 powiadamia konsumenta i zaczyna wyświetlać mu informacje o podróży, aktualizując jej postępy. |
| 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 | Powtarzanie tego procesu 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.
Android
| 1 | Konfigurowanie pakietu Consumer SDK na Androidzie | Aby śledzić przejazdy na żądanie w aplikacji, skonfiguruj pakiet SDK dla konsumentów. Więcej informacji znajdziesz w artykule Pobieranie pakietu Android Consumer SDK. |
| 2 | Skonfiguruj interfejs wizualny | Zdefiniuj mapę i dodaj obsługę map wektorowych, aby skonfigurować wrażenia klientów. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwuj podróż | Śledź podróż, aby udostępnić klientowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie podróży. |
| 5 | Aktualizowanie postępów w podróży i poprawianie błędów związanych z podróżą | aktualizować szczegóły podróży, takie jak odległość i szacowany czas dotarcia, oraz obsługiwać błędy występujące podczas podróży; Więcej informacji znajdziesz w artykułach Aktualizowanie postępu przejazdu i Przetwarzanie błędów związanych z przejazdem. |
| 5 | Zatrzymanie śledzenia po zakończeniu podróży | Zatrzymanie śledzenia przejazdu, aby przestać udostępniać lokalizację pojazdu klientowi. Więcej informacji znajdziesz w artykule Anulowanie obserwowania podróży. |
iOS
| 1 | Konfigurowanie pakietu Consumer SDK na iOS | Aby śledzić przejazdy na żądanie w aplikacji, skonfiguruj pakiet SDK dla konsumentów. Więcej informacji znajdziesz w artykule Pobieranie pakietu SDK dla konsumentów na iOS. |
| 2 | Konfigurowanie interfejsu wizualnego | Inicjuj widok mapy i obsługuj zdarzenia mapy, aby skonfigurować wrażenia klienta. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwuj podróż | Śledź podróż, aby udostępnić klientowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie podróży. |
| 5 | Aktualizowanie postępów w podróży i poprawianie błędów związanych z podróżą | aktualizować szczegóły podróży, takie jak odległość i szacowany czas dotarcia, oraz obsługiwać błędy występujące podczas podróży; Więcej informacji znajdziesz w artykułach Aktualizowanie postępu przejazdu i Przetwarzanie błędów związanych z przejazdem. |
| 5 | Zatrzymanie śledzenia po zakończeniu podróży | Zatrzymanie śledzenia przejazdu, aby przestać udostępniać lokalizację pojazdu klientowi. Więcej informacji znajdziesz w artykule Anulowanie obserwowania podróży. |
JavaScript
| 1 | Konfigurowanie pakietu Consumer SDK w JavaScriptzie | Aby śledzić przejazdy na żądanie w aplikacji, skonfiguruj pakiet SDK dla konsumentów. Więcej informacji znajdziesz w artykule Konfigurowanie pakietu JavaScript Consumer SDK. |
| 2 | Wczytywanie i dostosowywanie mapy | Aby skonfigurować interfejs Maps JavaScript API, włącz go i skonfiguruj autoryzację. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwuj podróż | Śledź podróż, aby udostępnić klientowi 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 | aktualizować szczegóły podróży, takie jak odległość i szacowany czas przyjazdu, oraz usuwać wszelkie błędy związane z podróżą. Więcej informacji znajdziesz w artykułach Aktualizowanie i śledzenie postępu przejazdu oraz Rozwiązywanie problemów z przejazdami. |
| 5 | Zatrzymanie śledzenia po zakończeniu podróży | Zatrzymanie śledzenia przejazdu, aby przestać udostępniać lokalizację pojazdu klientowi. Więcej informacji znajdziesz w artykule Zatrzymywanie śledzenia podróży. |
Komponenty
W tej sekcji znajdziesz podsumowanie 2 elementów niezbędnych do śledzenia podróży:
Opcjonalnie możesz też dostosować doświadczenie klienta za pomocą tych komponentów:
Pobieranie tokena uwierzytelniania
Aby kontrolować dostęp do danych o lokalizacji przechowywanych w Fleet Engine, musisz:
Wdrożyć na serwerze usługę tworzenia tokena sieciowego JSON (JWT) dla Fleet Engine. Więcej informacji znajdziesz w artykule Wydawanie tokenów JWT.
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 klienta | 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 linię łamaną trasy pojazdu, aby odzwierciedlić postępy 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 na mapę udostępnionej podróży. Więcej informacji znajdziesz w artykule o uruchamianiu wyszukiwania dostawcy lokalizacji podróży.
Za pomocą dostawcy lokalizacji podróży możesz śledzić te informacje o podróży:
|
Śledzenie obiektów w lokalizacji
Dostawca lokalizacji śledzi lokalizację obiektów takich jak punkty drogi 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 śledzonej. Z technicznego punktu widzenia punkty na trasie mogą obejmować miejsca, w których chcesz odebrać lub wsiąść, ale punkty pośrednie zwykle są punktami pośrednimi na trasie. Na przykład przystanki między miejscem odbioru a miejscem docelowym na trasie dostawy to lokalizacje punktów pośrednich. 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 sekcji Lokalizacja pojazdu w dokumentacji Fleet Engine. |
Nadawanie stylów mapom
Style znaczników i linii łamanych określają wygląd i styl obiektów śledzonej 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 własnego lub pochodnego, możesz zmienić reguły widoczności.
Pojazdy są widoczne tylko podczas trwania podróży: pojazd jest widoczny od momentu przypisania do wycieczki do momentu zatrzymania. Jeśli podróż zostanie odwołana, pojazd będzie 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: