REST Resource: providers.deliveryVehicles

المرجع: DeliveryVehicle

رسالة DeliveryVehicle. تعمل مركبة توصيل لنقل الشحنات من المستودع إلى موقع التسليم، ومن موقع الاستلام إلى المستودع. وفي بعض الحالات، تنقل مركبات التسليم أيضًا الشحنات مباشرةً من موقع الاستلام إلى موقع التسليم.

ملاحظة: تستخدم واجهات برمجة التطبيقات gRPC وREST اصطلاحات تسمية حقول مختلفة. على سبيل المثال، يشير الحقل DeliveryVehicle.current_route_segment في واجهة برمجة التطبيقات gRPC والحقل DeliveryVehicle.currentRouteSegment في واجهة برمجة التطبيقات REST إلى الحقل نفسه.

تمثيل JSON 
{
  "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)
}
الحقول
name

string

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

object (DeliveryVehicleLocation)

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

enum (DeliveryVehicleNavigationStatus)

حالة التنقّل في مركبة التسليم
currentRouteSegment

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

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

object (LatLng)

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

يتم تجاهل هذا الحقل في طلبات deliveryVehicles.patch إذا كان الحقل currentRouteSegment فارغًا.
remainingDistanceMeters

integer

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

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

string (Duration format)

وقت القيادة المتبقّي لـ "currentRouteSegment". يوفر تطبيق Drive عادةً هذا الحقل، ولكن هناك بعض الحالات التي يلغي فيها 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".
remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

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

object (DeliveryVehicleAttribute)

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

enum (DeliveryVehicleType)

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

DeliveryVehicleNavigationStatus

حالة التنقّل في المركبة

عمليات التعداد
UNKNOWN_NAVIGATION_STATUS حالة تنقّل غير محدّدة.
NO_GUIDANCE إنّ التنقُّل في تطبيق "السائق" في وضع FREE_NAV.
ENROUTE_TO_DESTINATION تتوفّر ميزة التنقّل باتّجاهات مفصّلة للتنقّل في تطبيق Drive وقد دخلت ميزة التنقّل في تطبيق Drive إلى الوضع GUIDED_NAV.
OFF_ROUTE انحرفت المركبة عن المسار المقترح.
ARRIVED_AT_DESTINATION تقع المركبة على بُعد 50 مترًا من الوجهة تقريبًا.

DeliveryVehicleAttribute

لوصف سمة مركبة كزوج من المفتاح/القيمة. لا يمكن أن يتجاوز طول سلسلة "key:value" 256 حرفًا.

تمثيل JSON 
{
  "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.
}
الحقول
key

string

مفتاح السمة.
value

string

تمثّل هذه السمة قيمة السمة.
حقل الاتحاد delivery_vehicle_attribute_value يمكن أن تكون قيمة السمة سلسلة أو قيمة منطقية أو نوع مزدوج. يمكن أن تكون السمة "delivery_vehicle_attribute_value" واحدة فقط مما يلي:
stringValue

string

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

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

boolean

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

number

قيمة السمة المكتوبة بحروف مزدوجة

DeliveryVehicleType

تمثّل هذه السمة نوع مركبة التسليم.

عمليات التعداد
DELIVERY_VEHICLE_TYPE_UNSPECIFIED القيمة غير مستخدَمة.
AUTO سيارة.
TWO_WHEELER دراجة نارية أو دراجة نارية أو مركبة أخرى ذات عجلتين
BICYCLE النقل البشري:
PEDESTRIAN ناقل بشري، عادةً ما يسير أو يركض، ويتنقل على طول مسارات المشاة.

الطُرق

create

 إنشاء DeliveryVehicle جديد وعرضه.

get

 لعرض مثيل DeliveryVehicle المحدد.

list

 الحصول على جميع DeliveryVehicle التي تستوفي معايير الفلترة المحددة.

patch

 تكتب بيانات DeliveryVehicle المعدَّلة إلى Fleet Engine، وتخصِّص Tasks إلى DeliveryVehicle.