Dostosuj wrażenia konsumentó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 Consumer SDK na potrzeby poszczególnych platform umożliwiają udostępnianie ścieżek w natywnym środowisku aplikacji. Pakiet SDK dla konsumentów jest dostępny na tych platformach:
Dlaczego warto korzystać z Consumer SDK?
Dzięki zintegrowaniu pakietu Consumer SDK z aplikacją do zamawiania przejazdów możesz 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?
Za pomocą informacji z Driver SDK i Fleet Engine możesz tworzyć spersonalizowane rozwiązania dla klientów, które obejmują:
Dostosuj interfejs mapy do swoich potrzeb związanych z brandingiem.
Śledź bieżącą 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 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
TripModeliJourneySharingSession, które modelują dane podróży i udostępniają sesje podróży w aplikacji dla konsumentó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 śledzonej przez aplikację dla konsumentów.
| 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 podróży, a kierowca akceptuje ją. |
| 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 używa aplikacji, aby wskazać, że podróż się rozpoczęła, aplikacja wysyła powiadomienie do Twojego serwera 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 użytkowników. |
| 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 | 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 | Konfigurowanie interfejsu wizualnego | Zdefiniuj mapę i dodaj obsługę map wektorowych, aby skonfigurować wrażenia klientów. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie podróży | Ś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 dojazdu, 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 Zatrzymywanie śledzenia 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 użytkowników iOS. |
| 2 | Konfigurowanie interfejsu wizualnego | Inicjuj widok mapy i obsługuj zdarzenia mapy, aby skonfigurować wrażenia klientów. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie podróży | Ś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 dojazdu, 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 Zatrzymywanie śledzenia podróży. |
JavaScript
| 1 | Konfigurowanie pakietu Consumer SDK w języku JavaScript | 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 | Ładowanie i dostosowywanie mapy | Aby skonfigurować interfejs Maps JavaScript API, włącz go i skonfiguruj autoryzację. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie podróży | Ś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 dojazdu, oraz obsługiwać wszelkie błędy podczas podróży; Więcej informacji znajdziesz w artykułach Aktualizowanie i śledzenie postępu przejazdu oraz 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 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 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:
|
Śledzenie obiektó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 wysiadku, |
| 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 pośrednich przystanków 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 podróż jest w toku: pojazd jest widoczny od momentu przypisania go do podróży do momentu jej zakończenia. Jeśli podróż zostanie anulowana, 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 przesyłki 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: