Co to jest podróż na żądanie?

Dokumentacja w tej sekcji pokazuje, jak tworzyć podróże i korzystać z nich za pomocą w usłudze podróży na żądanie w Mapach Google Mobility. Zakładamy, że zna ona następujące:

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

We Fleet Engine dla usług na żądanie podróż to rodzaj podróży, który modeluje realizacja zamówień jedzenia lub przejazdów przez konsumentów. Podróż ma stan, który w miarę rozwoju ścieżki zgłaszasz do Fleet Engine, taki jak NEW, ENROUTE_TO_PICKUP i inne. Stan podróży odpowiada lokalizacji geograficznej punkty pośrednie przypisane do pojazdu i Fleet Engine modyfikuje pojazd punkty pośrednie przy każdej aktualizacji trasy. Zobacz Podróże na żądanie we flocie Fleet Niezbędne informacje o silniku, w których znajdziesz więcej informacji o podróżach i ich związku z pojazdami.

Podróż z czasem

Aby śledzić każdą podróż we Fleet Engine, musisz najpierw utworzyć Trip podmiotu zabezpieczeń. Więcej informacji znajdziesz w opisach gRPC lub REST.

W tabeli poniżej znajdziesz przykład całej podróży utworzonej w systemu i etapów jego cyklu życia we Fleet Engine. Zakładamy, że masz skonfigurowany Fleet Engine i pojazd, który możesz przypisać do podróży wraz z aktualizacjami lokalizacji. włączony w aplikacji sterownika. Zobacz Driver SDK: podróże na żądanie.

1 Otrzymuj prośbę o rezerwację. Przed rozpoczęciem podróży Fleet Engine Twój system rezerwacji otrzymuje najpierw zamówienia na taksówkę lub dostawę od konsumenta w aplikacji lub w system rezerwacji. System utworzy następnie element podróży za pomocą funkcji CreateTrip z wymaganymi polami, takimi jak miejsce odbioru. Na tym etapie można też ustawić inne pola, takie jak „pasażerowie” miejsce nadania lub poczekać, aż przypisze on pojazd. Zobacz Utwórz podróż w jednym miejscu.
2 Przypisz pojazd.

Możesz bezpośrednio w swoim systemie przypisywać pojazdy do przejazdów. i zgłoś przypisanie we Fleet Engine. Możesz też skorzystać Szukaj pojazdu usługa wyszukiwania pojazdów, filtrowanie według podróży i pojazdu za pomocą atrybutów, które pomogą Ci znaleźć najlepszy pojazd. Dowolny pojazdu na określonym promieniu wyszukiwania sprawia, że jest on w pobliżu aktualizacje lokalizacji udostępniane przez pakiet Driver SDK.

Gdy SearchVehicle zwróci pojazd dopasowany do podróży, system wywołuje punkt końcowy UpdateTrip, aby zgłosić identyfikator pojazdu przypisany do podróży NEW.

3 Zaktualizuj podróż. Gdy kierowca zaakceptuje podróż i rozpocznie nawigację do miejsce odbioru, system zaktualizuje stan podróży z: NEW do: ENROUTE_TO_PICKUP. Nadal przeprowadzasz sondowanie pojazdu z różnych miejsc na trasie, czy to przez bezpośrednie połączenie do backendu lub przez odpytywanie Fleet Engine, który otrzymuje bieżące strumienie aktualizacji lokalizacji pojazdu z pakietu Driver SDK. Twoje system zgłasza każdy etap przejazdu do Fleet Engine, na liście punktów pośrednich pojazdu.
4 Udostępnij konsumentowi ścieżkę dźwiękową. Fleet Engine udostępnia szczegóły podróży i lokalizację pojazdu pakiet SDK dla konsumentów, który używa detektora do odbierania i wyświetlania aktualizacji podróży. w aplikacji dla konsumentów. Fleet Engine automatycznie aktualizuje szacowany czas dotarcia na miejsce – pozostało odległość, trasy i pozostałe punkty na trasie pojazdu. Zobacz Aby uzyskać więcej informacji, udostępniaj swoje podróże na żądanie.
5 Kompletna podróż. Gdy pojazd dotrze do docelowego punktu pośredniego podróży, kierowca wskazuje pomyślną podróż, system ustawia TripStatus do COMPLETE we Fleet Engine. Zachowaj w pamiętaj, że podobnie jak samochody, obiekty turystyczne pozostają aktywne we Fleet Engine na 7 dni niezależnie od ich stanu, po czym są usuwane.

Proces sekwencji podróży

Poniższy diagram przedstawia bardziej szczegółowy widok tego przepływu.

TripSequenceDiagram

Co dalej?