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 podróży na żądanie. Zawiera interfejsy, które modelują dane podróży i śledzą podróże w Fleet Engine, oraz 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 odpowiednie profile ról w Fleet Engine.
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. Klienci mogą zobaczyć trasę pojazdu nałożoną na mapę, w tym szczegóły postępów, 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 SDK sterowników i Fleet Engine, możesz tworzyć dostosowane do potrzeb użytkowników funkcje, takie jak:
Dostosuj interfejs mapy do potrzeb związanych z marką.
Śledź bieżącą lokalizację pojazdu podczas jazdy po trasie. Jego pozycja jest okresowo aktualizowana.
wyświetlać szacowany czas dotarcia na miejsce odbioru i miejsce docelowe;
Wyświetl pozostałą odległość.
Wyświetlaj aktualne natężenie ruchu na trasie.
Jak działa pakiet Consumer SDK
Ogólnie rzecz biorąc, pakiet SDK dla konsumentów korzysta z tych mechanizmów:
- 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 wrażenia użytkownika aplikacji z informacjami o ruchu, znacznikami mapy, szacowanym czasem dotarcia na miejsce i danymi o trasie.
Ta tabela pokazuje przebieg podróży śledzony przez aplikację użytkownika.
| 1 | Aplikacja użytkownika wysyła prośbę o przejazd | Serwer backendu otrzymuje żądanie przejazdu na żądanie i wykonuje te czynności:
|
| 2 | Kierowca akceptuje przejazd | Aplikacja dla kierowców otrzymuje identyfikator i informacje o przejazdzie, a kierowca akceptuje przejazd. |
| 3 | Aplikacja użytkownika prosi o dostęp do śledzenia przejazdu | Aplikacja użytkownika pobiera identyfikator przejazdu z Twojego backendu i wysyła prośbę o rozpoczęcie śledzenia przejazdu. |
| 4 | Kierowca rozpoczyna przejazd | Gdy kierowca użyje aplikacji dla kierowców, aby wskazać, że przejazd się rozpoczął, aplikacja powiadomi Twój serwer backendu za pomocą pakietu Driver SDK. na przykład gdy kierowca ma wyjechać z restauracji lub dojechać do miejsca odbioru. |
| 5 | Fleet Engine zaczyna wysyłać informacje o przejazdach | Fleet Engine rozpoczyna śledzenie przejazdu i udostępnianie informacji o jego postępach aplikacji użytkownika. |
| 6 | Aplikacja użytkownika wyświetla informacje o przejeździe | Aplikacja użytkownika powiadamia konsumenta i zaczyna wyświetlać mu informacje o przejazdzie, aktualizując je w miarę postępów. |
| 7 | Przejazd został 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ć przejazd | Przejazd jest oznaczony jako anulowany lub zakończony. |
| 9 | Proces powtarza się w przypadku kolejnej podróży | Zostanie utworzony nowy przejazd 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 Consumer SDK. Więcej informacji znajdziesz w artykule Pobieranie pakietu SDK dla konsumentów na Androida. |
| 2 | Konfigurowanie interfejsu wizualnego | Zdefiniuj mapę i dodaj obsługę map wektorowych, aby skonfigurować sposób korzystania z usługi przez użytkowników. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie przejazdu | Śledź przejazd, aby udostępnić klientowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępów przejazdu i rozwiązywanie problemów z przejazdem | Aktualizuj szczegóły przejazdów, takie jak odległość i szacowany czas dotarcia, oraz rozwiązuj problemy, które mogą wystąpić podczas przejazdu. 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 SDK dla konsumentów na iOS | Aby śledzić przejazdy na żądanie w aplikacji, skonfiguruj pakiet Consumer SDK. Więcej informacji znajdziesz w artykule Pobieranie pakietu SDK dla konsumentów na iOS. |
| 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 przejazdu | Śledź przejazd, aby udostępnić klientowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępów przejazdu i rozwiązywanie problemów z przejazdem | Aktualizuj szczegóły przejazdów, takie jak odległość i szacowany czas dotarcia, oraz rozwiązuj problemy, które mogą wystąpić podczas przejazdu. 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 Consumer SDK. 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 przejazdu | Śledź przejazd, aby udostępnić klientowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępów przejazdu i rozwiązywanie problemów z przejazdem | Aktualizuj szczegóły przejazdów, takie jak odległość i szacowany czas dotarcia, oraz rozwiązuj wszelkie problemy podczas przejazdu. 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 przejazdu:
Opcjonalnie możesz też dostosować środowisko użytkownika 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:
Wdróż na serwerze usługę tworzenia tokenów internetowych JSON (JWT) dla Fleet Engine. Więcej informacji znajdziesz w artykule Wystawianie tokenów JWT.
Zaimplementuj w aplikacjach internetowych lub mobilnych funkcję pobierania tokena uwierzytelniania, 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 trackery podróży
Śledzenie przejazdu obejmuje komponenty do wizualizacji pojazdów i punktów pośrednich, a także nieprzetworzone pliki danych z szacowanym czasem dotarcia na miejsce 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 orientacyjne 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ę przejazdu udostępnioną innym użytkownikom. 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 śledzonych lokalizacji
Dostawca lokalizacji śledzi lokalizację obiektów, takich jak punkty orientacyjne i pojazdy, co opisano w tabeli poniżej.
| Śledzona lokalizacja | Opis |
|---|---|
| Miejsce odbioru | Miejsce odbioru to miejsce, w którym rozpoczyna się przejazd. |
| Lokalizacja docelowa | Miejsce docelowe to lokalizacja, w której kończy się przejazd. Oznacza miejsce wysiadki. |
| Lokalizacja punktu pośredniego | Punkt pośredni to dowolna lokalizacja 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 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 swojej aplikacji internetowej.
Kontrolowanie widoczności śledzonych lokalizacji
Wstępnie zdefiniowani dostawcy lokalizacji w Fleet Engine przestrzegają tych zasad widoczności ś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 trwa przejazd: pojazd jest widoczny od momentu przypisania go do przejazdu do momentu zakończenia przejazdu. Jeśli przejazd zostanie anulowany, 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 przesyłki 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: