Co to jest podróż na żądanie?

Dokumentacja w tej sekcji pokazuje, jak tworzyć przejazdy i pracować z nimi za pomocą usługi przejazdów na żądanie Google Maps Mobility. Zakładamy, że znasz te zagadnienia:

TripService, którego użyjesz, jest dostępny dla gRPC i REST. Dla uproszczenia odwołania do pól są zgodne z konwencją gRPC.

W usłudze Fleet Engine dla usług na żądanie przejazd to typ podróży, który modeluje realizację prośby o dostawę jedzenia lub przejazd od konsumentów. Przejazd ma stan, który zgłaszasz do Fleet Engine w miarę postępu podróży, np. NEW, ENROUTE_TO_PICKUP i inne. Stan przejazdu odpowiada punktom orientacyjnym z geolokalizacją przypisanym do pojazdu. Fleet Engine modyfikuje te punkty orientacyjne pojazdu przy każdej aktualizacji przejazdu. Więcej informacji o przejazdach i ich powiązaniu z pojazdami znajdziesz w sekcji Przejazdy na żądanie w artykule Podstawowe informacje o Fleet Engine.

Cykl życia przejazdu

Aby śledzić każdy przejazd w Fleet Engine, musisz najpierw utworzyć element Trip. Więcej informacji znajdziesz w dokumentacji gRPC lub REST.

Tabela poniżej opisuje przykładowy kompleksowy przepływ przejazdu utworzonego w Twoim systemie i jego etapy cyklu życia w Fleet Engine. Zakładamy, że masz skonfigurowany Fleet Engine i pojazd, który możesz przypisać do przejazdu, oraz że w aplikacji dla kierowców masz włączone informacje o zmianie lokalizacji. Więcej informacji znajdziesz w artykule Pakiet SDK dla kierowców: przejazdy na żądanie.

1 Otrzymanie prośby o rezerwację. Zanim rozpocznie się przejazd Fleet Engine, system rezerwacji otrzymuje najpierw prośbę o przejazd lub dostawę od klienta za pomocą aplikacji lub innego systemu rezerwacji. Następnie system tworzy encję przejazdu za pomocą metody CreateTrip z wymaganymi polami, takimi jak miejsce odbioru. Może też ustawić inne pola, takie jak pasażerowie i miejsce wysiadania, lub poczekać, aż przypisze pojazd. Zobacz Tworzenie przejazdu z jednym miejscem docelowym.
2 Przypisz pojazd.

Możesz przypisać pojazdy do przejazdów bezpośrednio w systemie i zgłosić przypisanie do Fleet Engine lub użyć usługi Search Vehicle, aby wyszukać pojazdy, filtrując je według atrybutów przejazdu i pojazdu, aby znaleźć najlepszy pojazd do wykonania przejazdu. Każdy pojazd online w promieniu wyszukiwania informuje o swojej bliskości za pomocą informacji o zmianie lokalizacji dostarczanych przez pakiet SDK dla kierowców.

Gdy SearchVehicle zwróci pojazd, który dopasujesz do przejazdu, Twój system wywoła punkt końcowy UpdateTrip, aby zgłosić identyfikator pojazdu przypisany do przejazdu NEW.
3 Zaktualizuj przejazd. Gdy kierowca zaakceptuje przejazd i rozpocznie nawigację do miejsca odbioru, system zaktualizuje stan przejazdu z NEW na ENROUTE_TO_PICKUP. Przez całą podróż nadal odpytujesz o lokalizację pojazdu, korzystając z bezpośredniego połączenia aplikacji z backendem lub odpytując Fleet Engine, który otrzymuje ciągły strumień aktualizacji lokalizacji pojazdu z pakietu Driver SDK. Następnie system zgłasza każdy etap podróży do Fleet Engine, który odpowiednio aktualizuje listę punktów trasy pojazdu.
4 Udostępnij ścieżkę klientowi. Fleet Engine udostępnia szczegóły przejazdu i lokalizację pojazdu pakietowi SDK dla klientów, który używa detektora do odbierania aktualizacji przejazdu i wyświetlania ich w aplikacji użytkownika. Fleet Engine automatycznie aktualizuje szacowany czas dotarcia na miejsce, pozostałą odległość, trasy i pozostałe punkty orientacyjne pojazdu. Więcej informacji znajdziesz w artykule Udostępnianie przejazdów na żądanie.
5 Zakończ przejazd. Gdy pojazd dotrze do punktu docelowego przejazdu, a kierowca potwierdzi, że przejazd się zakończył, system ustawi TripStatus na COMPLETE we Fleet Engine. Pamiętaj, że podobnie jak pojazdy, elementy przejazdu pozostają aktywne w Fleet Engine przez 7 dni niezależnie od stanu, po czym są usuwane.

Przepływ sekwencji przejazdów

Na diagramie poniżej przedstawiono bardziej szczegółowy widok tego procesu.

TripSequenceDiagram

Co dalej?