Wprowadzenie: tworzenie pojazdów

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

Z dokumentacji w tej sekcji dowiesz się, jak tworzyć pojazdy w usłudze Fleet Engine i nimi zarządzać. Pojazdy tworzysz w środowisku serwera Fleet Engine, aby odzwierciedlały rzeczywiste pojazdy w Twojej firmie. Pojazdy w usłudze Fleet Engine powinny też odpowiadać pojazdom używanym w systemie backendowym, którego używasz do przypisywania pojazdów i wyznaczania tras.

Aby utworzyć zasób pojazdu, użyj metody create za pomocą gRPC lub REST. Ze względu na prostotę nazwy pól w tym przewodniku są zapisywane w notacji gRPC.

Przejazdy na żądanie

Zaplanowane zadania

Żądania dotyczące pojazdów

W przypadku funkcji przejazdów na żądanie i zaplanowanych zadań pojazd tworzysz i aktualizujesz, wysyłając komunikat żądania z polami, które można podsumować w ten sposób:

  1. Element nadrzędny: ciąg znaków powiązany z identyfikatorem projektu Google Cloud, który służy do wypełniania pola name instancji pojazdu.

  2. Identyfikator pojazdu: unikalny ciąg znaków używany do wypełniania name pola 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 jego charakteru. Szczegóły znajdziesz w odpowiednich przewodnikach.

Tokeny uwierzytelniania i autoryzacji

Żądania do Fleet Engine muszą też zawierać prawidłowe dane uwierzytelniające. Przykłady w tym przewodniku opierają się na tych założeniach:

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

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 można ich ustawić 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ą, aby podczas tworzenia ustawić określone pola. Pojazdy utworzone w usłudze zaplanowanych zadań nie mają wymaganych pól zasobów pojazdów.
  • Pola opcjonalne. Obie usługi mają pola, które możesz ustawić podczas tworzenia lub później. Znajdziesz je w odpowiednim przewodniku referencyjnym dotyczącym używanej usługi.

Nazwa pojazdu (tylko dane wyjściowe)

Pole name jest dokładnie takie samo w przypadku usług przejazdów na żądanie i zaplanowanych zadań. 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 danym projekcie będzie miał tę samą ścieżkę nadrzędną.

    Projekt w chmurze, do którego się odwołujesz, musi też zawierać role konta usługi Fleet Engine dla używanej usługi. Listę tych kont usługi znajdziesz w artykule Konta usługi. Fleet Engine nie obsługuje dostępu z wielu projektów Google Cloud.

  • Identyfikator pojazdu, który musi być unikalny we wszystkich pojazdach w Twojej flocie i być prawidłowym ciągiem znaków Unicode. Jest to identyfikator zasobu pojazdu. Zarówno przejazdy na żądanie, jak i zaplanowane przystanki używają go 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 usłudze Fleet Engine.

Unikalne identyfikatory jednostek

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

Ponowne użycie pojazdu

Gdy pojazd zatrzyma się na wszystkich przystankach na danej trasie, pozostaje dostępny do ponownego użycia w usłudze 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żywasz pojazdu, Fleet Engine resetuje jego dostępność, a 7-dniowe odliczanie zaczyna się od nowa.

Zalecamy regularne aktualizowanie lokalizacji pojazdu, aby był on dostępny w usłudze Fleet Engine. Aktualizacje większości innych pól w encji Vehicle też przedłużą jej żywotność, o ile nowa wartość pola różni się od dotychczasowej.

UWAGA: niektóre pola w encji Vehicle, np. device_settings, to informacje służące wyłącznie do debugowania, które nie są utrwalane przez Fleet Engine. Ich aktualizacja nie przedłuża żywotności encji Vehicle.

Aby poprawić analizę systemu, najlepiej jest codziennie używać tej samej pary 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.

Co dalej?