VehicleJourneySegment

Mewakili segmen perjalanan Kendaraan - dari perhentian sebelumnya ke perhentian saat ini. Jika perhentian aktif pertama, berarti perhentian tersebut dari lokasi Kendaraan saat ini ke perhentian ini.

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

object (VehicleStop)

Menentukan lokasi perhentian, beserta Task yang terkait dengan perhentian. Beberapa kolom VehicleStop mungkin tidak ada jika segmen perjalanan ini adalah bagian dari JourneySharingInfo.

drivingDistanceMeters

integer

Hanya output. Jarak perjalanan dari perhentian sebelumnya ke perhentian ini. Jika perhentian saat ini adalah perhentian pertama dalam daftar segmen perjalanan, titik awalnya adalah lokasi kendaraan yang dicatat pada saat perhentian ini ditambahkan ke daftar. Kolom ini mungkin tidak ada jika segmen perjalanan ini adalah bagian dari JourneySharingInfo.

drivingDuration

string (Duration format)

Hanya output. Waktu perjalanan dari perhentian sebelumnya ke perhentian ini. Jika perhentian saat ini adalah perhentian pertama dalam daftar segmen perjalanan, titik awalnya adalah lokasi Kendaraan yang dicatat pada saat perhentian ini ditambahkan ke daftar.

Jika kolom ini ditentukan di jalur Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) atau Task.remainingVehicleJourneySegments[0].drivingDuration (REST), kolom tersebut mungkin diisi dengan nilai dari DeliveryVehicle.remaining_duration (gRPC) atau DeliveryVehicle.remainingDuration (REST). Data ini menampilkan sisa durasi mengemudi dari lokasi terbaru aplikasi pengemudi yang diketahui, bukan waktu mengemudi dari perhentian sebelumnya.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

path[]

object (LatLng)

Hanya output. Jalur dari perhentian sebelumnya ke perhentian ini. Jika perhentian saat ini adalah perhentian pertama dalam daftar segmen perjalanan, berarti ini adalah jalur dari lokasi kendaraan saat ini ke perhentian ini pada saat perhentian ditambahkan ke daftar. Kolom ini mungkin tidak ada jika segmen perjalanan ini adalah bagian dari JourneySharingInfo.

Jika kolom ini ditentukan di jalur Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), kolom tersebut mungkin diisi dengan LatLng yang didekode dari DeliveryVehicle.current_route_segment (gRPC) atau DeliveryVehicle.currentRouteSegment (REST). Ini memberikan jalur mengemudi dari lokasi terbaru aplikasi pengemudi yang diketahui, bukan jalur dari perhentian sebelumnya.

VehicleStop

Menjelaskan titik saat Kendaraan berhenti untuk melakukan satu atau beberapa Task.

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

object (LocationInfo)

Wajib. Lokasi perhentian. Perhatikan bahwa lokasi di Task mungkin tidak sama persis dengan lokasi ini, tetapi jaraknya tidak terlalu jauh. Kolom ini tidak akan diisi sebagai respons dari panggilan tasks.get.

tasks[]

object (TaskInfo)

Daftar Task yang akan dilakukan di perhentian ini. Kolom ini tidak akan diisi sebagai respons dari panggilan tasks.get.

state

enum (State)

Status VehicleStop. Kolom ini tidak akan diisi sebagai respons dari panggilan tasks.get.

TaskInfo

Informasi tambahan tentang Tugas yang dijalankan di perhentian ini.

Representasi JSON
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
Kolom
taskId

string

ID Tugas. Kolom ini tidak akan diisi sebagai respons dari panggilan tasks.get. ID tugas tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalkan menurut Formulir Normalisasi Unicode C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
taskDuration

string (Duration format)

Hanya output. Waktu yang diperlukan untuk menjalankan Tugas.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

targetTimeWindow

object (TimeWindow)

Hanya output. Periode waktu saat tugas harus diselesaikan. Ini hanya ditetapkan sebagai respons terhadap deliveryVehicles.get.

Negara Bagian

Status VehicleStop saat ini.

Enum
STATE_UNSPECIFIED Tak diketahui.
NEW Dibuat, tetapi tidak secara aktif memilih rute.
ENROUTE Ditetapkan dan aktif memilih rute.
ARRIVED Tiba di perhentian. Mengasumsikan bahwa saat Kendaraan memilih rute ke perhentian berikutnya, semua perhentian sebelumnya telah selesai.