Dokumentacja w tej sekcji pokazuje, jak tworzyć przejazdy i z nich korzystać za pomocą usługi Google Maps Mobility on-demand trips. Zakładamy, że znasz te pojęcia:
- Fleet Engine: musisz znać szczegóły implementacji Fleet Engine, mechanizmy żądań i bezpieczeństwo. Więcej informacji znajdziesz w artykule Czym jest usługa Fleet Engine? oraz w sekcjach dotyczących bezpieczeństwa w artykule Konfigurowanie Fleet Engine.
- Podstawowe informacje o pojazdach w przypadku usług na żądanie. Zobacz Wprowadzenie do pojazdów.
- Podstawowe informacje o przejazdach w przypadku usług na żądanie. Zobacz przejazdy na żądanie.
Używana przez Ciebie TripService jest dostępna w przypadku 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 rodzaj podróży, który modeluje realizację zamówienia dostawy jedzenia lub przejazdu od konsumentów. Podróż ma stan, który zgłaszasz do Fleet Engine w miarę jej postępu, np. NEW, ENROUTE_TO_PICKUP i inne. Stan przejazdu odpowiada punktom orientacyjnym przypisanym do pojazdu na podstawie geolokalizacji. Fleet Engine modyfikuje te punkty orientacyjne pojazdu przy każdej aktualizacji przejazdu. Więcej informacji o przejazdach i ich związku 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ć Trip
obiekt. Więcej informacji znajdziesz w dokumentacji gRPC lub REST.
W tabeli poniżej opisano przykładowy kompleksowy przepływ przejazdu utworzonego w Twoim systemie oraz etapy jego cyklu życia w Fleet Engine. Zakładamy, że masz już skonfigurowany Fleet Engine i pojazd, który możesz przypisać do przejazdu, a w aplikacji kierowcy masz włączone aktualizacje lokalizacji. Więcej informacji znajdziesz w artykule Pakiet SDK kierowcy: przejazdy na żądanie.
| 1 | Otrzymanie prośby o rezerwację. | Zanim rozpocznie się przejazd w Fleet Engine, Twój system rezerwacji najpierw otrzymuje od konsumenta prośbę o przejazd lub dostawę za pomocą Twojej aplikacji lub innego systemu rezerwacji. System tworzy wtedy encję przejazdu za pomocą
CreateTrip z wymaganymi polami, takimi jak miejsce odbioru.
Może też ustawić inne pola, np. pasażerów i miejsce docelowe, lub poczekać, aż przypisze pojazd. Zobacz Tworzenie przejazdu do jednego miejsca docelowego. |
| 2 | Przypisz pojazd. | Możesz przypisywać pojazdy do przejazdów bezpośrednio w swoim systemie i zgłaszać to przypisanie do Fleet Engine lub używać usługi Wyszukiwanie pojazdu do wyszukiwania pojazdów, filtrując je według atrybutów przejazdu i pojazdu, aby znaleźć najlepszy pojazd do odbycia przejazdu. Każdy pojazd online w promieniu wyszukiwania informuje o swoim położeniu za pomocą aktualizacji lokalizacji dostarczanych przez pakiet Driver SDK. Gdy |
| 3 | Aktualizacja przejazdu | Gdy kierowca zaakceptuje przejazd i rozpocznie nawigację do miejsca odbioru, system zmieni stan przejazdu z NEW na ENROUTE_TO_PICKUP. Podczas całej podróży nadal sprawdzasz lokalizację pojazdu, korzystając z bezpośredniego połączenia aplikacji z backendem lub sprawdzając Fleet Engine, który otrzymuje ciągł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 na trasie pojazdu.
|
| 4 | Udostępnianie ścieżki 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łą odległość, trasy i pozostałe punkty na trasie pojazdu. Więcej informacji znajdziesz w artykule Udostępnianie przejazdów w przypadku przejazdów na żądanie. |
| 5 | Zakończ przejazd | Gdy pojazd dotrze do punktu docelowego przejazdu, a kierowca potwierdzi, że przejazd się powiódł, system ustawi w Fleet Engine wartość TripStatus na COMPLETE. Pamiętaj, że podobnie jak pojazdy, obiekty podróży pozostają aktywne w Fleet Engine przez 7 dni niezależnie od stanu, po czym są usuwane. |
Proces sekwencji podróży
Ten diagram przedstawia bardziej szczegółowy widok tego przepływu.
