Wprowadzenie: tworzenie pojazdów

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

Dokumentacja w tej sekcji opisuje, jak tworzyć pojazdy i nimi zarządzać w Fleet Engine. 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óry służy do przypisywania pojazdów i wyznaczania tras.

Zasób pojazdu możesz utworzyć, używając metody create w interfejsie gRPC lub REST. W tym przewodniku nazwy pól są podane w notacji gRPC ze względu na prostotę.

Przejazdy na żądanie

Zaplanowane zadania

Zapytania o pojazd

W przypadku możliwości wykonywania zadań na żądanie i zgodnie z harmonogramem tworzenie i aktualizowanie pojazdu odbywa się poprzez wysłanie żądania zawierającego pola opisane poniżej:

  1. 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.

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

  3. Przykład pojazdu z wymaganymi polami. Te pola zależą od używanej przez Ciebie 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 żądaniach wysyłanych 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:

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

Pola zasobu pojazdu

Zasób pojazdu zawiera te typy pól:

  • Pola tylko z danymi wyjściowymi. 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 w polu name pojazdu 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 przewozu 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 dotyczącym usługi, której używasz.

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:

  • Rodzic: ciąg znaków powiązany z identyfikatorem projektu Google Cloud w formacie providers/{provider}, gdzie {provider} to identyfikator projektu Cloud. Każdy pojazd utworzony w danym projekcie 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 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 kilku 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 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 debugowania, które nie są utrwalane przez silnik floty. Ich zaktualizowanie nie wydłuża czasu istnienia elementu Vehicle.

Aby poprawić analizę systemu, najlepiej codziennie używać tego samego identyfikatora 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.

Co dalej?