Dokumentacja w tej sekcji pokazuje, jak tworzyć przejazdy i z nich korzystać za pomocą usługi przejazdów na żądanie w Mobilności w Mapach Google. Zakładamy, że zna on następujące zagadnienia:
- Fleet Engine: znasz szczegóły implementacji Fleet Engine, mechanizmy żądań i zabezpieczenia. Więcej informacji znajdziesz w artykule Co to jest usługa Fleet Engine? oraz w tematach dotyczących zabezpieczeń w artykule Konfigurowanie Fleet Engine.
- Podstawowe informacje o pojazdach w usługach 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 lub ENROUTE_TO_PICKUP. Stan podróży odpowiada określonym geograficznie punktom na trasie przypisanym do pojazdu, a Fleet Engine modyfikuje te punkty na trasie po każdej aktualizacji trasy. 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 Najważniejsze informacje o Fleet Engine.
Życie w podróży
Aby śledzić każdą podróż w Fleet Engine, musisz najpierw utworzyć element Trip. Więcej informacji znajdziesz w opisach gRPC lub REST.
W tabeli poniżej znajdziesz przykładowy przepływ wycieczki utworzonej w Twoim systemie i etapy jej cyklu życia we 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. Zobacz Pakiet SDK dla kierowcy: podróże na żądanie.
| 1 | Otrzymaj prośbę o rezerwację. | Przed rozpoczęciem podróży Fleet Engine system rezerwacji najpierw otrzymuje od klienta prośbę o przewóz lub dostawę od klienta za pomocą Twojej 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 lokalizacja pasażera 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 danej podróży. 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 podróż i rozpocznie nawigację do miejsca odbioru, system zaktualizuje stan podróży 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ępnij konsumentowi ścieżkę dźwiękową. | Fleet Engine udostępnia szczegóły podróży i lokalizację pojazdu pakietowi Consumer SDK, który korzysta z odbiornika, 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 | Kompletna podróż. | Gdy pojazd dotrze do punktu docelowego przejazdu, a kierowca potwierdzi, że przejazd się zakończył, system ustawi w Fleet Engine wartość TripStatus na COMPLETE. 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.
