Z dokumentacji w tej sekcji dowiesz się, jak tworzyć podróże i z nimi pracować za pomocą usługi Google Maps Mobility na żądanie. Zakłada się, że znasz te zagadnienia:
- Fleet Engine: musisz znać szczegóły implementacji Fleet Engine , mechanizmy żądań i zabezpieczenia. W tym celu zapoznaj się z artykułami Co to jest usługa Fleet Engine? oraz tematy dotyczące bezpieczeństwa w sekcji Konfigurowanie Fleet Engine.
- Podstawy dotyczące pojazdów w przypadku usług na żądanie. Zapoznaj się z artykułem Wprowadzenie do pojazdów.
- Podstawy dotyczące podróży w przypadku usług na żądanie. Zapoznaj się z artykułem Podróże na żądanie.
TripService z którego będziesz korzystać, jest dostępny w gRPC i REST.
Dla uproszczenia odwołania do pól są zgodne z konwencją gRPC.
W Fleet Engine w przypadku usług na żądanie podróż to rodzaj podróży, która modeluje realizację zamówienia dostawy jedzenia lub prośby o przejazd od klientów. Podróż ma stan, który zgłaszasz do Fleet Engine w miarę jej postępu, np. NEW, ENROUTE_TO_PICKUP itp. Stan podróży odpowiada przypisanym do pojazdu punktom na trasie z geolokalizacją, a Fleet Engine modyfikuje te punkty na trasie pojazdu przy każdej aktualizacji podróży. Więcej informacji o podróżach i ich powiązaniu z pojazdami znajdziesz w artykule Podróże na żądanie w sekcji Podstawy Fleet
Engine.
Cykl życia podróży
Aby śledzić każdą podróż w Fleet Engine, musisz najpierw utworzyć encję Trip. Więcej informacji znajdziesz w dokumentacji gRPC lub REST.
W tabeli poniżej opisano przykładowy kompleksowy przepływ podróży utworzonej w Twoim systemie oraz jej etapy cyklu życia w Fleet Engine. Zakłada się, że masz skonfigurowany Fleet Engine i pojazd, który można przypisać do podróży, a aktualizacje lokalizacji są włączone w aplikacji kierowcy. Więcej informacji znajdziesz w artykule Pakiet SDK kierowcy: podróże na żądanie.
| 1 | Otrzymanie prośby o rezerwację | Zanim rozpocznie się podróż w Fleet Engine, Twój system rezerwacji otrzymuje
prośbę o przejazd lub dostawę od klienta za pomocą Twojej aplikacji lub innego
systemu rezerwacji. Twój system tworzy encję podróży za pomocą
CreateTrip z wymaganymi polami, takimi jak lokalizacja odbioru.
W tym momencie może też ustawić inne pola, np. pasażerów i lokalizację docelową, lub poczekać, aż przypisze pojazd. Więcej informacji znajdziesz w artykule
Tworzenie podróży do jednego miejsca docelowego. |
| 2 | Przypisanie pojazdu | Możesz przypisywać pojazdy do podróży bezpośrednio w swoim systemie i zgłaszać przypisanie do Fleet Engine lub użyć usługi Wyszukiwanie pojazdu aby wyszukać pojazdy, filtrując według atrybutów podróży i pojazdu aby znaleźć najlepszy pojazd do ukończenia podróży. Każdy pojazd online w promieniu wyszukiwania informuje o swojej bliskości za pomocą aktualizacji lokalizacji dostarczanych przez pakiet SDK kierowcy. Gdy |
| 3 | Aktualizacja podróży | Gdy kierowca zaakceptuje podróż i zacznie nawigować do lokalizacji odbioru, Twój system zmieni stan podróży z NEW do ENROUTE_TO_PICKUP. Podczas podróży nadal będziesz sondować lokalizację pojazdu za pomocą bezpośredniego połączenia z aplikacji z backendem lub przez sondowanie Fleet Engine, który otrzymuje ciągły strumień aktualizacji lokalizacji pojazdu z pakietu SDK kierowcy. Twój
system zgłasza następnie każdy etap podróży do Fleet Engine, który odpowiednio aktualizuje
listę punktów na trasie pojazdu.
|
| 4 | Udostępnianie podróży klientowi | Fleet Engine udostępnia szczegóły podróży i lokalizację pojazdu pakietowi SDK klienta, który używa detektora do otrzymywania aktualizacji podróży 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 na trasie pojazdu. Więcej informacji znajdziesz w artykule Udostępnianie podróży w przypadku podróży na żądanie. |
| 5 | Ukończenie podróży | Gdy pojazd dotrze do docelowego punktu na trasie podróży, a Twój
kierowca wskaże, że podróż się powiodła, Twój system ustawi w Fleet Engine
TripStatus na COMPLETE. Pamiętaj, że podobnie jak pojazdy, encje podróży pozostają aktywne w Fleet Engine przez 7 dni niezależnie od stanu, po czym są usuwane. |
Przepływ sekwencji podróży
Na diagramie poniżej przedstawiono bardziej szczegółowy widok tego przepływu.
