VehicleJourneySegment

يمثّل هذا المقياس شريحة السفر في مركبة، من محطتها السابقة إلى المحطة الحالية. إذا كانت أول محطة نشطة، تكون من الموقع الجغرافي الحالي للمركبة وحتى هذه المحطة.

تمثيل JSON 
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
الحقول
stop

object (VehicleStop)

تحدّد هذه السمة موقع المحطة، بالإضافة إلى Task المرتبطة بها. قد لا تتوفّر بعض حقول vehicleStop إذا كان جزء الرحلة هذا جزءًا من JourneySharingInfo.
drivingDistanceMeters

integer

النتائج فقط. مسافة السفر من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة أجزاء الرحلة، تكون نقطة البداية هي الموقع الجغرافي للمركبة المسجّل في وقت إضافة هذه المحطة إلى القائمة. قد لا يتوفّر هذا الحقل إذا كان جزء الرحلة هذا جزءًا من "JourneySharingInfo".
drivingDuration

string (Duration format)

النتائج فقط. مدة الرحلة من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة أجزاء الرحلة، تكون نقطة البداية هي الموقع الجغرافي للمركبة المسجّل في وقت إضافة هذه المحطة إلى القائمة.

في حال تحديد هذا الحقل في المسار Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) أو Task.remainingVehicleJourneySegments[0].drivingDuration (REST)، قد تتم تعبئته بالقيمة من DeliveryVehicle.remaining_duration (gRPC) أو DeliveryVehicle.remainingDuration (REST). يوفّر ذلك مدة القيادة المتبقية من آخر موقع جغرافي معروف لتطبيق السائق بدلاً من وقت القيادة من المحطة السابقة.

مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ "s". مثال: "3.5s".
path[]

object (LatLng)

النتائج فقط. المسار من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة مقاطع الرحلة، تكون هذه هي المسار من الموقع الجغرافي الحالي للمركبة إلى هذه المحطة في الوقت الذي تمت إضافة المحطة فيه إلى القائمة. قد لا يتوفّر هذا الحقل إذا كان جزء الرحلة هذا جزءًا من "JourneySharingInfo".

إذا تم تحديد هذا الحقل في المسار Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) أو Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST)، قد تتم تعبئته بـ LatLng التي تم فك ترميزها من DeliveryVehicle.current_route_segment (gRPC) أو DeliveryVehicle.currentRouteSegment (REST). يوفر هذا مسار القيادة من آخر موقع جغرافي معروف لتطبيق السائق بدلاً من المسار من المحطة السابقة.

VehicleStop

يشير هذا المقياس إلى نقطة تتوقف فيها المركبة عن تنفيذ وظيفة Task واحدة أو أكثر.

تمثيل JSON 
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
الحقول
plannedLocation

object (LocationInfo)

مطلوبة. موقع المحطة. تجدر الإشارة إلى أنّ المواقع الجغرافية في Task قد لا تتطابق تمامًا مع هذا الموقع الجغرافي، ولكنها ستكون على مسافة قصيرة منه. ولن تتم تعبئة هذا الحقل استجابةً لاستدعاء tasks.get أو tasks.search.
tasks[]

object (TaskInfo)

قائمة Task التي سيتم أداؤها في هذه المحطة. ولن تتم تعبئة هذا الحقل استجابةً لاستدعاء tasks.get أو tasks.search.
state

enum (State)

حالة VehicleStop. ولن تتم تعبئة هذا الحقل استجابةً لاستدعاء tasks.get أو tasks.search.

TaskInfo

تتوفّر معلومات إضافية حول المهمة التي تم تنفيذها في هذه المحطة.

تمثيل JSON 
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
الحقول
taskId

string

معرّف المهمة ولن تتم تعبئة هذا الحقل استجابةً لاستدعاء tasks.get أو tasks.search. تخضع معرفات المهام للقيود التالية:

  • يجب أن تكون سلسلة Unicode صالحة.
  • الحد الأقصى لعدد الأحرف هو 64 حرفًا.
  • تتم تسويتها وفقًا لنموذج تسوية Unicode.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
taskDuration

string (Duration format)

النتائج فقط. تمثّل هذه السمة الوقت اللازم لتنفيذ المهمة.

مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ "s". مثال: "3.5s".
targetTimeWindow

object (TimeWindow)

النتائج فقط. الفترة الزمنية التي ينبغي أن تكتمل خلالها المهمة. يتم ضبط هذا الخيار فقط في الردّ على deliveryVehicles.get.

الحالة

الحالة الحالية لـ VehicleStop.

عمليات التعداد
STATE_UNSPECIFIED غير معروف.
NEW تم إنشاؤه، ولكن لا يتم توجيهه بشكل نشط.
ENROUTE معيّن وتوجيه نشط.
ARRIVED وصلت إلى المحطة. يفترض أنّه عند توجيه المركبة إلى المحطة التالية، تكون جميع المحطات السابقة قد اكتملت.