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 هذا الحقل بمسار من VehicleStop الذي تم اجتيازه مؤخرًا إلى VehicleStop القادم لضمان حصول مستخدِم هذا الحقل على أفضل المعلومات المتاحة حول المسار الحالي لمركبة التسليم.

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

object (LatLng)

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

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

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 فارغًا.
remainingDuration

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"
remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

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

object (DeliveryVehicleAttribute)

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

enum (DeliveryVehicleType)

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

DeliveryVehicleNavigationStatus

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

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

DeliveryVehicleAttribute

تصف سمة المركبة كزوج مفتاح/قيمة. لا يمكن أن تتجاوز طول سلسلة "المفتاح:القيمة" 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. يمكن أن تكون قيمة السمة من النوع string أو bool أو double. يمكن أن يكون 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.