Dostosowywać wrażenia klientó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 SDK dla konsumentów?
Pakiet Consumer SDK jest częścią Fleet Engine do podróży na żądanie. Zawiera interfejsy, które modelują dane podróży i śledzą podróże w Fleet Engine, a także klasy, których możesz używać do tworzenia bogatych wyświetleń opartych na mapach, aby udostępniać podróże użytkownikom. Aby zapewnić użytkownikom takie możliwości, zintegruj pakiet Consumer SDK z aplikacją i skonfiguruj w Fleet Engine odpowiednie profile ról.
Interfejsy API platformy Consumer SDK umożliwiające tworzenie funkcji udostępniania przejazdów w aplikacjach. Pakiet SDK dla konsumentów jest dostępny na tych platformach:
Dlaczego warto korzystać z pakietu SDK dla konsumentów?
Zintegrowanie pakietu SDK dla konsumentów z aplikacjami do zamawiania przejazdów na żądanie umożliwia zapewnienie kompleksowej obsługi klienta dzięki aktualizacjom lokalizacji w czasie zbliżonym do rzeczywistego i pozycjom przyciąganym do dróg. Twoi klienci 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 robić za pomocą pakietu Consumer SDK?
Korzystając z informacji z pakietu Driver SDK i Fleet Engine, możesz tworzyć dostosowane do potrzeb użytkowników funkcje, takie jak:
Dostosuj interfejs mapy do potrzeb swojej marki.
Śledź bieżącą lokalizację pojazdu podczas jego przejazdu po trasie. Jego pozycja będzie okresowo aktualizowana.
wyświetlać szacowany czas dotarcia na miejsce odbioru i miejsce docelowe;
Wyświetl pozostałą odległość.
Wyświetlanie na trasie informacji o natężeniu ruchu na żywo.
Jak działa pakiet Consumer SDK
Ogólnie pakiet SDK dla konsumentów korzysta z tych mechanizmów:
- mieć odpowiednie role Fleet Engine, aby uwierzytelniona aplikacja mogła śledzić przejazd powiązany z zamówieniem konsumenta.
- Powiązanie między konsumentem a podróżą, dostarczane przez system backendu.
- Klasy pakietu SDK
TripModeliJourneySharingSession, które modelują dane o podróży i udostępniają sesje podróży w aplikacji konsumenckiej.
Pakiet Consumer SDK udostępnia też inne interfejsy i klasy, dzięki którym możesz tworzyć rozbudowane aplikacje z informacjami o ruchu, znacznikami na mapie, szacowanym czasie przyjazdu i danymi o trasie.
Ta tabela przedstawia przebieg podróży śledzony przez aplikację konsumencką.
| 1 | Aplikacja konsumencka wysyła prośbę 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 przejazdzie, a kierowca akceptuje przejazd. |
| 3 | Aplikacja konsumencka prosi o dostęp do śledzenia przejazdu | Aplikacja konsumencka pobiera identyfikator przejazdu z Twojego backendu i wysyła prośbę o rozpoczęcie śledzenia przejazdu. |
| 4 | Kierowca rozpoczyna przejazd | Gdy kierowca używa aplikacji dla kierowców, aby wskazać, że przejazd się rozpoczął, aplikacja powiadamia backend serwera za pomocą pakietu Driver SDK. Na przykład, gdy kierowca ma opuścić restaurację lub dojechać do miejsca odbioru. |
| 5 | Fleet Engine zaczyna wysyłać informacje o przejazdach | Fleet Engine rozpoczyna śledzenie przejazdu i udostępnianie postępów aplikacji konsumenckiej. |
| 6 | Aplikacja konsumencka wyświetla informacje o przejazdzie | Aplikacja dla konsumentów powiadamia konsumenta i zaczyna wyświetlać mu informacje o przejazdzie, aktualizując je w miarę postępów. |
| 7 | Podróż została anulowana lub zakończona | 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 konsumencka przestaje śledzić przejazd | Podróż jest oznaczona jako anulowana lub zakończona. |
| 9 | Proces powtarza się w przypadku kolejnej podróży | Zostanie utworzona nowa podróż i proces się powtórzy. |
Jak korzystać z pakietu Consumer SDK
Wybierz platformę, aby dowiedzieć się, jak zacząć śledzić przejazdy w aplikacjach dla konsumentów.
Android
| 1 | Konfigurowanie pakietu SDK dla konsumentów 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 użytkowników. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie podróży | Śledź przejazd, 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 rozwiązywanie problemów z nią związanych | Aktualizuj szczegóły podróży, takie jak odległość i szacowany czas przyjazdu, oraz rozwiązuj problemy, które mogą wystąpić w trakcie podróży. Więcej informacji znajdziesz w sekcjach Aktualizowanie postępu podróży i Obsługa błędów podróży. |
| 5 | Po zakończeniu podróży przestań ją śledzić | Aby przestać udostępniać lokalizację pojazdu klientowi, przestań śledzić przejazd. 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 SDK dla konsumentów. Więcej informacji znajdziesz w artykule Pobieranie pakietu iOS Consumer SDK. |
| 2 | Konfigurowanie interfejsu wizualnego | Aby skonfigurować środowisko użytkownika, zainicjuj widok mapy i obsługuj zdarzenia mapy. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie podróży | Śledź przejazd, 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 rozwiązywanie problemów z nią związanych | Aktualizuj szczegóły podróży, takie jak odległość i szacowany czas przyjazdu, oraz rozwiązuj problemy, które mogą wystąpić w trakcie podróży. Więcej informacji znajdziesz w sekcjach Aktualizowanie postępu podróży i Obsługa błędów podróży. |
| 5 | Po zakończeniu podróży przestań ją śledzić | Aby przestać udostępniać lokalizację pojazdu klientowi, przestań śledzić przejazd. 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 SDK dla konsumentów. Więcej informacji znajdziesz w artykule Konfigurowanie pakietu JavaScript Consumer SDK. |
| 2 | Wczytywanie i dostosowywanie mapy | Aby skonfigurować środowisko użytkownika, włącz interfejs Maps JavaScript API i skonfiguruj autoryzację. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie podróży | Śledź przejazd, 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 rozwiązywanie problemów z nią związanych | Aktualizuj szczegóły podróży, takie jak odległość i szacowany czas przyjazdu, oraz rozwiązuj problemy podczas podróży. Więcej informacji znajdziesz w sekcjach Aktualizowanie postępu podróży i śledzenie go oraz Rozwiązywanie problemów z podróżami. |
| 5 | Po zakończeniu podróży przestań ją śledzić | Aby przestać udostępniać lokalizację pojazdu klientowi, przestań śledzić przejazd. Więcej informacji znajdziesz w artykule Przestawanie śledzenia podróży. |
Komponenty
W tej sekcji znajdziesz podsumowanie 2 niezbędnych komponentów, które umożliwiają śledzenie podróży:
Opcjonalnie możesz też dostosować środowisko użytkownika 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:
Wdróż na serwerze usługę tworzenia tokenów sieciowych JSON (JWT) dla Fleet Engine. Więcej informacji znajdziesz w artykule Wystawianie tokenów JWT.
Zaimplementuj w aplikacjach internetowych lub mobilnych narzędzie do pobierania tokenów uwierzytelniających, aby uwierzytelniać dostęp do danych o lokalizacji. Więcej informacji o konfigurowaniu narzędzia do pobierania tokenów znajdziesz w przewodniku po konfiguracji dla 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 surowe pliki danych z szacowanym czasem przyjazdu kierowcy lub pozostałą odległością do przejechania.
W tabeli poniżej znajdziesz opis tych komponentów:
| Komponent | Opis |
|---|---|
| Widok mapy dla konsumentów | Widok mapy zarządza cyklem życia przejazdu, wyświetlając punkty pośrednie dla lokalizacji pojazdów w trakcie przejazdu. Jeśli trasa pojazdu jest znana, widok mapy aktualizuje polilinię trasy pojazdu, aby wskazać postęp pojazdu na trasie. |
| Dostawca lokalizacji przejazdu w JavaScript | W przypadku aplikacji internetowych w JavaScript dostawca lokalizacji przejazdu przekazuje informacje o lokalizacji śledzonych obiektów na mapę udostępnionego przejazdu. 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:
|
Obiekty śledzonej lokalizacji
Dostawca lokalizacji śledzi lokalizację obiektów, takich jak punkty orientacyjne i pojazdy, co zostało opisane w tej tabeli.
| Śledzona lokalizacja | Opis |
|---|---|
| Miejsce odbioru | Miejsce odbioru to miejsce, w którym rozpoczyna się przejazd. |
| Lokalizacja docelowa | Lokalizacja docelowa to miejsce, w którym kończy się podróż. Wskazuje miejsce wysiadki. |
| Lokalizacja punktu na trasie | Punkt pośredni to dowolna lokalizacja pośrednia na trasie śledzonej podróży. Chociaż punkty pośrednie mogą obejmować miejsca odbioru i docelowe, zwykle odnoszą się do przystanków pośrednich 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 artykule Punkty pośrednie przejazdu w dokumentacji Fleet Engine. |
| Lokalizacja pojazdu | Lokalizacja pojazdu to zgłoszona lokalizacja pojazdu. Więcej informacji znajdziesz w sekcji Lokalizacja pojazdu w dokumentacji Fleet Engine. |
Nadawanie stylu mapom
Style znacznika i linii łamanej określają wygląd śledzonych obiektów lokalizacji na mapie. Możesz użyć niestandardowych opcji stylizacji, aby dopasować styl do swojej aplikacji internetowej.
Kontrolowanie widoczności śledzonych lokalizacji
Wstępnie zdefiniowani dostawcy lokalizacji w Fleet Engine przestrzegają tych zasad 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 jest widoczny od momentu przypisania go do podróży do momentu zakończenia przejazdu. Jeśli podróż zostanie anulowana, pojazd nie będzie już widoczny.
Wszystkie pozostałe znaczniki lokalizacji są zawsze widoczne: wszystkie pozostałe znaczniki lokalizacji dla miejsca początkowego, docelowego i punktów pośrednich są zawsze widoczne na mapie. Na przykład miejsce docelowe przejazdu lub dostawy jest zawsze widoczne na mapie, niezależnie od stanu przejazdu lub dostawy.
Co dalej?
Zapoznaj się z dokumentacją platformy, na której chcesz śledzić przejazdy: