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 usługi 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 używają 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ółowe informacje znajdziesz w odpowiednich przewodnikach.

Tokeny uwierzytelniania i autoryzacji

Żądania do usługi Fleet Engine muszą też zawierać prawidłowe dane logowania. 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 usługi 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. Usługa 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, usługa 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 przejazdów na żądanie i zaplanowanych zadań. Usługa 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. Usługa 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ą tego identyfikatora 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 encji

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

Ponowne użycie pojazdu

Gdy pojazd zatrzyma się na wszystkich przystankach w ramach danego planu podróży, 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żyjesz pojazdu, usługa Fleet Engine resetuje jego dostępność, a 7-dniowe odliczanie rozpoczyna 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 również przedłużą jej żywotność, pod warunkiem że nowa wartość pola różni się od dotychczasowej.

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

Aby poprawić analizę systemu, najlepiej jest codziennie ponownie używać tej samej pary identyfikatorów kierowcy i pojazdu. W tym celu użyj tego samego identyfikatora pojazdu powiązanego z kierowcą w przypadku poprzednich zaplanowanych przystanków lub przejazdów na żądanie.

Co dalej?