Z dokumentacji w tej sekcji dowiesz się, jak tworzyć podróże i pracować z nimi 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 konsumentó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 przejazdu
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 etapy jej cyklu życia w Fleet Engine. Zakłada się, że masz skonfigurowany Fleet Engine i pojazd, który można przypisać do podróży, oraz że w aplikacji kierowcy włączono aktualizacje lokalizacji. Więcej informacji znajdziesz w artykule Pakiet Driver SDK: 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 konsumenta za pomocą Twojej aplikacji lub innego
systemu rezerwacji. Twój system tworzy encję przejazdu za pomocą
CreateTrip z wymaganymi polami, takimi jak miejsce odbioru.
W tym momencie może też ustawić inne pola, np. pasażerów i
miejsce docelowe, lub poczekać, aż przypisze pojazd. Zapoznaj się z artykułem
Tworzenie przejazdu 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 odbycia podróży. Każdy pojazd online w promieniu wyszukiwania informuje o swojej bliskości za pomocą aktualizacji lokalizacji dostarczanych przez pakiet Driver SDK. Gdy |
| 3 | Aktualizacja przejazdu | Gdy kierowca zaakceptuje przejazd i zacznie nawigować do miejsca odbioru, Twój system zmieni stan przejazdu z NEW na ENROUTE_TO_PICKUP. Podczas podróży nadal będziesz odpytywać o lokalizację pojazdu
bezpośrednio z aplikacji do backendu lub przez odpytywanie Fleet Engine, który otrzymuje ciągły strumień aktualizacji lokalizacji pojazdu z pakietu Driver SDK. Twój
system zgłasza następnie do Fleet Engine każdy etap podróży, który odpowiednio aktualizuje
listę punktów na trasie pojazdu.
|
| 4 | Udostępnianie podróży konsumentowi | Fleet Engine udostępnia szczegóły przejazdu i lokalizację pojazdu pakietowi Consumer SDK, który używa detektora do otrzymywania aktualizacji przejazdu i wyświetlania ich w aplikacji użytkownika. Fleet Engine automatycznie aktualizuje szacowany czas dotarcia na miejsce, pozostały dystans, 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 | Zakończenie przejazdu | Gdy pojazd dotrze do miejsca docelowego podróży, a Twój
kierowca potwierdzi, że podróż się udała, Twój system ustawi
TripStatus na COMPLETE w Fleet Engine. 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
Ten diagram przedstawia bardziej szczegółowy widok tego przepływu.
