Dokumentacja w tej sekcji pokazuje, jak tworzyć przejazdy i z nich korzystać za pomocą usługi Google Maps Mobility na żądanie. Zakłada znajomość tych zagadnień:
- Fleet Engine: musisz znać szczegóły implementacji, mechanizmy żądań i zabezpieczenia Fleet Engine. 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. Przejazd ma stan, który zgłaszasz do Fleet Engine w miarę postępu podróży, np. NEW, ENROUTE_TO_PICKUP i inne. Stan podróży odpowiada punktom orientacyjnym z geolokalizacją przypisanym do pojazdu, a Fleet Engine modyfikuje te punkty orientacyjne pojazdu przy każdej aktualizacji podróży. 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 podróży
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 | Otrzymywanie próśb o rezerwację | Zanim rozpocznie się przejazd Fleet Engine, system rezerwacji otrzymuje najpierw prośbę o przejazd lub dostawę od klienta za pomocą 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 przypisać pojazdy do przejazdów bezpośrednio w systemie i zgłosić przypisanie do Fleet Engine lub użyć usługi Search Vehicle, aby wyszukać pojazdy, filtrując je według atrybutów przejazdu i pojazdu, aby znaleźć najlepszy pojazd do wykonania przejazdu. Każdy pojazd online w promieniu wyszukiwania informuje o swojej bliskości za pomocą aktualizacji lokalizacji dostarczanych przez pakiet Driver SDK. Gdy |
| 3 | Zaktualizuj podróż. | Gdy kierowca zaakceptuje przejazd i rozpocznie nawigację do miejsca odbioru, system zaktualizuje stan przejazdu z NEW na ENROUTE_TO_PICKUP. Przez całą podróż nadal sprawdzasz lokalizację pojazdu, korzystając z bezpośredniego połączenia aplikacji z backendem lub odpytując Fleet Engine, który otrzymuje ciągły strumień informacji o zmianie lokalizacji pojazdu z pakietu Driver SDK. Następnie system zgłasza każdy etap podróży do Fleet Engine, który odpowiednio aktualizuje listę punktów trasy pojazdu.
|
| 4 | Udostępnij ścieżkę klienta. | Fleet Engine udostępnia szczegóły przejazdu i lokalizację pojazdu pakietowi SDK dla klientów, który używa detektora do odbierania 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, elementy przejazdu 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 procesu.
