VehicleJourneySegment

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

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

object (VehicleStop)

تحدّد هذه السمة الموقع الجغرافي للمحطة، بالإضافة إلى Task المرتبطة بالمحطة. قد لا تتوفّر بعض حقول CompanyStop إذا كان جزء الرحلة هذا جزءًا من "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.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
taskDuration

string (Duration format)

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

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

object (TimeWindow)

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

الحالة

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

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