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 oraz powiązane 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 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. To pole może się nie pojawić, jeśli ten segment podróży należy do domeny 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 w ś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). Podaje pozostały czas jazdy z ostatniej znanej lokalizacji aplikacji kierowcy zamiast czasu jazdy z poprzedniego przystanku.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „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 najnowszej znanej lokalizacji aplikacji kierowcy, a nie trasy z poprzedniego przystanku.

VehicleStop

Wskazuje 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 s do wykonania w 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 zadaniu wykonanym w tym miejscu.

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 być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
taskDuration

string (Duration format)

Tylko dane wyjściowe. Czas wymagany 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. Przedział czasu, w którym zadanie ma zostać wykonane. To ustawienie jest ustawiane tylko w odpowiedzi na deliveryVehicles.get.

Stan

Bieżący stan elementu VehicleStop.

Wartości w polu enum
STATE_UNSPECIFIED Nieznany.
NEW Utworzono, ale kierowanie nie jest aktywne.
ENROUTE Przypisana i aktywnie routing.
ARRIVED Dotarł(a) do przystanku. Zakładamy, że gdy pojazd jedziesz do następnego przystanku, wszystkie poprzednie przystanki zostały ukończone.