Omówienie udostępniania tras w przypadku podróży na żądanie

Gdy korzystasz z udostępniania podróży Fleet Engine w przypadku podróży na żądanie, klienci może śledzić postęp realizacji zamówienia, przejazdu lub innej świadczonej usługi.

Aplikacja dla klientów indywidualnych

Czym jest dzielenie się doświadczeniami?

Udostępnianie trasy to funkcja Fleet Engine używana do obsługi przejazdów na żądanie pakiet SDK dla klientów indywidualnych. Udostępnia interfejsy, które modelują dane o podróżach i śledzą przejazdy we Fleet Engine i oferuje zajęcia, które pozwalają tworzyć wyświetlanie informacji na temat podróży użytkownikom. Integrujesz za pomocą pakietu SDK w aplikacji i ustawić odpowiednie profile ról we Fleet Engine na aby pomagać klientom w udostępnianiu ścieżek.

Udostępnianie doświadczeń zapewnia dostęp do interfejsów API specyficznych dla danej platformy, natywną udostępnianie w aplikacjach. Pakiet SDK dla klientów indywidualnych jest dostępny dla na tych platformach:

Dlaczego warto korzystać z udostępniania podróży?

Dzięki integracji udostępniania przejazdów z aplikacjami do zarządzania wycieczkami na żądanie kompleksowe monitorowanie pojazdu w czasie zbliżonym do rzeczywistego aktualizacje lokalizacji i przypięte pozycje. Twoje klienci mogą zobaczyć trasę pojazdu nałożoną na mapę, w tym szczegóły postępu, które pomogą klientom dowiedzieć się, gdzie jest transport lub dostawa.

Do czego służy dzielenie się doświadczeniami?

Za pomocą informacji z pakietu Driver SDK i Fleet Engine możesz tworzyć szczegółowe Widoki danych mobilnych SDK i odpowiedzi usług sieciowych, które zapewniają następujące funkcje:

  • Dostosuj interfejs mapy do potrzeb swojej marki.

  • Aktualna lokalizacja pojazdu na trasie, jego pozycja jest okresowo aktualizowana.

  • Szacowany czas przyjazdu do miejsc odbioru i zwrotu.

  • Pozostały dystans.

  • Aktualne natężenie ruchu na trasie.

Jak działa udostępnianie podróży

Ogólnie rzecz biorąc, dzielenie się doświadczeniami opiera się na tych mechanizmach:

  • Odpowiednie role użytkowników Fleet Engine, aby uwierzytelnieni użytkownicy aplikacji mogli pobierze informacje o podróży powiązanej z zamówieniem.
  • Związek między konsumentem a podróżą, zapewniany przez do systemu backendu.
  • pakiet SDK dla klientów indywidualnych TripModel i JourneySharingSession oraz klasy pakietu SDK, które modelowanie danych o podróżach i udostępnianie ich sesji w aplikacji dla konsumentów.

Udostępnianie serii

Pakiet SDK dla konsumentów udostępnia też inne interfejsy i klasy, dzięki którym można tworzysz interfejs mapowania aplikacji, aby konsumenci rozbudowana aplikacja i szczegółowe informacje, takie jak natężenie ruchu, znaczniki mapy, szacowany czas dotarcia na miejsce dane o trasach.

Ta tabela przedstawia przepływ współdzielonej podróży.

1 Aplikacja konsumenta wysyła żądanie Podróży. Serwer backendu odbiera żądanie podróży na żądanie i wykonuje :
  • Tworzy podróż we Fleet Engine.
  • Przypisuje podróż do pojazdu we Fleet Engine.
2 Kierowca akceptuje podróż Aplikacja kierowcy otrzymuje identyfikator i informacje o podróży, a kierowca akceptuje tę podróż.
3 Aplikacja klienta prosi o dostęp do ścieżki Aplikacja konsumenta pobiera identyfikator podróży z backendu próśb o rozpoczęcie udostępniania podróży.
4 Kierowca rozpoczyna podróż Gdy kierowca korzysta z aplikacji kierowcy, aby zasygnalizować, że w podróży aplikacja powiadamia serwer backendu za pomocą pakietu Driver SDK. Jeśli na przykład kierowca jest wyjdziesz z restauracji lub jedziesz do miejsca odbioru.
5 Fleet Engine zaczyna udostępniać informacje o swojej podróży Fleet Engine rozpoczyna śledzenie podróży i udostępnianie o postęp w jej obsłudze.
6 Aplikacja konsumenta wyświetla podróż Aplikacja powiadamia konsumenta i zaczyna wyświetlać wraz z postępami w drodze do klienta.
7 Podróż została zakończona lub anulowana Gdy kierowca anuluje lub zakończy podróż, aplikacja sterownika wyłącza śledzenie lokalizacji, a serwer backendu informuje usługę Fleet Engine, aby oznaczyć podróż jako anulowaną lub zakończoną.
8 Aplikacja klienta przestaje udostępniać ścieżkę klienta Podróż jest oznaczona jako anulowana lub zakończona.
9 Proces powtarza się w przypadku następnej podróży Zostanie utworzona nowa podróż i proces będzie się powtarzał.

Jak korzystać z udostępniania podróży

Wybierz platformę, aby dowiedzieć się, jak rozpocząć udostępnianie materiałów.

Android

1 Konfigurowanie pakietu SDK dla użytkowników na Androidzie Aby udostępniać w aplikacji trasy podróży na żądanie, skonfiguruj pakiet SDK Consumer SDK. Więcej informacji znajdziesz w artykule Pobieranie Android Consumer SDK.
2 Konfigurowanie wizualnego interfejsu udostępniania podróży Aby skonfigurować interfejs podróży, możesz zdefiniować mapę i dodać obsługę map wektorowych. Więcej informacji znajdziesz w artykule Konfigurowanie mapy.
3 Dziel się podróżami Śledź podróż, aby udostępnić konsumentowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Obserwowanie podróży.
5 Aktualizowanie postępu i eliminowanie błędów w podróży aktualizować szczegóły podróży, takie jak odległość i szacowany czas dotarcia na miejsce, oraz usuwać wszelkie błędy, które wystąpiły podczas tej podróży; Więcej informacji: Aktualizowanie postępów w podróży i Obsługa błędów dotyczących podróży
5 Po zakończeniu podróży przestań udostępniać Aby przestać udostępniać konsumentowi lokalizację pojazdu, przestań ją obserwować. Więcej informacji znajdziesz w artykule Anulowanie obserwowania podróży.

iOS

1 Konfigurowanie pakietu SDK dla klientów indywidualnych w systemie iOS Aby udostępniać w aplikacji trasy podróży na żądanie, skonfiguruj pakiet SDK Consumer SDK. Więcej informacji znajdziesz w artykule Pobieranie pakietu SDK dla konsumentów na iOS.
2 Konfigurowanie wizualnego interfejsu udostępniania podróży Zainicjuj widok mapy i obsługuj zdarzenia na mapie, aby skonfigurować interfejs podróży. Więcej informacji znajdziesz w artykule Konfigurowanie mapy.
3 Dziel się podróżami Śledź podróż, aby udostępnić konsumentowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Obserwowanie podróży.
5 Aktualizowanie postępu i eliminowanie błędów w podróży aktualizować szczegóły podróży, takie jak odległość i szacowany czas dotarcia na miejsce, oraz usuwać wszelkie błędy, które wystąpiły podczas tej podróży; Więcej informacji: Aktualizowanie postępów w podróży i Obsługa błędów dotyczących podróży
5 Po zakończeniu podróży przestań udostępniać Aby przestać udostępniać konsumentowi lokalizację pojazdu, przestań ją obserwować.Więcej informacji znajdziesz w artykule Anulowanie śledzenia podróży.

JavaScript

1 Konfigurowanie udostępniania Journey w języku JavaScript Aby udostępniać w aplikacji trasy podróży na żądanie, skonfiguruj pakiet SDK Consumer SDK. Więcej informacji znajdziesz w artykule Konfigurowanie pakietu JavaScript Consumer SDK.
2 Wczytywanie i dostosowywanie mapy udostępniania trasy Włącz Maps JavaScript API i skonfiguruj autoryzację, aby skonfigurować interfejs podróży. Więcej informacji znajdziesz w artykule Konfigurowanie mapy.
3 Dziel się podróżami Śledź podróż, aby udostępnić konsumentowi lokalizację odpowiedniego pojazdu. Więcej informacji znajdziesz w artykule Obserwowanie podróży.
5 Aktualizowanie postępu i eliminowanie błędów w podróży aktualizować szczegóły podróży, takie jak odległość i szacowany czas dotarcia na miejsce, oraz usuwać wszelkie błędy, które wystąpiły podczas tej podróży; Więcej informacji: aktualizować i śledzić postępy w podróży oraz Obsługa błędów dotyczących podróży
5 Po zakończeniu podróży przestań udostępniać Aby przestać udostępniać konsumentowi lokalizację pojazdu, przestań ją obserwować. Więcej informacji znajdziesz w artykule Zatrzymywanie udostępniania podróży.

Komponenty

W tej sekcji podsumowujemy 2 elementy niezbędne do udostępnienia podróży:

Opcjonalnie możesz też dostosować środowisko udostępniania podróży za pomocą tych komponenty:

Pobieranie tokenów uwierzytelniania

Aby kontrolować dostęp do danych o lokalizacji przechowywanych we Fleet Engine, wykonaj :

  1. Wdrażanie usługi tworzenia tokenów sieciowych JSON (JWT) na potrzeby Fleet Engine na swoim serwerze.

  2. Implementowanie modułu pobierania tokenów uwierzytelniania w swoich aplikacjach internetowych lub mobilnych aby uwierzytelnić dostęp do danych o lokalizacji.

Dla: więcej informacji znajdziesz w przewodniku po konfiguracji na Androida, iOS lub JavaScript.

Widok mapy i śledzenie podróży

Udostępnianie ścieżki obejmuje komponenty do wizualizacji pojazdów i punktów pośrednich, a także nieprzetworzone pliki danych z szacowanym czasem dotarcia na miejsce albo pozostałą odległość do przejechania.

W poniższej tabeli opisano te komponenty:

Komponent Opis
Widok mapy udostępniania trasy Widok mapy umożliwia zarządzanie cyklem życia podróży i pokazuje punkty na trasie dla lokalizacji pojazdów w trakcie podróży. Jeśli trasa pojazdu jest znana, widok mapy aktualizuje trasę. linia łamana, aby wskazać postęp pojazdu na trasie.
Dostawca lokalizacji podróży w JavaScript W przypadku aplikacji internetowych JavaScript informacje o lokalizacji dostawcy lokalizacji podróży informacji o śledzonych obiektach na współdzielonej mapie podróży. Więcej Więcej informacji zawiera Błyskawiczne tworzenie dostawcy lokalizacji podróży. Możesz korzystać z usług dostawcy lokalizacji dla podróży, aby śledzić następujące informacje dotyczące konkretnej lokalizacji podróż:
  • Miejsce odbioru lub miejsca docelowego podróży.
  • Lokalizacja i trasa pojazdu przypisanego do podróży.

Obiekty ze śledzoną lokalizacją

Dostawca danych o lokalizacji śledzi lokalizację obiektów, takich jak punkty pośrednie pojazdów opisanych w poniższej tabeli.

Śledzona lokalizacja Opis
Miejsce odbioru Miejsce odbioru to miejsce, w którym zaczyna się podróż. Zaznacza wybierz miejsce odbioru.
Lokalizacja docelowa Lokalizacja docelowa to miejsce, w którym kończy się podróż. Wskazuje lokalizację miejsca zwrotu.
Lokalizacja punktu pośredniego Lokalizacja punktu pośredniego to dowolne miejsce pośrednie na trasie śledzona ścieżka. Technicznie rzecz biorąc, punkty na trasie mogą obejmować miejsca odbioru i zwrotu, punkty pośrednie zwykle odnoszą się do średniozaawansowanych przystanki na trasie. Na przykład przystanki między odbiorem a miejscem docelowym lokalizacje na trasie dostawy to punkty pośrednie. Więcej informacji: Punkty na trasie podróży w dokumentacji Fleet Engine.
Lokalizacja pojazdu Lokalizacja pojazdu to zgłoszona lokalizacja pojazdu. Więcej informacje, patrz Lokalizacja pojazdu. w dokumentacji Fleet Engine.

Nadaj mapom styl

Style znaczników i linii łamanych określają wygląd i styl śledzone obiekty lokalizacji na mapie. Za pomocą niestandardowe opcje stylu pozwalające zmienić styl domyślny w celu dostosowania go do stylu Twojej aplikacji internetowej.

Kontrolowanie widoczności śledzonych lokalizacji

Dostawcy wstępnie zdefiniowanych lokalizacji we Fleet Engine przestrzegają tych reguł widoczności dla obiektów śledzonych na mapie. Jeśli utworzysz niestandardowe lub pochodne możesz zmienić reguły widoczności.

  • Pojazdy są widoczne tylko wtedy, gdy trwa podróż: podróż. pojazd udostępniający jest widoczny od momentu przypisania do grupy godzinę zwrotu. Jeśli podróż zostanie odwołana, pojazd będzie widoczny dłużej.

  • Wszystkie inne znaczniki lokalizacji są zawsze widoczne: wszystkie pozostałe znaczniki lokalizacji są widoczne. miejsca wylotu, cel podróży i punkty pośrednie są zawsze wyświetlane na mapie. Dla: np. udostępnienie miejsca nadania lub dostawy przesyłki lokalizacja jest zawsze wyświetlana na mapie, niezależnie od stanu podróży czy dostawy.

Co dalej?

Zapoznaj się z dokumentacją platformy, na której chcesz dzielić się doświadczeniami: