REST Resource: providers.deliveryVehicles

{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}

string

الاسم الفريد لمركبة التسليم هذه. التنسيق هو providers/{provider}/deliveryVehicles/{vehicle}.

object (DeliveryVehicleLocation)

آخر موقع جغرافي تم الإبلاغ عنه لمركبة التسليم

enum (DeliveryVehicleNavigationStatus)

حالة التنقّل الخاصة بمركبة التسليم

string (bytes format)

الخطوط المتعددة المشفرة التي تحدد المسار الذي يقترح التنقل اتباعه إلى نقطة الطريق التالية. ويحدِّث تطبيق السائق هذا عند الوصول إلى محطة أو المرور بها وعند تغيير مسار التنقل. يتم عرض LatLng هذه باللون Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) أو Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) لجميع المهام النشطة المخصصة للمركبة.

هناك بعض الحالات التي قد لا يتم فيها استخدام هذا الحقل لتعبئة Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) أو Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

• لا تتطابق نقطة نهاية currentRouteSegment مع DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) أو DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

• لم يحدِّث تطبيق السائق موقعه الجغرافي مؤخرًا، لذا قد تكون آخر قيمة تم تعديلها لهذا الحقل قديمة.

• عدَّل تطبيق السائق موقعه الجغرافي مؤخرًا، لكنّ currentRouteSegment قديم ويشير إلى محطة سابقة للمركبات.

في هذه الحالات، يملأ Fleet Engine هذا الحقل بمسار يمتدّ من آخر نقطة مرور على AutomotiveStop إلى المنصّة التي ستجري التسليم فيها، وذلك للتأكّد من أنّ مستهلك هذا الحقل لديه أفضل المعلومات المتاحة حول المسار الحالي لمركبة التسليم.

سلسلة بترميز base64.

object (LatLng)

الموقع الجغرافي الذي ينتهي فيه currentRouteSegment. لا تتم تعبئة هذا الحقل حاليًا بواسطة تطبيق السائق، ولكن يمكنك تقديمه في مكالمات deliveryVehicles.patch. وهي إما LatLng من محطة المركبات القادمة أو آخر LatLng من currentRouteSegment. وسيبذل Fleet Engine قصارى جهده لدمج VehicleStop بشكل فعلي.

يتم تجاهل هذا الحقل في استدعاءات deliveryVehicles.patch إذا كان الحقل currentRouteSegment فارغًا.

integer

مسافة القيادة المتبقية لـ currentRouteSegment. يوفر تطبيق Driver عادةً هذا الحقل، ولكن هناك بعض الحالات التي يلغي فيها Fleet Engine القيمة التي يرسلها التطبيق. لمزيد من المعلومات، يُرجى الاطّلاع على "DeliveryVehicle.current_route_segment". يتم عرض هذا الحقل بعملة Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) أو Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) لكل Tasks النشطة التي تم تخصيصها لمركبة التسليم.

يتجاهل Fleet Engine هذا الحقل في UpdateDeliveryVehicleRequest إذا كان الحقل currentRouteSegment فارغًا.

string (Duration format)

الوقت المتبقّي لقيادة السيارة "currentRouteSegment" يوفر تطبيق Driver عادةً هذا الحقل، ولكن هناك بعض الحالات التي يلغي فيها Fleet Engine القيمة التي يرسلها التطبيق. لمزيد من المعلومات، يُرجى الاطّلاع على "DeliveryVehicle.current_route_segment". يتم عرض هذا الحقل بعملة Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) أو Task.remainingVehicleJourneySegments[0].drivingDuration (REST) لجميع المهام النشطة التي تم تعيينها لمركبة التسليم.

يتجاهل Fleet Engine هذا الحقل في UpdateDeliveryVehicleRequest إذا كان الحقل currentRouteSegment فارغًا.

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

object (VehicleJourneySegment)

أجزاء الرحلة المخصّصة لمركبة التسليم هذه، بدءًا من آخر موقع جغرافي للمركبة تم الإبلاغ عنه لن تتم تعبئة هذا الحقل في ردّ deliveryVehicles.list.

object (DeliveryVehicleAttribute)

قائمة بسمات التسليم المخصّصة يمكن أن تتضمّن سيارة التسليم 100 سمة كحدّ أقصى، ويجب أن تحتوي كل سمة على مفتاح فريد.

enum (DeliveryVehicleType)

تعرض هذه السمة نوع مركبة التسليم. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على AUTO.

{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}

string

مفتاح السمة.

string

قيمة السمة.

string

قيمة السمة المكتوبة بالسلسلة

ملاحظة: هذا مماثل للحقل value الذي سيتم إيقافه نهائيًا في النهاية. بالنسبة إلى طرق الإنشاء أو التعديل، يمكن استخدام أي من الحقلَين، ولكن يُنصح بشدة باستخدام stringValue. إذا تم ضبط كل من stringValue وvalue، يجب أن تكون القيمتان متطابقتَين وإلا سيتم حدوث خطأ. تتم تعبئة كلا الحقلين في الردود.

boolean

قيمة السمة المكتوبة بطريقة منطقية

number

قيمة سمة من نوعين