VehicleJourneySegment

Mewakili segmen perjalanan Kendaraan - dari perhentian sebelumnya hingga perhentian saat ini. Jika ini adalah perhentian aktif pertama, perhentian tersebut akan berasal 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 awal 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 awal adalah lokasi Kendaraan yang tercatat 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 ini dapat diisi dengan nilai dari DeliveryVehicle.remaining_duration (gRPC) atau DeliveryVehicle.remainingDuration (REST). Kolom ini memberikan sisa durasi mengemudi dari lokasi terbaru aplikasi pengemudi yang diketahui, bukan waktu mengemudi dari perhentian sebelumnya.

Durasi dalam detik dengan paling banyak 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, ini adalah jalur dari lokasi kendaraan saat ini ke perhentian ini pada saat perhentian tersebut 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 ini mungkin diisi dengan LatLng yang didekode dari DeliveryVehicle.current_route_segment (gRPC) atau DeliveryVehicle.currentRouteSegment (REST). Kolom ini memberikan jalur mengemudi dari lokasi terbaru aplikasi pengemudi yang diketahui, bukan jalur dari perhentian sebelumnya.

VehicleStop

Menjelaskan titik tempat 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 akan berada dalam jarak dekat. Kolom ini tidak akan diisi sebagai respons dari panggilan tasks.get atau tasks.search.

tasks[]

object (TaskInfo)

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

state

enum (State)

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

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 atau tasks.search. ID tugas tunduk pada batasan berikut:

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

string (Duration format)

Hanya output. Waktu yang diperlukan untuk melakukan Tugas.

Durasi dalam detik dengan paling banyak 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 Tidak diketahui.
NEW Dibuat, tetapi tidak melakukan pemilihan rute secara aktif.
ENROUTE Ditetapkan dan secara aktif mengarahkan.
ARRIVED Tiba di perhentian. Mengasumsikan bahwa pada saat Kendaraan bergerak ke perhentian berikutnya, semua perhentian sebelumnya telah selesai.