Wprowadzenie: tworzenie pojazdów

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

Dokumentacja w tej sekcji zawiera informacje o tym, jak tworzyć pojazdy w Fleet Engine i nimi zarządzać. Pojazdy tworzysz w środowisku serwera Fleet Engine, aby odzwierciedlały rzeczywiste pojazdy używane w Twojej firmie. Pojazdy we Fleet Engine powinny też odpowiadać pojazdom używanym w systemie backendowym, który służy do przypisywania pojazdów i wyznaczania tras.

Aby utworzyć zasób pojazdu, użyj metody create (za pomocą gRPC lub REST). Nazwy pól w tym przewodniku używają notacji gRPC, aby uprościć przekaz.

Przejazdy na żądanie

Zaplanowane zadania

Żądania 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:

  1. The parent: ciąg znaków powiązany z identyfikatorem projektu Google Cloud, który służy do wypełniania pola nazwy instancji pojazdu.

  2. Identyfikator pojazdu: unikalny ciąg znaków używany do wypełniania pola name pojazdu.

  3. 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 usługi Fleet Engine należy też podać prawidłowe dane logowania. Przykłady w tym przewodniku opierają się na tych założeniach:

Więcej informacji znajdziesz w przewodnikach Konfigurowanie Fleet Engine.

Pola zasobu pojazdu

Zasób pojazdu ma 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 ze wskazówkami 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. Możesz je znaleźć 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 projektu w chmurze. 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ć unikalny dla wszystkich pojazdów we flocie i być prawidłowym ciągiem znaków Unicode. To jest identyfikator zasobu pojazdu. Zarówno przejazdy na żądanie, jak i zaplanowane przystanki wykorzystują to pole 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 encji

Format i wartość unikalnych identyfikatorów elementów używanych w wywołaniach zasobów są nieprzezroczyste 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 we Fleet Engine jest regularne aktualizowanie jego lokalizacji. Aktualizacje większości innych pól w obiekcie 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 elementu Vehicle.

Aby poprawić analizę systemu, najlepiej codziennie używać tej samej pary identyfikatorów kierowcy i pojazdu. Aby to zrobić, użyj tego samego identyfikatora pojazdu, który jest powiązany z kierowcą w przypadku poprzednich zaplanowanych przystanków lub przejazdów na żądanie.

Co dalej?