Dokumentacja w tej sekcji pokazuje, jak tworzyć przejazdy i z nich korzystać za pomocą usługi przejazdów na żądanie w Mapach Google. Zakładamy, że znasz te elementy:
- Fleet Engine: musisz znać szczegóły implementacji Fleet Engine, mechanizmy żądań i bezpieczeństwo. Więcej informacji znajdziesz w artykule Co to jest usługa Fleet Engine? oraz w tematach dotyczących bezpieczeństwa w artykule Konfigurowanie Fleet Engine.
- Podstawy dotyczące pojazdów w przypadku usług na żądanie. Zapoznaj się z artykułem Wprowadzenie do pojazdów.
- Podstawowe informacje o podróży dotyczące usług na żądanie. Zobacz Podróże na żądanie.
TripService, którego użyjesz, jest dostępny w przypadku interfejsów gRPC i REST.
Ze względu na prostotę odwołania do pól są zgodne z konwencją gRPC.
W Fleet Engine w przypadku usług na żądanie przejazd to rodzaj podróży, która modeluje realizację zamówienia dostawy jedzenia lub przejazdu przez klienta. Podróż ma stan, który przekazujesz do Fleet Engine w miarę rozwoju podróży, np. NEW, ENROUTE_TO_PICKUP i inne. Stan podróży odpowiada punktom kontrolnym z dokładnym podaniem lokalizacji przypisanym do pojazdu, a silnik floty modyfikuje te punkty kontrolne pojazdu przy każdej aktualizacji podróży. Aby dowiedzieć się więcej o podróżach i ich związku z pojazdami, zapoznaj się z artykułem Podróże na żądanie w sekcji Podstawowe informacje o Fleet Engine.
Życie w podróży
Aby śledzić każdą podróż w Fleet Engine, musisz najpierw utworzyć element Trip. W tym celu możesz skorzystać z interfejsu gRPC lub REST.
W tabeli poniżej opisano przykładowy proces od początku do końca podróży utworzonej w Twoim systemie oraz jej etapy cyklu życia w Fleet Engine. Zakładamy, że masz skonfigurowany Fleet Engine i masz pojazd, który chcesz przypisać do podróży, a w aplikacji dla kierowcy włączone są aktualizacje lokalizacji. Zapoznaj się z artykułem Pakiet SDK dla kierowcy: podróże na żądanie.
| 1 | Otrzymaj prośbę o rezerwację. | Zanim rozpocznie się przejazd w Fleet Engine, system rezerwacji otrzymuje najpierw prośbę o przejazd lub dostawę od klienta za pomocą aplikacji lub innego systemu rezerwacji. Następnie Twój system tworzy element podróży za pomocą
CreateTrip z wymaganymi polami, takimi jak miejsce odbioru.
Może też w tym momencie ustawić inne pola, takie jak lista pasażerów i miejsce docelowe, lub poczekać, aż przypisze pojazd. Zapoznaj się z artykułem Tworzenie podróży do jednego miejsca docelowego. |
| 2 | Przypisz pojazd. | Możesz przypisywać pojazdy do przejazdów bezpośrednio w swoim systemie i zgłaszać przypisanie do Fleet Engine lub skorzystać z usługi Wyszukiwanie pojazdu, aby wyszukać pojazdy, filtrując je według atrybutów przejazdu i pojazdu, aby znaleźć najlepszy pojazd do przejazdu. Każdy pojazd online w zasięgu wyszukiwania informuje o swojej obecności za pomocą aktualizacji lokalizacji udostępnianych przez pakiet SDK Driver. Gdy |
| 3 | Zaktualizuj podróż. | Gdy kierowca zaakceptuje przejazd i zacznie nawigować do miejsca odbioru, system zaktualizuje stan przejazdu z NEW na ENROUTE_TO_PICKUP. Podczas podróży nadal sprawdzasz lokalizację pojazdu, korzystając z bezpośredniego połączenia aplikacji z Twoim backendem lub za pomocą sondowania usługi Fleet Engine, która otrzymuje stały strumień aktualizacji lokalizacji pojazdu z pakietu Driver SDK. Twój system zgłasza następnie każdy etap podróży do Fleet Engine, który odpowiednio aktualizuje listę punktów orientacyjnych pojazdu.
|
| 4 | Udostępnianie ścieżki konsumentowi. | Fleet Engine udostępnia szczegóły podróży i lokalizację pojazdu pakietowi konsumenckiemu SDK, który korzysta z odbioru danych przez listenera, aby otrzymywać aktualizacje dotyczące podróży i wyświetlać je w aplikacji dla konsumentów. Fleet Engine automatycznie aktualizuje przewidywany czas przybycia, pozostały dystans, trasy i pozostałe punkty pośrednie pojazdu. Więcej informacji znajdziesz w artykule Udostępnianie przejazdów na żądanie. |
| 5 | Ukończ podróż. | Gdy pojazd dotrze do punktu docelowego przejazdu, a kierowca potwierdzi, że przejazd się zakończył, system ustawi wartość TripStatus na COMPLETE w Fleet Engine. Pamiętaj, że podobnie jak w przypadku pojazdów, elementy podróży pozostają aktywne w Fleet Engine przez 7 dni niezależnie od stanu, po czym są usuwane. |
Sekwencja podróży
Ten diagram przedstawia bardziej szczegółowy widok tego procesu.
