VehicleJourneySegment

Przedstawia segment podróży pojazdu – od poprzedniego przystanku do bieżącego przystanku. Jeśli jest to pierwszy aktywny przystanek, oznacza to, że do tego przystanku dojedziesz od aktualnej lokalizacji pojazdu.

Zapis JSON
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
Pola
stop

object (VehicleStop)

Określa lokalizację przystanku wraz z powiązanymi z nim Task. Niektóre pola obiektu VehicleStop mogą nie być dostępne, jeśli ten segment podróży należy do: JourneySharingInfo.

drivingDistanceMeters

integer

Tylko dane wyjściowe. Odległość przebyta od poprzedniego przystanku do tego przystanku. Jeśli bieżący przystanek jest pierwszym na liście segmentów podróży, punktem początkowym jest lokalizacja pojazdu zarejestrowana w momencie dodania tego przystanku do listy. To pole może nie być widoczne, jeśli ten segment podróży jest częścią JourneySharingInfo.

drivingDuration

string (Duration format)

Tylko dane wyjściowe. Czas podróży z poprzedniego przystanku do tego przystanku. Jeśli obecny przystanek jest pierwszym przystankiem na liście segmentów podróży, punktem początkowym jest lokalizacja pojazdu zarejestrowana w momencie dodania tego przystanku do listy.

Jeśli to pole jest zdefiniowane na ścieżce Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) lub Task.remainingVehicleJourneySegments[0].drivingDuration (REST), może być wypełnione wartością z DeliveryVehicle.remaining_duration (gRPC) lub DeliveryVehicle.remainingDuration (REST). W ten sposób określa się czas pozostały do przejechania dystansu od ostatniej znanej lokalizacji aplikacji kierowcy, a nie od poprzedniego przystanku.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

path[]

object (LatLng)

Tylko dane wyjściowe. Ścieżka z poprzedniego przystanku do tego przystanku. Jeśli bieżący przystanek jest pierwszym przystankiem na liście segmentów podróży, jest to trasa z bieżącej lokalizacji pojazdu do tego przystanku w momencie dodania tego przystanku do listy. To pole może się nie pojawić, jeśli ten segment podróży należy do domeny JourneySharingInfo.

Jeśli to pole jest zdefiniowane w ścieżce Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) lub Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), można je zapełnić wartościami LatLng zdekodowanymi z kodu DeliveryVehicle.current_route_segment (gRPC) lub DeliveryVehicle.currentRouteSegment (REST). Powoduje to podanie trasy z ostatniej znanej lokalizacji aplikacji kierowcy, a nie trasy z poprzedniego przystanku.

VehicleStop

Opisuje punkt, w którym pojazd zatrzymuje się, aby wykonać co najmniej 1 Task.

Zapis JSON
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
Pola
plannedLocation

object (LocationInfo)

Wymagane. Lokalizacja przystanku. Pamiętaj, że lokalizacje w lokalizacji Task mogą nie być dokładnie takie same jak to, ale znajdujące się w niewielkiej odległości od niego. To pole nie będzie wypełniane w odpowiedzi na wywołanie tasks.get.

tasks[]

object (TaskInfo)

Lista Task, które mają być wykonane na tym przystanku. To pole nie będzie wypełniane w odpowiedzi na wywołanie tasks.get.

state

enum (State)

Stan VehicleStop. To pole nie będzie wypełniane w odpowiedzi na wywołanie tasks.get.

TaskInfo

Dodatkowe informacje o wykonywanym na tym przystanku zadaniu.

Zapis JSON
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
Pola
taskId

string

Identyfikator zadania. To pole nie będzie wypełniane w odpowiedzi na wywołanie tasks.get. Identyfikatory zadań podlegają tym ograniczeniom:

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • znormalizowany zgodnie z formą normalizacji C standardu Unicode.
  • Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.
taskDuration

string (Duration format)

Tylko dane wyjściowe. Czas potrzebny do wykonania zadania.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

targetTimeWindow

object (TimeWindow)

Tylko dane wyjściowe. Okno czasowe, w którym należy wykonać zadanie. Jest on ustawiany tylko w odpowiedzi na deliveryVehicles.get.

Stan

Bieżący stan VehicleStop.

Wartości w polu enum
STATE_UNSPECIFIED Nieznany.
NEW Utworzone, ale nie aktywnie kierujące ruchem.
ENROUTE Przypisany i aktywnie kierujący ruchem.
ARRIVED Dotarł(a) do przystanku. Zakłada się, że gdy Pojazd jedzie do następnego przystanku, wszystkie poprzednie przystanki zostały już zrealizowane.