- المورد: DeliveryVehicle
- DeliveryVehicleNavigationStatus
- DeliveryVehicleAttribute
- DeliveryVehicleType
- الطُرق
المرجع: DeliveryVehicle
رسالة DeliveryVehicle
. تعمل مركبة توصيل لنقل الشحنات من المستودع إلى موقع التسليم، ومن موقع الاستلام إلى المستودع. وفي بعض الحالات، تنقل مركبات التسليم أيضًا الشحنات مباشرةً من موقع الاستلام إلى موقع التسليم.
ملاحظة: تستخدم واجهات برمجة التطبيقات gRPC وREST اصطلاحات تسمية حقول مختلفة. على سبيل المثال، يشير الحقل DeliveryVehicle.current_route_segment
في واجهة برمجة التطبيقات gRPC والحقل DeliveryVehicle.currentRouteSegment
في واجهة برمجة التطبيقات REST إلى الحقل نفسه.
تمثيل JSON |
---|
{ "name": string, "lastLocation": { object ( |
الحقول | |
---|---|
name |
الاسم الفريد لمركبة التسليم هذه. التنسيق هو |
lastLocation |
آخر موقع تم الإبلاغ عنه لمركبة التسليم |
navigationStatus |
حالة التنقّل في مركبة التسليم |
currentRouteSegment |
الخط المتعدد المشفر الذي يحدد المسار الذي يوصي التنقل بأخذه إلى نقطة الطريق التالية. يحدِّث تطبيق السائق هذا عند الوصول إلى محطة أو عند عبورها، وعند تغيير مسار التنقل. يتم عرض هناك بعض الحالات التي قد لا يتم فيها استخدام هذا الحقل لتعبئة
في هذه الحالات، يملأ Fleet Engine هذا الحقل بمسار من آخر المركباتStop التي تم تمريرها إلى المركباتStop القادمة للتأكّد من أنّ المستهلك في هذا الحقل لديه أفضل المعلومات المتاحة عن المسار الحالي لمركبة التسليم. سلسلة بترميز base64. |
currentRouteSegmentEndPoint |
الموقع الجغرافي الذي ينتهي فيه يتم تجاهل هذا الحقل في طلبات |
remainingDistanceMeters |
مسافة القيادة المتبقية لـ يتجاهل Fleet Engine هذا الحقل في |
remainingDuration |
وقت القيادة المتبقّي لـ " يتجاهل Fleet Engine هذا الحقل في مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ " |
remainingVehicleJourneySegments[] |
تمثّل هذه السمة أجزاء الرحلة المخصّصة لمركبة التسليم هذه، بدءًا من أحدث موقع جغرافي تم الإبلاغ عنه للمركبة. لن تتم تعبئة هذا الحقل عند الردّ على |
attributes[] |
قائمة بسمات مركبات التسليم المخصّصة يمكن أن تتضمن مركبة التوصيل 100 سمة كحد أقصى، ويجب أن يكون لكل سمة مفتاح فريد. |
type |
تمثّل هذه السمة نوع مركبة التسليم هذه. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على |
DeliveryVehicleAttribute
لوصف سمة مركبة كزوج من المفتاح/القيمة. لا يمكن أن يتجاوز طول سلسلة "key:value" 256 حرفًا.
تمثيل JSON |
---|
{ "key": string, "value": string, // Union field |
الحقول | |
---|---|
key |
مفتاح السمة. |
value |
تمثّل هذه السمة قيمة السمة. |
حقل الاتحاد delivery_vehicle_attribute_value يمكن أن تكون قيمة السمة سلسلة أو قيمة منطقية أو نوع مزدوج. يمكن أن تكون السمة "delivery_vehicle_attribute_value " واحدة فقط مما يلي: |
|
stringValue |
قيمة سمة كتابة السلسلة ملاحظة: هذا الحقل مطابق للحقل |
boolValue |
قيمة السمة المكتوبة بقيم منطقية. |
numberValue |
قيمة السمة المكتوبة بحروف مزدوجة |
DeliveryVehicleType
تمثّل هذه السمة نوع مركبة التسليم.
عمليات التعداد | |
---|---|
DELIVERY_VEHICLE_TYPE_UNSPECIFIED |
القيمة غير مستخدَمة. |
AUTO |
سيارة. |
TWO_WHEELER |
دراجة نارية أو دراجة نارية أو مركبة أخرى ذات عجلتين |
BICYCLE |
النقل البشري: |
PEDESTRIAN |
ناقل بشري، عادةً ما يسير أو يركض، ويتنقل على طول مسارات المشاة. |
الطُرق |
|
---|---|
|
إنشاء DeliveryVehicle جديد وعرضه. |
|
لعرض مثيل DeliveryVehicle المحدد. |
|
الحصول على جميع DeliveryVehicle التي تستوفي معايير الفلترة المحددة. |
|
تكتب بيانات DeliveryVehicle المعدَّلة إلى Fleet Engine، وتخصِّص Tasks إلى DeliveryVehicle . |