Dostosuj wrażenia konsumentów podczas przejazdów na żądanie, umożliwiając im śledzenie przejazdu w przypadku zamówienia, przejazdu lub innej usługi, którą im świadczysz.
Czym jest pakiet SDK dla konsumentów?
Pakiet SDK dla klientów jest częścią Fleet Engine do przejazdów na żądanie. Zapewnia interfejsy, które modelują dane o przejazdach i śledzą przejazdy we Fleet Engine, oraz klasy, których możesz używać do tworzenia rozbudowanych wyświetleń na mapie, aby udostępniać przejazdy użytkownikom. Aby utworzyć to środowisko klienta, zintegruj pakiet Consumer SDK z aplikacją i ustaw odpowiednie profile ról we Fleet Engine.
Interfejsy API pakietu Consumer SDK dla konkretnych platform umożliwiają tworzenie funkcji udostępniania podróży natywnie w aplikacjach. Pakiet Consumer SDK jest dostępny na tych platformach:
Dlaczego warto używać pakietu SDK dla konsumentów?
Zintegrowanie pakietu SDK dla konsumentów z aplikacjami do przejazdów na żądanie umożliwia zapewnienie konsumentom kompleksowej obsługi dzięki informacjom o zmianie lokalizacji w czasie zbliżonym do rzeczywistego i pozycjom przyciągniętym do drogi. Klienci mogą zobaczyć trasę pojazdu nałożoną na mapę, w tym szczegóły dotyczące postępów, 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, aby tworzyć spersonalizowane funkcje dla klientów, takie jak:
Dostosuj interfejs mapy do potrzeb swojej marki.
Śledź bieżącą lokalizację pojazdu, gdy porusza się on po trasie, a jego pozycja jest okresowo aktualizowana.
Wyświetlaj szacowany czas dotarcia na miejsce (ETA) w przypadku lokalizacji odbioru i wysiadki.
pokazywać pozostałą odległość,
pokazywać aktualne natężenie ruchu na trasie,
Jak działa pakiet SDK dla konsumentów
Ogólnie pakiet Consumer SDK opiera się na tych mechanizmach:
- odpowiednie role Fleet Engine, aby uwierzytelniona aplikacja mogła śledzić przejazd powiązany z zamówieniem klienta.
- Powiązanie między konsumentem a przejazdem, które jest dostarczane przez system backendu.
- Klasy pakietu SDK
TripModeliJourneySharingSession, które modelują dane o przejazdach i udostępniają sesje przejazdów w aplikacji użytkownika.
Pakiet Consumer SDK udostępnia też inne interfejsy i klasy, dzięki którym możesz tworzyć rozbudowane wrażenia użytkownika aplikacji z takimi szczegółami jak natężenie ruchu, znaczniki mapy, szacowany czas dotarcia na miejsce i dane o trasie.
Ta tabela przedstawia przebieg przejazdu śledzonego przez aplikację użytkownika.
| 1 | Aplikacja użytkownika 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 użytkownika prosi o dostęp do śledzenia przejazdu | Aplikacja użytkownika pobiera identyfikator przejazdu z Twojego backendu i prosi 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 serwer backendu za pomocą pakietu Driver SDK. Na przykład gdy kierowca ma opuścić restaurację lub pojechać do miejsca odbioru. |
| 5 | Fleet Engine zaczyna wysyłać informacje o przejeździe | Fleet Engine zaczyna śledzić przejazd i udostępniać informacje o jego postępach aplikacji użytkownika. |
| 6 | Aplikacja użytkownika wyświetla informacje o przejeździe | Aplikacja użytkownika powiadamia go i zaczyna wyświetlać informacje o przejeździe, aktualizując je w miarę jego postępu. |
| 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, że przejazd został anulowany lub zakończony. |
| 8 | Aplikacja użytkownika przestaje śledzić przejazd | Przejazd jest oznaczony jako anulowany lub ukończony. |
| 9 | Proces powtarza się w przypadku kolejnego przejazdu | Tworzony jest nowy przejazd i proces się powtarza. |
Jak korzystać z pakietu SDK dla klientów
Wybierz platformę, aby dowiedzieć się, jak zacząć śledzić przejazdy w aplikacjach użytkownika.
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 | Aby skonfigurować środowisko klienta, zdefiniuj mapę i dodaj obsługę map wektorowych. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie przejazdu | Śledź przejazd, aby udostępnić konsumentowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępów przejazdu i obsługa błędów | aktualizować szczegóły przejazdów, takie jak odległość i szacowany czas dotarcia, oraz obsługiwać błędy podczas przejazdu; Więcej informacji znajdziesz w artykułach Aktualizowanie postępów przejazdu i Postępowanie w przypadku błędów przejazdu. |
| 5 | Zatrzymywanie śledzenia po zakończeniu przejazdu | Przestań obserwować przejazd, aby przestać udostępniać lokalizację pojazdu klientowi. Więcej informacji znajdziesz w sekcji Zatrzymywanie ś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 | Zainicjuj widok mapy i obsługuj zdarzenia na mapie, aby skonfigurować interfejs klienta. Więcej informacji znajdziesz w artykule Konfigurowanie mapy. |
| 3 | Obserwowanie przejazdu | Śledź przejazd, aby udostępnić konsumentowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępów przejazdu i obsługa błędów | aktualizować szczegóły przejazdów, takie jak odległość i szacowany czas dotarcia, oraz obsługiwać błędy podczas przejazdu; Więcej informacji znajdziesz w artykułach Aktualizowanie postępów przejazdu i Postępowanie w przypadku błędów przejazdu. |
| 5 | Zatrzymywanie śledzenia po zakończeniu przejazdu | Przestań obserwować przejazd, aby przestać udostępniać lokalizację pojazdu klientowi. Więcej informacji znajdziesz w sekcji Zatrzymywanie śledzenia podróży. |
JavaScript
| 1 | Konfigurowanie pakietu SDK dla konsumentów w języku JavaScript | Aby śledzić przejazdy na żądanie w aplikacji, skonfiguruj pakiet Consumer SDK. Więcej informacji znajdziesz w artykule o konfigurowaniu pakietu SDK dla konsumentów w języku JavaScript. |
| 2 | Wczytywanie i dostosowywanie mapy | Aby skonfigurować środowisko klienta, 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ć konsumentowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Śledzenie przejazdu. |
| 5 | Aktualizowanie postępów przejazdu i obsługa błędów | aktualizować szczegóły przejazdów, takie jak odległość i szacowany czas dotarcia, oraz obsługiwać błędy podczas przejazdu; Więcej informacji znajdziesz w artykułach Aktualizowanie i śledzenie postępów przejazdu i Obsługa błędów przejazdu. |
| 5 | Zatrzymywanie śledzenia po zakończeniu przejazdu | Przestań obserwować przejazd, aby przestać udostępniać lokalizację pojazdu klientowi. Więcej informacji znajdziesz w sekcji Zatrzymywanie śledzenia podróży. |
Komponenty
W tej sekcji znajdziesz podsumowanie 2 komponentów niezbędnych do śledzenia przejazdu:
Opcjonalnie możesz też dostosować interfejs klienta 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:
Zaimplementuj 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 moduł pobierania tokenów uwierzytelniania, aby uwierzytelniać dostęp do danych o lokalizacji. Więcej informacji o konfigurowaniu modułu pobierania tokenów znajdziesz w przewodniku po konfiguracji na Android, iOS lub JavaScript.
Widok mapy i śledzenie podróży
Śledzenie przejazdu obejmuje komponenty do wizualizacji pojazdów i punktów orientacyjnych, a także nieprzetworzone pliki danych dotyczące szacowanego czasu 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 konsumenta | Widok mapy zarządza cyklem życia przejazdu, pokazując punkty orientacyjne dla lokalizacji pojazdów w miarę postępu przejazdu. Jeśli trasa pojazdu jest znana, widok mapy aktualizuje polilinię trasy pojazdu, aby wskazać postęp pojazdu na trasie. |
| Dostawca lokalizacji przejazdu w języku JavaScript | W przypadku aplikacji internetowych JavaScript dostawca lokalizacji przejazdu przekazuje informacje o lokalizacji śledzonych obiektów do udostępnionej mapy przejazdu. Więcej informacji znajdziesz w artykule Tworzenie instancji dostawcy lokalizacji przejazdu.
Za pomocą dostawcy lokalizacji przejazdu możesz śledzić te szczegóły przejazdu:
|
Obiekty śledzonych lokalizacji
Dostawca lokalizacji śledzi lokalizację obiektów, takich jak punkty orientacyjne i pojazdy, które 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 miejsce, w którym kończy się przejazd. Oznacza miejsce wysiadki. |
| Lokalizacja punktu na trasie | Punkt pośredni to dowolna lokalizacja pośrednia na trasie śledzonego przejazdu. Chociaż technicznie rzecz biorąc, punkty pośrednie mogą obejmować miejsca odbioru i wysiadania, 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 artykule Lokalizacja pojazdu w dokumentacji Fleet Engine. |
Nadawanie stylu mapom
Style znaczników i linii łamanych określają wygląd i styl śledzonych obiektów lokalizacji na mapie. Możesz użyć opcji stylu niestandardowego, aby dopasować go do stylu aplikacji internetowej.
Kontrolowanie widoczności śledzonych lokalizacji
Wstępnie zdefiniowani dostawcy lokalizacji w Fleet Engine stosują te reguły widoczności obiektów śledzonych lokalizacji na mapie. Jeśli utworzysz niestandardowego lub pochodnego dostawcę lokalizacji, możesz zmienić reguły widoczności.
Pojazdy są widoczne tylko podczas przejazdu: pojazd jest widoczny od momentu przypisania go do przejazdu do momentu wysadzenia pasażera. Jeśli przejazd zostanie anulowany, pojazd nie będzie już widoczny.
Wszystkie pozostałe znaczniki lokalizacji są zawsze widoczne: wszystkie pozostałe znaczniki lokalizacji miejsca początkowego, miejsca docelowego i punktów pośrednich są zawsze widoczne na mapie. Na przykład miejsce wysiadania lub miejsce 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: