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 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
taskDuration

string (Duration format)

النتائج فقط. الوقت المطلوب لتنفيذ المهمة.

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

targetTimeWindow

object (TimeWindow)

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

الحالة

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

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