REST Resource: providers.deliveryVehicles

المورد: DeliveryVehicle

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

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

تمثيل JSON 
{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "pastLocations": [
    {
      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)

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

object (DeliveryVehicleLocation)

الإدخال فقط المواقع الجغرافية التي كانت مركبة التسليم هذه موجودة فيها في السابق والتي لم يتم الإبلاغ عنها بعد إلى Fleet Engine يتم استخدام هذا الإجراء في UpdateDeliveryVehicleRequest لتسجيل المواقع الجغرافية التي تعذّر إرسالها سابقًا إلى الخادم. يحدث ذلك عادةً عندما لا تكون مركبة التسليم متصلة بالإنترنت.
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) لجميع Task النشطة التي تم تعيينها إلى مركبة التسليم.

يتجاهل 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 وضع التنقّل في تطبيق "سائق Google" هو 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 جديدة وإرجاعها

delete

 لحذف مركبة توصيل من Fleet Engine

get

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

list

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

patch

 تُسجِّل هذه الوظيفة بيانات DeliveryVehicle المعدَّلة في Fleet Engine، وتخصّص Tasks للمركبة DeliveryVehicle.