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

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

currentRouteSegmentEndPoint

object (LatLng)

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