Ta strona została przetłumaczona przez Cloud Translation API.

Wprowadzenie: tworzenie pojazdów

Ogólne informacje o działaniu pojazdów we Fleet Engine znajdziesz w tych przewodników w sekcji podstawowej dotyczącej Fleet Engine:

Dokumentacja w tej sekcji zawiera informacje o tworzeniu pojazdów i zarządzaniu nimi w Fleet Engine. Pojazdy tworzysz w środowisku serwera Fleet Engine, aby: powielanie rzeczywistych pojazdów w świecie rzeczywistym. Twój Fleet Engine Pojazdy powinny odpowiadać także pojazdom używanym w Twoim systemie na potrzeby przypisywania pojazdów i wyznaczania tras.

Za pomocą metody tworzenia możesz utworzyć zasób pojazdu za pomocą gRPC lub REST. Dla uproszczenia nazwy pól w tym przewodniku używają notacji gRPC.

Podróże 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 dotyczące pojazdów

Zarówno w przypadku funkcji zadań na żądanie, jak i zaplanowanych można utworzyć i zaktualizować pojazdu, wysyłając wiadomość z prośbą o podsumowanie w następujący sposób:

Element nadrzędny: używany ciąg znaków powiązany z identyfikatorem projektu Google Cloud. do wypełnienia pola nazwy instancji pojazdu.
Identyfikator pojazdu: unikalny ciąg znaków używany do wypełniania pola name. na polu pojazdu.

Uwaga: ciągi tekstowe z identyfikatorem pojazdu mają pewne ograniczenia znaków. Unikaj automatycznie zwiększających liczbę identyfikatorów i zapewnić, że nie zawierają one danych umożliwiających identyfikację i informacjami o nich. Szczegółowe informacje o ograniczeniach znaków znajdziesz w polu identyfikatora pojazdu dla CreateVehicleRequest lub CreateDeliveryVehicleRequest.
Instancja pojazdu z wymaganymi polami. Zależą one od funkcje Fleet Engine, których używasz.

Informacje w treści żądania różnią się w zależności od jego charakteru. Zobacz informacje na ten temat.

Tokeny uwierzytelniania i autoryzacji

Żądania do Fleet Engine muszą też podawać prawidłowe dane logowania. W przykładach w tym przewodniku przyjęto takie założenia:

W przykładach gRPC założono użycie biblioteki autoryzacji dla języka Java.
Przykłady REST ilustrują nagłówek żądania HTTP, który musi zawierać pole Authorization o wartości Bearer <token>, gdzie <token> to Token internetowy JSON wydany przez Ciebie.

Więcej informacji znajdziesz w przewodnikach dotyczących konfigurowania Fleet Engine.

Pola zasobów dotyczących pojazdu

Zasób pojazdu ma te rodzaje pól:

Tylko pola wyjściowe. Pola ustawione przez usługę jako dane wyjściowe innej metody i nie można jej ustawić bezpośrednio. Ważne pole tego typ to pole name. Fleet Engine ignoruje każdą podaną wartość dla argumentu name pole pojazdu zgodnie ze wskazówkami Google AIP dla określonych przez użytkownika Identyfikatory. Jeśli podasz wartości tych pól, Fleet Engine zwraca błąd.
Pola wymagane. Pojazdy utworzone w ramach usługi wycieczek na żądanie wymagają że określone pola są ustawiane podczas tworzenia. Pojazdy utworzone w harmonogramie usługa zadań nie ma wymaganych pól zasobów pojazdu.
Pola opcjonalne. Obie usługi mają pola, które możesz skonfigurować podczas tworzenia lub później. Wskazówki te można znaleźć w odpowiednim przewodniku z której korzystasz.

Nazwa pojazdu (tylko dane wyjściowe)

Pole name jest dokładnie takie samo w przypadku podróży na żądanie i zaplanowanego zadania usług Google. Fleet Engine definiuje pole podczas tworzenia pojazdu na podstawie 2 pola ustawione podczas tworzenia pojazdu:

Element nadrzędny: ciąg znaków powiązany z identyfikatorem projektu Google Cloud formularz providers/{provider}, gdzie {provider} to identyfikator Twojej chmury w projektach AI. Każdy pojazd, który utworzysz w ramach danego projektu, będzie miał taki sam ścieżki nadrzędnej.

Projekt Cloud, do którego się tu odwołujesz, musi też zawierać Fleet Engine role konta usługi używane w usłudze, Zobacz Konta usługi dla listę takich kont usługi. Fleet Engine nie obsługuje dostępu z wielu projektów Google Cloud.
Identyfikator pojazdu, który musi być niepowtarzalny dla wszystkich pojazdów w flotę i być prawidłowym ciągiem Unicode. To jest identyfikator zasobu zasobu pojazdu. Zarówno w przypadku podróży na żądanie, jak i zaplanowanych przystanków jest on używany do powiązania lub wykonaną czynność w samochodzie.

W usługach opartych na Google Cloud wszystkie interfejsy API muszą przedstawiać zasoby w postaci ciągów znaków. Więcej informacji znajdziesz w artykule Nazewnictwo zasobów we Fleet Engine.

Unikalne identyfikatory jednostek

Format i wartość unikalnych identyfikatorów jednostek używanych w wywołaniach zasobów to nieprzezroczyste dla Fleet Engine. Upewnij się, że identyfikator nie zawiera żadnych informacji umożliwiających identyfikację, takich jak numer telefonu kierowcy.

Ponowne wykorzystanie pojazdu

Po zaliczeniu wszystkich przystanków w ramach danego planu podróży pojazd pozostaje dostępny do ponownego wykorzystania we Fleet Engine na 7 dni, co oznacza, że możesz ponownie wykorzystać pojazd kolejnych dni roboczych bez konieczności tworzenia nowego. Za każdym razem, gdy ponownie wykorzystać pojazd, Fleet Engine resetuje jego dostępność, co spowoduje, że 7-dniowe odliczanie rozpocznie się na nowo.

Aby zachować pojazd dostępny we Fleet Engine, zalecamy regularnie aktualizować jego lokalizację. Aktualizacje większości pozostałych pól w Element Vehicle również wygaśnie, pod warunkiem że nowa wartość pola będzie inny niż istniejący.

UWAGA: niektóre pola w elemencie Vehicle, np. device_settings, mają charakter czysto debugowany. informacje, które nie są utrwalone przez Fleet Engine. Nie spowoduje to ich aktualizacji przedłużyć żywotność elementu Vehicle.

Aby uzyskać lepszą analitykę systemu, lepiej ponownie wykorzystać ten sam identyfikator pojazdu kierowcy. z dnia na dzień. Zrób to, używając tego samego identyfikatora pojazdu, który jest powiązany z z kierowcą w przypadku poprzednich zaplanowanych przystanków lub podróży na żądanie.