Czym jest usługa Fleet Engine?

Fleet Engine to usługa backendu, która integruje się z systemem używanym do zarządzania usługami transportowymi dla klientów. Współpracuje z różnymi interfejsami API i pakietami SDK, aby ulepszać mapowanie, wyznaczanie tras i zarządzanie lokalizacją.

Fleet Engine udostępnia aktualizacje tras i stanu pojazdów, które są modelowane na podstawie Twojej rzeczywistej floty. Gdy system wysyła do Fleet Engine aktualizacje postępów pojazdu, Fleet Engine używa informacji o lokalizacji pojazdu i trasie w czasie rzeczywistym dostarczanych przez pakiet SDK sterowników, aby generować dokładne raporty o podróżach pojazdu: szacowany czas dotarcia na miejsce, informacje o ruchu drogowym i dostępność pojazdu.

Fleet Engine

Usługa Fleet Engine działa z tymi usługami mobilności:

  • Przejazdy na żądanie: w ramach tej oferty Fleet Engine modeluje cykl życia podróży – od miejsca rozpoczęcia, przez przystanki, po miejsce docelowe. W cyklu życia przejazdu pojazd przejeżdża przez miejsca odbioru, pośrednie punkty orientacyjne i miejsca wysiadania, aby zrealizować przejazd zarezerwowany przez klienta. Szczegółowe informacje o przejazdach na żądanie znajdziesz w dokumentacji dotyczącej przejazdów na żądanie.
  • Zaplanowane zadania: w tej ofercie Fleet Engine modeluje cykl życia zadania dostawy lub usługi, w którym każdy przystanek na trasie wymaga od kierowcy wykonania co najmniej jednego zaplanowanego zadania. Zadania mogą obejmować dostarczenie przesyłki lub wykonanie usługi. Szczegółowe informacje o zaplanowanych zadaniach znajdziesz w dokumentacji Zaplanowane zadania.

Co możesz robić za pomocą Fleet Engine

Za pomocą komponentów Fleet Engine możesz:

  • Włącz śledzenie podróży konsumentów: w przypadku podróży na żądanie możesz korzystać z funkcji Fleet Engine związanych z wrażeniami konsumentów i zintegrować pakiet SDK konsumenta z aplikacjami mobilnymi lub aplikacjami internetowymi. Dzięki temu Twoi klienci mogą korzystać z tej samej aplikacji, aby przesyłać prośby o przejazd i śledzić jego przebieg.
  • Dostarczanie klientom informacji o przesyłkach w czasie rzeczywistym: w przypadku zaplanowanych zadań możesz korzystać z funkcji Fleet Engine związanych z obsługą klienta i zintegrować pakiet SDK Fleet Engine dla klientów w języku JavaScript ze swoją aplikacją internetową. Dzięki temu możesz dostarczać klientom aktualne informacje o stanie ich przesyłek w czasie zbliżonym do rzeczywistego. SDK udostępnia wbudowane filtry i funkcje ochrony prywatności danych, dzięki czemu konsumenci widzą tylko informacje dotyczące ich zamówienia.
  • Projektowanie rozwiązań dla operatorów flot: w przypadku zaplanowanych zadań używaj biblioteki śledzenia floty w JavaScript, aby operatorzy flot mogli lepiej koordynować i zarządzać przydzielaniem pojazdów w ciągu dnia.
  • Zwiększ komfort pracy kierowców: pakiet Driver SDK to zestaw narzędzi do aplikacji mobilnych i podstawowy komponent Fleet Engine. Używa funkcji z pojazdów. Dzięki temu pakietowi SDK aplikacja do jazdy może zarządzać przydzielonymi zadaniami, a także udostępniać funkcje nawigacji i wyznaczania tras dla kierowców. Podstawą działania pakietu SDK jest detektor zdarzeń, który wysyła aktualizacje lokalizacji do Fleet Engine, gdy kierowca zaczyna prowadzić pojazd. Wysyła też do Fleet Engine sygnały dotyczące stanu pojazdu. Dzięki temu pakietowi SDK kierowca może używać jednej aplikacji do zarządzania przydzielonymi zadaniami i nawigowania tak jak w przypadku konsumenckiej wersji Map Google, ale bez konieczności przełączania się na inną aplikację.

Dzięki tym rozwiązaniom możesz udostępniać te informacje:

Przejazdy na żądanie

  • Aktualna pozycja pojazdu kierowcy na drodze.
  • rzeczywistą trasę kierowcy z informacjami o natężeniu ruchu w czasie rzeczywistym;
  • szacowany czas dotarcia do miejsca odbioru i wysiadki;
  • śledzenie podróży w jednym kierunku, podróży obejmujących wiele miejsc docelowych i podróży w obie strony;
  • przejazdy wspólne dla wielu klientów na tej samej trasie;
  • Wyświetlanie wszystkich pojazdów w określonym regionie, aby znaleźć najlepsze dopasowania do żądanych przejazdów.

Zaplanowane zadania

  • Aktualizacje bieżącej lokalizacji wyświetlane na mapie.
  • automatycznie dostosowywane szacowane czasy dotarcia na miejsce, które odzwierciedlają zmieniające się warunki, takie jak natężenie ruchu;
  • ukończone zadania i oczekujące przystanki, aby uzyskać wgląd w potencjalne problemy.
  • Liczba przystanków i dystans, aby zwiększyć zaufanie klientów.

Jak działa Fleet Engine

Ta sekcja zawiera ogólny opis działania systemów Fleet Engine w przypadku każdej usługi mobilności.

Przejazdy na żądanie

Poniższy diagram przedstawia 2 kluczowe części przejazdów na żądanie: początek dnia, w którym kierowcy włączają udostępnianie lokalizacji w Fleet Engine, oraz uproszczony widok zarządzania przejazdami za pomocą komponentów Fleet Engine. Szczegółowe informacje o procesie przejazdu znajdziesz w artykule Co to jest przejazd? w dokumentacji przejazdów na żądanie.

Zaplanowane zadania

Poniższy diagram przedstawia macierz typowego dnia pracy kierowcy, a także sposób obsługi jego pracy w systemie Fleet Engine za pomocą biblioteki śledzenia floty.

Uwaga: system może korzystać zarówno ze śledzenia przesyłek, jak i śledzenia floty. Dzięki śledzeniu przesyłek Fleet Engine filtruje informacje o przesyłce i kierowcy, aby klient widział tylko te informacje, które dotyczą jego przesyłki.

Architektura Fleet Engine

W tej sekcji znajdziesz architekturę systemu dla różnych ofert Fleet Engine. Obie usługi korzystają z tych elementów:

  • Pojazd: przejazdy na żądanie i zaplanowane zadania wymagają pojazdu jako sposobu modelowania rzeczywistych pojazdów w Twojej firmie, które są używane do prowadzenia działalności. W Fleet Engine jednostka pojazdu otrzymuje informacje o lokalizacji przekazywane przez powiązany z nią rzeczywisty pojazd za pomocą aplikacji kierowcy zintegrowanej z pakietem SDK sterowników. Pojazdy Fleet Engine są w dużej mierze encjami równoległymi w obu usługach, z kilkoma różnicami. Aby dowiedzieć się więcej o pojazdach we Fleet Engine, przeczytaj artykuł Wprowadzenie do pojazdów.
  • Pakiet Driver SDK: zarówno w przypadku zadań na żądanie, jak i zaplanowanych, pakiet Driver SDK jest podstawowym komponentem. Pakiet Driver SDK integruje się z aplikacją kierowcy i przesyła do Fleet Engine strumień informacji o zmianie lokalizacji wraz z informacjami o trasie, na których opiera się Fleet Engine, aby raportować stan podróży w czasie rzeczywistym, a także inne informacje, takie jak szacowany czas dotarcia na miejsce i dane o natężeniu ruchu.
  • Pakiet SDK dla klientów: kluczową zaletą zarówno w przypadku zadań na żądanie, jak i zaplanowanych jest pakiet SDK dla klientów, który służy do informowania klienta o stanie przejazdu, dostawy jedzenia lub zaplanowanej dostawy paczki.

Przejazdy na żądanie

Wyjaśnienie dotyczące pojazdów, przejazdów i pakietów SDK znajdziesz w powiązanej dokumentacji dotyczącej przejazdów na żądanie:

  1. Wprowadzenie do pojazdów
  2. Przejazdy na żądanie
  3. Pakiet Driver SDK do obsługi przejazdów na żądanie
  4. Pakiet konsumencki SDK do przejazdów na żądanie

Zaplanowane zadania

Wyjaśnienie dotyczące pojazdów dostawczych, zadań i pakietów SDK znajdziesz w dokumentacji powiązanej z zaplanowanymi zadaniami:

  1. Wprowadzenie do pojazdów
  2. Zaplanowane zadania
  3. Pakiet Driver SDK do zaplanowanych zadań
  4. Pakiet SDK dla konsumentów do zaplanowanych zadań

Zasoby

Przejazdy na żądanie

Pojazd
Usługi REST: v1.providers.vehicles
gRPC: maps.fleetengine.v1.VehicleService
Nazwa zasobu providers/{provider}/vehicles/{vehicle}
Przejazd
Usługi REST: v1.providers.trips
gRPC: maps.fleetengine.v1.TripService
Nazwa zasobu providers/{provider}/trips/{trip}

Zaplanowane zadania

Pojazd dostawczy
Zasoby REST: providers.deliveryVehicles
gRPC: maps.delivery.v1
Nazwa zasobu providers/{provider}/deliveryVehicles/{vehicle}
Zadanie
Usługi REST: providers.tasks
gRPC: maps.fleetengine.delivery.v1.Task
Nazwa zasobu providers/{provider}/tasks/{task}

Nazewnictwo zasobów w Fleet Engine

W Fleet Engine, podobnie jak we wszystkich usługach opartych na Google Cloud, zasoby mają unikalne identyfikatory zwane names, które są podawane w formacie ciągu znaków. Częścią nazwy zasobu jest identyfikator zasobu, który podajesz podczas wysyłania prośby o utworzenie. Jednak zasoby Fleet Engine nie mają pola identyfikatora, ale pole nazwy tylko do odczytu, które zawiera identyfikator zasobu.

Fleet Engine używa względnych nazw zasobów. Składają się one z identyfikatorów kolekcji i zasobów, które są uporządkowane w sposób wskazujący ich hierarchię.

  • Identyfikator kolekcji: kolekcja zawiera zasoby lub inne kolekcje.

Przejazdy na żądanie

3 kolekcje: providers, vehicles i trips.

Zaplanowane zadania

3 kolekcje: providers, deliveryVehicles i tasks.

Identyfikator zasobu: identyfikatory zasobów w dokumentacji referencyjnej są oznaczone nawiasami klamrowymi w polu nazwy. Są to zmienne identyfikatorów, które podajesz podczas wysyłania żądania utworzenia.

Przejazdy na żądanie

  • {provider}: identyfikator Twojego projektu Cloud. Tworzone raz na projekt.
  • {vehicle}: zasób pojazdu, używany do tworzenia każdego pojazdu, zwykle ponownie używany w przypadku tej samej pary kierowca – pojazd.
  • {trip}: zasób podróży, używany w przypadku każdej podróży i zwykle nieużywany ponownie.

Zaplanowane zadania

  • {provider}: identyfikator Twojego projektu Cloud; Tworzony raz na projekt.
  • {vehicle}: zasób pojazdu dostawczego używany do tworzenia każdego pojazdu, zwykle ponownie używany w przypadku tej samej pary kierowca–pojazd.
  • {task}: zasób zadania, używany w każdym zadaniu i zwykle nie jest używany ponownie.

Więcej informacji znajdziesz w sekcji Nazwy zasobów w dokumentacji interfejsów API Google Cloud.

Logi Google Cloud dotyczące Fleet Engine

Fleet Engine oferuje podstawową usługę logowania, która umożliwia zapisywanie żądań do interfejsu API i ładunków odpowiedzi. Dzięki tym logom możesz debugować integrację, tworzyć dane monitorowania i analizować wzorce ruchu.

Więcej informacji znajdziesz w artykule Cloud Logging.

Jak korzystać z Fleet Engine

1 Skonfiguruj projekt w chmurze.

W tym kroku utworzysz różne role konta usługi, a także włączysz powiązane interfejsy API.

Interfejsy API i zestawy SDK Fleet Engine wymagają używania tokenów internetowych JSON (JWT) podpisanych za pomocą kont usługi utworzonych w konsoli Google Cloud. Postępuj zgodnie z instrukcjami w artykule Tworzenie projektu Fleet Engine. Aby dowiedzieć się więcej o tych rolach, przeczytaj artykuł Role kont usługi.

2 Sprawdzanie konfiguracji Po utworzeniu kont usług sprawdź, czy konfiguracja została zakończona i czy możesz utworzyć pojazd. Ten krok pozwala rozwiązać typowe problemy z autoryzacją, które mogą wystąpić podczas konfigurowania projektu. Postępuj zgodnie ze wskazówkami w sekcji Weryfikacja konfiguracji.
3 Tworzenie pierwszej ścieżki Polega to na utworzeniu pojedynczego pojazdu ze współrzędnymi, które reprezentują przystanki na trasie przejazdu na żądanie lub zaplanowane zadania. Więcej informacji znajdziesz w omówieniu treści dotyczących przejazdów na żądanie lub zaplanowanych zadań.
4 Testowanie integracji Usługi i komponenty Fleet Engine wymagają danych w czasie rzeczywistym z floty pojazdów. Projektowanie, tworzenie i wdrażanie aplikacji dla floty kierowców może zająć trochę czasu. Dlatego przed wdrożeniem na pełną skalę najlepiej najpierw użyć danych testowych, aby sprawdzić integrację. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Fleet Engine.

Co dalej?

  1. Dowiedz się więcej o pojazdach Fleet Engine.
  2. Dowiedz się więcej o przejazdach na żądanie i zaplanowanych zadaniach.
  3. Skonfiguruj Fleet Engine.