VehicleJourneySegment

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

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

object (VehicleStop)

تُحدِّد موقع المحطة، إلى جانب Task المرتبطة بالمحطة. قد لا تكون بعض حقول AutomotiveStop إذا كان جزء الرحلة هذا جزءًا من 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[]

object (TaskInfo)

قائمة Task التي سيتم إجراؤها في هذه المحطة لن تتم تعبئة هذا الحقل في الردّ على مكالمة tasks.get.

state

enum (State)

تمثّل هذه السمة حالة VehicleStop. لن تتم تعبئة هذا الحقل في الردّ على مكالمة tasks.get.

TaskInfo

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

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

string

معرّف المهمة. لن تتم تعبئة هذا الحقل في الردّ على مكالمة tasks.get. تخضع معرّفات المهام للقيود التالية:

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

string (Duration format)

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

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

targetTimeWindow

object (TimeWindow)

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

الحالة

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

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