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 إلى محطة AutomotiveStop القادمة للتأكّد من أنّ مستهلك هذا الحقل لديه أفضل المعلومات المتاحة حول المسار الحالي لمركبة التسليم.

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

object (LatLng)

الموقع الجغرافي الذي ينتهي فيه currentRouteSegment لا يتم حاليًا تعبئة هذا الحقل من خلال تطبيق السائق، ولكن يمكنك تقديمه في مكالمات deliveryVehicles.patch. إما أن يكون LatLng من محطة المركبات القادمة، أو آخر LatLng من currentRouteSegment. سيبذل "محرك الأسطول" قصارى جهده بعد ذلك لإجراء عملية الاستقراء إلى 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

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