TaskLog

Log zasobu Task w interfejsie Deliveries API.

Zapis JSON
{
  "name": string,
  "type": enum (TaskTypeLog),
  "state": enum (TaskStateLog),
  "taskOutcome": enum (TaskOutcomeLog),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfoLog)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSourceLog),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfoLog)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindowLog)
  },
  "journeySharingInfo": {
    object (JourneySharingInfoLog)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfigLog)
  },
  "attributes": [
    {
      object (TaskAttributeLog)
    }
  ]
}
Pola
name

string

Nazwa zasobu zadania w formacie providers/{providerId}/tasks/{taskId}.

type

enum (TaskTypeLog)

Typ zadania.

state

enum (TaskStateLog)

Stan zadania wskazujący na jego postęp.

taskOutcome

enum (TaskOutcomeLog)

Wynik próby wykonania zadania. Gdy TaskState jest zamknięta, wskazuje, czy została wykonana.

taskOutcomeTime

string (Timestamp format)

Sygnatura czasowa ustawienia wyniku zadania (od dostawcy).

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

taskOutcomeLocation

object (LocationInfoLog)

Lokalizacja, w której ustawiono wynik zadania.

taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

Wskazuje, skąd pochodzi wartość parametru taskOutcomeLocation.

trackingId

string

To pole ułatwia przechowywanie identyfikatora klienta, co pozwala uniknąć niepotrzebnego lub skomplikowanego mapowania.

deliveryVehicleId

string

Identyfikator pojazdu wykonującego to zadanie.

plannedLocation

object (LocationInfoLog)

Lokalizacja, w której zadanie zostało ukończone.

taskDuration

string (Duration format)

Dodatkowy czas na wykonanie działania w tej lokalizacji.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

targetTimeWindow

object (TimeWindowLog)

Przedział czasu, w którym powinno zostać wykonane zadanie.

journeySharingInfo

object (JourneySharingInfoLog)

Określone pola związane z udostępnianiem serii czynności.

taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

Konfiguracja śledzenia zadań, która określa, które elementy danych są widoczne dla użytkowników w jakich okolicznościach.

attributes[]

object (TaskAttributeLog)

Lista niestandardowych atrybutów zadania. Każdy atrybut musi mieć unikalny klucz.

JourneySharingInfoLog

Określone pola związane z udostępnianiem serii czynności.

Zapis JSON
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
Pola
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

Dane śledzenia każdego przystanku, do którego będzie dojeżdżał przydzielony pojazd, zanim wykonasz to zadanie. Ta lista może zawierać przystanki z innych zadań.

lastLocation

object (DeliveryVehicleLocationLog)

Ostatnia zgłoszona lokalizacja pojazdu.

lastLocationSnappable

boolean

Wskazuje, czy lastLocation pojazdu może zostać przyciągnięte do currentRouteSegment. False, jeśli lastLocation lub currentRouteSegment nie istnieje.

TaskTrackingViewConfigLog

Komunikat konfiguracji, który określa, kiedy element danych zadania powinien być widoczny dla użytkowników.

Zapis JSON
{
  "routePolylinePointsVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOptionLog)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOptionLog)
  }
}
Pola
routePolylinePointsVisibility

object (VisibilityOptionLog)

Pole, które określa, kiedy punkty linii łamanej trasy mogą być widoczne. Jeśli to pole nie zostanie określone, dla tych danych zostanie użyta domyślna konfiguracja widoczności na poziomie projektu.

estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

Pole określające, kiedy może być widoczny szacowany czas przyjazdu. Jeśli to pole nie zostanie określone, dla tych danych zostanie użyta domyślna konfiguracja widoczności na poziomie projektu.

estimatedTaskCompletionTimeVisibility

object (VisibilityOptionLog)

Pole określające, kiedy może być widoczny szacowany czas ukończenia zadania. Jeśli to pole nie zostanie określone, dla tych danych zostanie użyta domyślna konfiguracja widoczności na poziomie projektu.

remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

Pole określające pozostały dystans samochodem może być widoczne. Jeśli to pole nie zostanie określone, dla tych danych zostanie użyta domyślna konfiguracja widoczności na poziomie projektu.

remainingStopCountVisibility

object (VisibilityOptionLog)

Pole określające, kiedy może się zmniejszyć liczba przystanków. Jeśli to pole nie zostanie określone, dla tych danych zostanie użyta domyślna konfiguracja widoczności na poziomie projektu.

vehicleLocationVisibility

object (VisibilityOptionLog)

Pole, które określa, kiedy lokalizacja pojazdu może być widoczna. Jeśli to pole nie zostanie określone, dla tych danych zostanie użyta domyślna konfiguracja widoczności na poziomie projektu.

VisibilityOptionLog

Komunikat dotyczący opcji, który określa, kiedy element danych powinien być widoczny dla użytkowników.

Zapis JSON
{

  // Union field visibility_option can be only one of the following:
  "remainingStopCountThreshold": integer,
  "durationUntilEstimatedArrivalTimeThreshold": string,
  "remainingDrivingDistanceMetersThreshold": integer,
  "always": boolean,
  "never": boolean
  // End of list of possible types for union field visibility_option.
}
Pola

Pole sumy visibility_option.

visibility_option może mieć tylko jedną z tych wartości:

remainingStopCountThreshold

integer

Ten element danych jest widoczny dla użytkowników, jeśli liczba pozostałych postojów wynosi <= leftStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Ten element danych jest widoczny dla użytkowników, jeśli szacowany czas dotarcia do zatrzymania to <= durationUntilScheduleArrivalTimeThreshold.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

remainingDrivingDistanceMetersThreshold

integer

Ten element danych jest widoczny dla użytkowników, jeśli pozostała odległość przejazdu w metrach <= pozostająca odległość w metrach jazdy.

always

boolean

Jeśli ma wartość Prawda, ten element danych jest zawsze widoczny dla użytkowników bez żadnych progów.

never

boolean

Jeśli ma wartość Prawda, ten element danych jest zawsze ukryty przed użytkownikami bez wartości progowych.

TaskAttributeLog

Opisuje atrybut zadania jako parę klucz-wartość. Długość ciągu „klucz:wartość” nie może przekraczać 256 znaków.

Zapis JSON
{
  "key": string,

  // Union field task_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field task_attribute_value.
}
Pola
key

string

Klucz atrybutu. Klucze nie mogą zawierać znaku dwukropka (:).

Pole sumy task_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub liczbą zmiennoprzecinkową. Jeśli nie ustawisz żadnej wartości, atrybut TaskAttribute string_value będzie przechowywany jako pusty ciąg „". task_attribute_value może być tylko jedną z tych wartości:
stringValue

string

Wartość atrybutu wpisana na podstawie ciągu znaków.

boolValue

boolean

Wartość atrybutu o typie wartości logicznej.

numberValue

number

Wartość atrybutu z podwójnym wpisanym.