Dokumentacja w tej sekcji pokazuje, jak tworzyć przejazdy i z nich korzystać za pomocą usługi Google Maps Mobility on-demand trips. Zakłada znajomość tych zagadnień:
- 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 tematach dotyczących bezpieczeństwa w sekcji 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 klientó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 przypisanym do pojazdu punktom trasy z określoną lokalizacją geograficzną. Fleet Engine modyfikuje te punkty trasy pojazdu przy każdej aktualizacji przejazdu. Więcej informacji o przejazdach i ich związku z pojazdami znajdziesz w sekcji Przejazdy na żądanie w podstawowych informacjach o Fleet Engine.
Cykl życia przejazdu
Aby śledzić każdy przejazd w Fleet Engine, musisz najpierw utworzyć obiekt Trip. 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 Driver SDK: przejazdy na żądanie.
| 1 | Otrzymanie prośby o rezerwację. | Zanim rozpocznie się przejazd w Fleet Engine, Twój system rezerwacji najpierw otrzyma prośbę o przejazd lub dostawę od klienta za pośrednictwem Twojej aplikacji lub innego systemu rezerwacji. System utworzy wtedy encję przejazdu za pomocą funkcji CreateTrip z wymaganymi polami, takimi jak miejsce odbioru.
Może też ustawić inne pola, np. liczbę 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ć przypisanie do Fleet Engine lub używać usługi Wyszukiwanie pojazdu, aby wyszukiwać pojazdy, 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 swojej bliskości za pomocą aktualizacji lokalizacji dostarczanych przez pakiet Driver SDK. Gdy usługa |
| 3 | Zaktualizuj przejazd. | Gdy kierowca zaakceptuje przejazd i zacznie kierować się 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 z Fleet Engine, który otrzymuje ciągły strumień aktualizacji lokalizacji pojazdu z pakietu SDK sterowników. 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ępnij ścieżkę klienta. | 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 sekcji 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 stan TripStatus na COMPLETE. Pamiętaj, że podobnie jak pojazdy, obiekty przejazdu pozostają aktywne w Fleet Engine przez 7 dni niezależnie od stanu, po czym są usuwane. |
Proces sekwencji przejazdu
Na diagramie poniżej przedstawiono bardziej szczegółowy widok tego procesu.
