Ogólne informacje o tym, jak działają pojazdy w Fleet Engine, znajdziesz w tych przewodnikach w sekcji Podstawy Fleet Engine:
Dokumentacja w tej sekcji opisuje, jak tworzyć pojazdy w Fleet Engine i nimi zarządzać. Tworzysz pojazdy w środowisku serwera Fleet Engine, aby odzwierciedlać rzeczywiste pojazdy w działaniu. Twoje pojazdy Fleet Engine powinny też odpowiadać tym, które są używane w systemie zaplecza, którego używasz do przypisywania pojazdów i wyznaczania tras.
Za pomocą metody create możesz utworzyć zasób pojazdu, korzystając z gRPC lub REST. W tym przewodniku nazwy pól są zapisane w notacji gRPC ze względu na prostotę.
Przejazdy na żądanie
CreateVehicleRequest(gRPC)providers.vehicle.create(REST)- Zasób
Vehicle(REST, gRPC)
Zaplanowane zadania
CreateDeliveryVehicleRequest(gRPC)providers.deliveryVehicles.create(REST)DeliveryVehicle(REST, gRPC)
Prośby o pojazd
W przypadku funkcji związanych z zadaniami na żądanie i zaplanowanymi zadaniami tworzenie i aktualizowanie pojazdu odbywa się poprzez wysłanie wiadomości z prośbą zawierającej pola opisane poniżej:
- Element nadrzędny: ciąg znaków powiązany z identyfikatorem projektu Google Cloud, służący do wypełniania pola nazwy wystąpienia pojazdu.
Identyfikator pojazdu: niepowtarzalny ciąg znaków używany do wypełniania pola
namepojazdu.Przykład pojazdu z wymaganymi polami. Te pola zależą od używanej przez Ciebie funkcji Fleet Engine.
Informacje w ciele żądania różnią się w zależności od charakteru żądania. Szczegółowe informacje znajdziesz w odpowiednich przewodnikach.
Tokeny uwierzytelniania i autoryzacji
W prośbach do Fleet Engine należy też podać prawidłowe dane logowania. W przykładach w tym przewodniku przyjęto następujące założenia:
- Przykłady gRPC zakładają użycie biblioteki Authorization dla Javy.
- Przykłady REST pokazują nagłówek żądania HTTP, który musi zawierać pole
Authorizationo wartościBearer <token>, gdzie<token>to wygenerowany przez Ciebie token sieciowy JSON.
Więcej informacji znajdziesz w przewodnikach dotyczących konfigurowania Fleet Engine.
Pola zasobu pojazdu
Zasób pojazdu zawiera te typy pól:
- Pola tylko do danych wyjściowych. Pola ustawiane przez usługę jako dane wyjściowe innej metody i nie mogą być ustawiane bezpośrednio. Ważnym polem tego typu jest pole
name. Fleet Engine ignoruje wszystkie wartości podane w polunamepojazdu zgodnie z zaleceniami Google AIP dotyczącymi identyfikatorów określonych przez użytkownika. Jeśli podasz wartości w tych polach, silnik floty zwróci błąd. - Pola wymagane. Pojazdy utworzone w usłudze przejazdów na żądanie wymagają, aby podczas tworzenia były wypełniane określone pola. Pojazdy utworzone w usłudze zaplanowanych zadań nie mają wymaganych pól zasobu pojazdu.
- Pola opcjonalne. Oba te usługi mają pola, które możesz ustawić podczas tworzenia lub później. Znajdziesz je w odpowiednim przewodniku referencyjnym usługi, z której korzystasz.
Nazwa pojazdu (tylko dane wyjściowe)
Pole name jest dokładnie takie samo w przypadku przejazdów na żądanie i zaplanowanych usług. Podczas tworzenia pojazdu Fleet Engine określa to pole na podstawie dwóch pól ustawionych podczas tworzenia pojazdu:
Nazwa rodzica: ciąg znaków powiązany z identyfikatorem projektu Google Cloud w formacie
providers/{provider}, gdzie{provider}to identyfikator Twojego projektu Cloud. Każdy pojazd utworzony w danym projekcie będzie miał tę samą ścieżkę nadrzędną.Projekt usługi w Google Cloud, na który tutaj się powołujesz, musi też zawierać role konta usługi Fleet Engine dla usługi, której używasz. Listę tych kont usługi znajdziesz w sekcji Konta usługi. Fleet Engine nie obsługuje dostępu z wielu projektów Google Cloud.
Identyfikator pojazdu, który musi być niepowtarzalny wśród wszystkich pojazdów w Twojej flocie i musi być prawidłowym ciągiem znaków Unicode. Jest to identyfikator zasobu pojazdu. Zarówno przejazdy na żądanie, jak i zaplanowane postoje korzystają z tego pola, aby powiązać przejazd lub zadanie z pojazdem, który je wykonuje.
W usługach opartych na Google Cloud wszystkie interfejsy API muszą reprezentować zasoby jako ciągi znaków. Więcej informacji znajdziesz w artykule Nazwy zasobów w Fleet Engine.
Unikalne identyfikatory jednostek
Format i wartość unikalnych identyfikatorów jednostek używanych w wywołaniach zasobów są niedostępne dla Fleet Engine. Upewnij się, że identyfikator nie zawiera żadnych informacji umożliwiających identyfikację osoby, np. numeru telefonu kierowcy.
Ponowne użycie pojazdu
Po tym, jak pojazd wykona wszystkie postoje w ramach danego planu podróży, pozostanie dostępny do ponownego użycia w Fleet Engine przez 7 dni. Oznacza to, że możesz go używać w kolejnych dniach roboczych bez konieczności tworzenia nowego. Za każdym razem, gdy ponownie używasz pojazdu, Fleet Engine resetuje jego dostępność, a w tym momencie rozpoczyna się nowe 7-dniowe odliczanie.
Zalecane podejście do utrzymywania dostępności pojazdu w Fleet Engine to aktualizowanie jego lokalizacji w regularnych odstępach czasu. Zmiany w większości innych pól w elemencie Vehicle również wydłużą jego okres ważności, pod warunkiem że nowa wartość pola będzie inna od dotychczasowej.
UWAGA: niektóre pola w podmiocie Vehicle, np. device_settings, to czyste informacje debugujące, które nie są utrwalane przez silnik floty. Ich aktualizacja nie wydłuża okresu ważności elementu Vehicle.
Aby ulepszyć analizę systemu, najlepiej jest codziennie używać tych samych par identyfikatorów kierowcy i pojazdu. Aby to zrobić, użyj tego samego identyfikatora pojazdu powiązanego z kierowcą w przypadku poprzednich zaplanowanych przystanków lub przejazdów na żądanie.