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

Wprowadzenie: tworzenie pojazdów

Ogólne informacje o tym, jak pojazdy działają w Fleet Engine, znajdziesz w tych przewodnikach w sekcji Podstawowe informacje o Fleet Engine:

Dokumentacja w tej sekcji opisuje, jak tworzyć pojazdy w Fleet Engine i nimi zarządzać. Pojazdy tworzysz w środowisku serwera Fleet Engine, aby odzwierciedlały rzeczywiste pojazdy w Twojej flocie. Pojazdy w Fleet Engine powinny też odpowiadać tym używanym w systemie backendu, którego używasz do przypisywania pojazdów i wyznaczania tras.

Do utworzenia zasobu pojazdu możesz użyć metody create, korzystając z gRPC lub REST. Nazwy pól w tym przewodniku używają notacji gRPC, aby uprościć opis.

Przejazdy na żądanie

CreateVehicleRequest (gRPC)
providers.vehicle.create (REST)
Vehicle zasób (REST, gRPC)

Zaplanowane zadania

CreateDeliveryVehicleRequest (gRPC)
providers.deliveryVehicles.create (REST)
DeliveryVehicle (REST, gRPC)

Prośby dotyczące pojazdów

W przypadku funkcji zadań na żądanie i zaplanowanych tworzysz i aktualizujesz pojazd, wysyłając wiadomość z żądaniem zawierającą pola, które można podsumować w ten sposób:

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

Uwaga: ciągi tekstowe identyfikatora pojazdu podlegają pewnym ograniczeniom dotyczącym znaków. Unikaj automatycznego zwiększania identyfikatorów i dbaj o to, aby nie zawierały one informacji umożliwiających identyfikację osób. Szczegółowe informacje o ograniczeniach dotyczących znaków znajdziesz w polu identyfikatora pojazdu w przypadku CreateVehicleRequest lub CreateDeliveryVehicleRequest.
Instancja pojazdu z wymaganymi polami. Te pola zależą od używanej funkcji Fleet Engine.

Informacje w treści żądania różnią się w zależności od charakteru żądania. Szczegółowe informacje znajdziesz w odpowiednich przewodnikach.

Tokeny uwierzytelniania i autoryzacji

W przypadku żądań wysyłanych do Fleet Engine należy też podać prawidłowe dane logowania. Przykłady w tym przewodniku opierają się na tych założeniach:

Przykłady gRPC zakładają użycie biblioteki autoryzacji dla Javy.
Przykłady REST ilustrują nagłówek żądania HTTP, który musi zawierać pole Authorization o wartości Bearer <token>, gdzie <token> to wydany przez Ciebie token sieciowy JSON.

Więcej informacji znajdziesz w przewodnikach Konfigurowanie Fleet Engine.

Pola zasobu pojazdu

Zasób pojazdu zawiera te rodzaje pól:

Pola tylko do odczytu Pola, które są 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 każdą podaną wartość pola name pojazdu zgodnie z wytycznymi Google AIP dotyczącymi identyfikatorów określonych przez użytkownika. Jeśli podasz wartości w tych polach, Fleet Engine zwróci błąd.
Pola wymagane Pojazdy utworzone w usłudze przejazdów na żądanie wymagają ustawienia określonych pól podczas tworzenia. Pojazdy utworzone w usłudze zaplanowanych zadań nie mają wymaganych pól zasobu pojazdu.
Pola opcjonalne Obie usługi mają pola, które możesz ustawić podczas tworzenia lub później. Znajdziesz je w odpowiednim przewodniku po usłudze, z której korzystasz.

Nazwa pojazdu (tylko dane wyjściowe)

Pole name jest dokładnie takie samo w przypadku przejazdów na żądanie i usług związanych z zaplanowanymi zadaniami. Fleet Engine definiuje to pole podczas tworzenia pojazdu na podstawie 2 pól ustawionych podczas tworzenia pojazdu:

Element nadrzędny: 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 ramach danego projektu będzie miał tę samą ścieżkę nadrzędną.

Projekt Cloud, do którego się tu odwołujesz, musi też zawierać role konta usługi Fleet Engine dla używanej usługi. 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 przystanki używają tego pola do powiązania przejazdu lub zadania z pojazdem, który je realizuje.

W usługach opartych na Google Cloud wszystkie interfejsy API muszą reprezentować zasoby jako ciągi znaków. Więcej informacji znajdziesz w artykule Nazywanie zasobów w Fleet Engine.

Unikalne identyfikatory podmiotów

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

Ponowne wykorzystanie pojazdów

Po tym, jak pojazd zakończy wszystkie przystanki na danej trasie, pozostaje dostępny do ponownego użycia w Fleet Engine przez 7 dni. Oznacza to, że możesz ponownie użyć pojazdu w kolejnych dniach roboczych bez konieczności tworzenia nowego. Za każdym razem, gdy ponownie użyjesz pojazdu, Fleet Engine zresetuje jego dostępność, a wtedy rozpocznie się odliczanie 7-dniowego okresu.

Zalecanym sposobem na utrzymanie dostępności pojazdu w Fleet Engine jest regularne aktualizowanie jego lokalizacji. Aktualizacje większości innych pól w Vehicle również przedłużą jego okres ważności, pod warunkiem że nowa wartość pola różni się od dotychczasowej.

UWAGA: niektóre pola w Vehicle, np. device_settings, zawierają wyłącznie informacje debugowania, które nie są zapisywane przez Fleet Engine. Aktualizacja nie przedłuża okresu ważności jednostki Vehicle.

Aby uzyskać lepsze dane analityczne systemu, najlepiej codziennie używać tej samej pary identyfikatorów kierowcy i pojazdu. W tym celu użyj tego samego identyfikatora pojazdu, który jest powiązany z kierowcą w przypadku poprzednich zaplanowanych przystanków lub przejazdów na żądanie.