Package maps.fleetengine.delivery.v1

الفهرس

• DeliveryService (واجهة)
• BatchCreateTasksRequest (رسالة)
• BatchCreateTasksResponse (رسالة)
• CreateDeliveryVehicleRequest (رسالة)
• CreateTaskRequest (رسالة)
• DeliveryRequestHeader (رسالة)
• DeliveryRequestHeader.Platform (تعداد)
• DeliveryRequestHeader.SdkType (تعداد)
• DeliveryVehicle (رسالة)
• DeliveryVehicle.DeliveryVehicleType (تعداد)
• DeliveryVehicleAttribute (رسالة)
• DeliveryVehicleLocation (رسالة)
• DeliveryVehicleLocationSensor (تعداد)
• DeliveryVehicleNavigationStatus (تعداد)
• GetDeliveryVehicleRequest (رسالة)
• GetTaskRequest (رسالة)
• GetTaskTrackingInfoRequest (رسالة)
• ListDeliveryVehiclesRequest (رسالة)
• ListDeliveryVehiclesResponse (رسالة)
• ListTasksRequest (رسالة)
• ListTasksResponse (رسالة)
• LocationInfo (رسالة)
• Task (رسالة)
• Task.JourneySharingInfo (رسالة)
• Task.State (تعداد)
• Task.TaskOutcome (تعداد)
• Task.TaskOutcomeLocationSource (تعداد)
• Task.Type (تعداد)
• TaskAttribute (رسالة)
• TaskTrackingInfo (رسالة)
• TaskTrackingViewConfig (رسالة)
• TaskTrackingViewConfig.VisibilityOption (رسالة)
• TimeWindow (رسالة)
• UpdateDeliveryVehicleRequest (رسالة)
• UpdateTaskRequest (رسالة)
• VehicleJourneySegment (رسالة)
• VehicleStop (رسالة)
• VehicleStop.State (تعداد)
• VehicleStop.TaskInfo (رسالة)

DeliveryService

خدمة التسليم عبر الميل الأخير.

BatchCreateTasks
rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse) إنشاء مجموعة من كائنات Task الجديدة وإرجاعها

CreateDeliveryVehicle
rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle) تنشئ السمة DeliveryVehicle جديدة وتعرضها.

CreateTask
rpc CreateTask(CreateTaskRequest) returns (Task) تنشئ كائن Task جديدًا وتعرضه.

GetDeliveryVehicle
rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle) تعرض مثيل DeliveryVehicle المحدد.

GetTask
rpc GetTask(GetTaskRequest) returns (Task) الحصول على معلومات عن Task

GetTaskTrackingInfo
rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo) تعرض مثيل TaskTrackingInfo المحدد.

ListDeliveryVehicles
rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse) الحصول على جميع DeliveryVehicle التي تستوفي معايير الفلترة المحدّدة.

ListTasks
rpc ListTasks(ListTasksRequest) returns (ListTasksResponse) الحصول على جميع Task التي تستوفي معايير الفلترة المحدّدة.

UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle) تعمل هذه السياسة على كتابة بيانات DeliveryVehicle المعدَّلة في Fleet Engine وتعيين Tasks إلى DeliveryVehicle. لا يمكنك تعديل اسم "DeliveryVehicle". يمكنك تحديث remaining_vehicle_journey_segments، ولكن يجب أن يحتوي على جميع VehicleJourneySegments للاستمرار في DeliveryVehicle. يتم استرداد task_id من remaining_vehicle_journey_segments، ويتم منح Tasks المقابلة لها إلى DeliveryVehicle في حال لم يتم تخصيصها بعد.

UpdateTask
rpc UpdateTask(UpdateTaskRequest) returns (Task) يتم تعديل بيانات "Task".

BatchCreateTasksRequest

رسالة طلب BatchCreateTask.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API ملاحظة: في حال ضبط هذا الحقل، يجب أن يكون حقل العنوان في رسائل CreateTaskRequest فارغًا أو يجب أن يتطابق مع هذا الحقل.
parent	string مطلوب. المورد الرئيسي الذي تتم مشاركته بين جميع المهام. ويجب أن تكون هذه القيمة بالتنسيق providers/{provider}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project يجب أن يكون الحقل الرئيسي في رسائل CreateTaskRequest فارغًا أو يجب أن يتطابق مع هذا الحقل.
requests[]	CreateTaskRequest مطلوب. يشير ذلك المصطلح إلى رسالة الطلب التي تحدِّد الموارد المطلوب إنشاؤها. ملاحظة: يمكنك إنشاء 500 مهمة كحد أقصى في الدُفعة الواحدة.

BatchCreateTasksResponse

رسالة الردّ BatchCreateTask.

الحقول
tasks[]	Task "مهام Google" التي تم إنشاؤها

CreateDeliveryVehicleRequest

رسالة طلب CreateDeliveryVehicle.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
parent	string مطلوب. يجب أن يكون بالتنسيق providers/{provider}. يجب أن يكون مقدّم الخدمة هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project
delivery_vehicle_id	string مطلوب. يجب أن يكون معرّف مركبة التسليم فريدًا ويخضع للقيود التالية: يجب أن تكون سلسلة Unicode صالحة. لا يتجاوز عدد الأحرف 64 حرفًا كحد أقصى. تمت التسوية وفقًا لنموذج تسوية Unicode C. لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
delivery_vehicle	DeliveryVehicle مطلوب. الكيان DeliveryVehicle المطلوب إنشاؤه. عند إنشاء مركبة تسليم جديدة، يمكنك ضبط الحقول الاختيارية التالية: كتابة last_location سمات ملاحظة: يتم تجاهل حقل name في DeliveryVehicle. يجب عدم ضبط جميع حقول DeliveryVehicle الأخرى. وإلا فسيتم إرجاع خطأ.

CreateTaskRequest

رسالة طلب CreateTask.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
parent	string مطلوب. يجب أن يكون بالتنسيق providers/{provider}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project
task_id	string مطلوب. يجب أن يكون معرّف المهمة فريدًا، ولكن يجب ألا يكون معرّف تتبّع شحن. لتخزين رقم تعريف تتبّع الشحن، استخدِم الحقل tracking_id. يُرجى العِلم أنّه يمكن أن تتضمّن مهام متعددة سمة tracking_id نفسها. تخضع معرّفات المهام للقيود التالية: يجب أن تكون سلسلة Unicode صالحة. لا يتجاوز عدد الأحرف 64 حرفًا كحد أقصى. تمت التسوية وفقًا لنموذج تسوية Unicode C. لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
task	Task مطلوب. كيان المهمّة المطلوب إنشاؤها. عند إنشاء مهمة، يجب إدراج الحقول التالية: type state (يجب الضبط على OPEN) tracking_id (يجب عدم ضبطها على UNAVAILABLE أو SCHEDULED_STOP مهمة، ولكن يجب ضبطها لجميع أنواع المهام الأخرى) planned_location (اختيارية في UNAVAILABLE مهمة) task_duration ملاحظة: يتم تجاهل حقل name للمهمة. يجب عدم ضبط جميع حقول "المهام" الأخرى. وإلا فسيتم إرجاع خطأ.

DeliveryRequestHeader

يحتوي حقل RequestHeader على حقول شائعة لجميع طلبات استدعاء إجراء عن بُعد (RPC) للتسليم.

الحقول
language_code	string تمثّل هذه السمة رمز اللغة BCP-47، مثل en-US أو sr-Latn. لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. إذا لم يتم تحديد أي لغة، قد يكون الرد بأي لغة، مع تفضيل اللغة الإنجليزية في حالة وجود مثل هذا الاسم. مثال على قيمة الحقل: en-US
region_code	string مطلوب. رمز CLDR للمنطقة التي صدر فيها الطلب مثال على قيمة الحقل: US
sdk_version	string يشير إلى إصدار حزمة تطوير البرامج (SDK) للاتصال، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، مثال: 1.1.2.
os_version	string يشير إلى إصدار نظام التشغيل الذي يتم تشغيل حزمة تطوير البرامج (SDK) للاتصال عليه. أمثلة على قيم الحقل: 4.4.1 و12.1
device_model	string طراز الجهاز الذي يتم تشغيل حزمة تطوير البرامج (SDK) للاتصال عليه أمثلة على قيم الحقل: iPhone12,1 وSM-G920F
sdk_type	SdkType نوع حزمة SDK التي ترسل الطلب
maps_sdk_version	string تشير هذه السمة إلى إصدار MapSDK الذي تعتمد عليه حزمة SDK للاتصال، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، مثال: 5.2.1.
nav_sdk_version	string يشير إلى إصدار NavSDK الذي تعتمد عليه حزمة تطوير البرامج (SDK) للاتصال، إذا كان ذلك منطبقًا تنسيق الإصدار هو "major.minor.patch"، مثال: 2.1.0.
platform	Platform النظام الأساسي لحزمة تطوير البرامج (SDK) للاتصال
manufacturer	string الشركة المصنّعة لجهاز Android من حزمة تطوير البرامج (SDK) للاتصال، ولا تنطبق إلا على حِزم تطوير البرامج (SDK) لنظام التشغيل Android. مثال على قيمة الحقل: Samsung
android_api_level	int32 مستوى واجهة برمجة تطبيقات Android لحزمة تطوير البرامج (SDK) للاتصال، ولا ينطبق إلا على حِزم تطوير البرامج (SDK) لنظام التشغيل Android. مثال على قيمة الحقل: 23
trace_id	string رقم تعريف اختياري يمكن تقديمه لأغراض التسجيل من أجل تحديد الطلب.

النظام الأساسي

النظام الأساسي لحزمة تطوير البرامج (SDK) للاتصال.

عمليات التعداد
PLATFORM_UNSPECIFIED	القيمة التلقائية. يتم استخدام هذه القيمة في حال إسقاط المنصة.
ANDROID	تم إرسال الطلب من Android.
IOS	تم إرسال الطلب من جهاز iOS.
WEB	تم إرسال الطلب من الويب.

SdkType

الأنواع المحتملة لحِزم SDK.

عمليات التعداد
SDK_TYPE_UNSPECIFIED	القيمة التلقائية. ويتم استخدام هذه القيمة في حال إسقاط sdk_type.
CONSUMER	حزمة SDK للاتصال هي المستهلك.
DRIVER	حزمة SDK للاتصال هي برنامج التشغيل.
JAVASCRIPT	حزمة تطوير البرامج (SDK) للاتصال هي JavaScript.

DeliveryVehicle

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

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

الحقول
name	string الاسم الفريد لمركبة التسليم هذه. التنسيق هو providers/{provider}/deliveryVehicles/{vehicle}.
last_location	DeliveryVehicleLocation آخر موقع جغرافي تم الإبلاغ عنه لمركبة التسليم
navigation_status	DeliveryVehicleNavigationStatus حالة التنقّل الخاصة بمركبة التسليم
current_route_segment	bytes الخطوط المتعددة المشفرة التي تحدد المسار الذي يقترح التنقل اتباعه إلى نقطة الطريق التالية. ويحدِّث تطبيق السائق هذا عند الوصول إلى محطة أو المرور بها وعند تغيير مسار التنقل. يتم عرض 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): لا تتطابق نقطة نهاية current_route_segment مع DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) أو DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST). لم يحدِّث تطبيق السائق موقعه الجغرافي مؤخرًا، لذا قد تكون آخر قيمة تم تعديلها لهذا الحقل قديمة. عدَّل تطبيق السائق موقعه الجغرافي مؤخرًا، لكنّ current_route_segment قديم ويشير إلى محطة سابقة للمركبات. في هذه الحالات، يملأ Fleet Engine هذا الحقل بمسار يمتدّ من آخر نقطة مرور على AutomotiveStop إلى المنصّة التي ستجري التسليم فيها، وذلك للتأكّد من أنّ مستهلك هذا الحقل لديه أفضل المعلومات المتاحة حول المسار الحالي لمركبة التسليم.
current_route_segment_end_point	LatLng الموقع الجغرافي الذي ينتهي فيه current_route_segment. لا تتم تعبئة هذا الحقل حاليًا بواسطة تطبيق السائق، ولكن يمكنك تقديمه في مكالمات UpdateDeliveryVehicle. وهي إما LatLng من محطة المركبات القادمة أو آخر LatLng من current_route_segment. وسيبذل Fleet Engine قصارى جهده لدمج VehicleStop بشكل فعلي. يتم تجاهل هذا الحقل في استدعاءات UpdateDeliveryVehicle إذا كان الحقل current_route_segment فارغًا.
remaining_distance_meters	Int32Value مسافة القيادة المتبقية لـ current_route_segment. يوفر تطبيق 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 إذا كان الحقل current_route_segment فارغًا.
remaining_duration	Duration الوقت المتبقّي لقيادة السيارة "current_route_segment" يوفر تطبيق Driver عادةً هذا الحقل، ولكن هناك بعض الحالات التي يلغي فيها Fleet Engine القيمة التي يرسلها التطبيق. لمزيد من المعلومات، يُرجى الاطّلاع على "DeliveryVehicle.current_route_segment". يتم عرض هذا الحقل بعملة Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) أو Task.remainingVehicleJourneySegments[0].drivingDuration (REST) لجميع المهام النشطة التي تم تعيينها لمركبة التسليم. يتجاهل Fleet Engine هذا الحقل في UpdateDeliveryVehicleRequest إذا كان الحقل current_route_segment فارغًا.
remaining_vehicle_journey_segments[]	VehicleJourneySegment أجزاء الرحلة المخصّصة لمركبة التسليم هذه، بدءًا من آخر موقع جغرافي للمركبة تم الإبلاغ عنه لن تتم تعبئة هذا الحقل في ردّ ListDeliveryVehicles.
attributes[]	DeliveryVehicleAttribute قائمة بسمات التسليم المخصّصة يمكن أن تتضمّن سيارة التسليم 100 سمة كحدّ أقصى، ويجب أن تحتوي كل سمة على مفتاح فريد.
type	DeliveryVehicleType تعرض هذه السمة نوع مركبة التسليم. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على AUTO.

DeliveryVehicleType

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

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

DeliveryVehicleAttribute

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

الحقول
key	string مفتاح السمة.
value	string قيمة السمة.
حقل الاتحاد delivery_vehicle_attribute_value. قيمة السمة، يمكن أن تكون في سلسلة أو قيمة منطقية أو نوع مزدوج. يمكن أن يكون delivery_vehicle_attribute_value واحدًا فقط مما يلي:
string_value	string قيمة السمة المكتوبة بالسلسلة ملاحظة: هذا مماثل للحقل value الذي سيتم إيقافه نهائيًا في النهاية. بالنسبة إلى طرق الإنشاء أو التعديل، يمكن استخدام أي من الحقلَين، ولكن يُنصح بشدة باستخدام string_value. إذا تم ضبط كل من string_value وvalue، يجب أن تكون القيمتان متطابقتَين وإلا سيتم حدوث خطأ. تتم تعبئة كلا الحقلين في الردود.
bool_value	bool قيمة السمة المكتوبة بطريقة منطقية
number_value	double قيمة سمة من نوعين

DeliveryVehicleLocation

الموقع الجغرافي للمركبة وسرعتها وعنوانها في وقت محدّد

الحقول
location	LatLng الموقع الجغرافي للمركبة عند إرسالها إلى Fleet Engine، يكون موقع المركبة هو موقع نظام تحديد المواقع العالمي (GPS). وعند تلقّيه كردّ، يمكن أن يكون الموقع الجغرافي للمركبة إمّا موقعًا جغرافيًا لنظام تحديد المواقع العالمي (GPS) أو موقعًا تكميليًا أو أي موقع جغرافي مقدَّر آخر. تم تحديد المصدر في location_sensor.
horizontal_accuracy (deprecated)	DoubleValue تم إيقاف هذا العنصر نهائيًا. متوقّفة نهائيًا: استخدِم latlng_accuracy بدلاً منها.
latlng_accuracy	DoubleValue دقة location بالأمتار كنصف قطري.
heading	Int32Value اتجاه المركبة التي تتحرك بالدرجات 0 يمثل الشمال. النطاق الصالح هو [0,360).
bearing_accuracy (deprecated)	DoubleValue تم إيقاف هذا العنصر نهائيًا. متوقّفة نهائيًا: استخدِم heading_accuracy بدلاً منها.
heading_accuracy	DoubleValue درجة دقة heading بالدرجات.
altitude	DoubleValue الارتفاع بالأمتار فوق WGS84
vertical_accuracy (deprecated)	DoubleValue تم إيقاف هذا العنصر نهائيًا. متوقّفة نهائيًا: استخدِم altitude_accuracy بدلاً منها.
altitude_accuracy	DoubleValue دقة altitude بالمتر
speed_kmph (deprecated)	Int32Value تم إيقاف هذا العنصر نهائيًا. سرعة المركبة بالكيلومتر في الساعة. متوقّفة نهائيًا: استخدِم speed بدلاً منها.
speed	DoubleValue سرعة المركبة بالمتر/الثانية
speed_accuracy	DoubleValue دقة speed بالمتر/الثانية
update_time	Timestamp الوقت الذي أبلغَت فيه أداة الاستشعار عن location وفقًا لساعة أداة الاستشعار
server_time	Timestamp النتائج فقط. الوقت الذي تلقّى فيه الخادم معلومات الموقع الجغرافي.
location_sensor	DeliveryVehicleLocationSensor موفِّر بيانات الموقع الجغرافي (على سبيل المثال، GPS).
is_road_snapped	BoolValue ما إذا كان قد تم محاذاة location إلى طريق أم لا.
is_gps_sensor_enabled	BoolValue الإدخال فقط. يشير إلى ما إذا كانت أداة استشعار نظام تحديد المواقع العالمي (GPS) مُفعَّلة على الجهاز الجوّال.
time_since_update	Int32Value الإدخال فقط. الوقت (بالثواني) منذ إرسال هذا الموقع لأول مرة إلى الخادم. سيكون هذا صفرًا في أول تحديث. في حال لم يكن الوقت معروفًا (على سبيل المثال، عند إعادة تشغيل التطبيق)، تتم إعادة ضبط هذه القيمة على الصفر.
num_stale_updates (deprecated)	Int32Value تم إيقاف هذا العنصر نهائيًا. الإدخال فقط. متوقّف: يتم الآن استخدام إشارات أخرى لتحديد ما إذا كان الموقع قديمًا أم لا.
raw_location	LatLng الموقع الجغرافي للمركبة الأولي (لا تتم معالجته بواسطة قاذف الطريق)
raw_location_time	Timestamp الطابع الزمني المرتبط بالموقع الجغرافي الأولي
raw_location_sensor	DeliveryVehicleLocationSensor مصدر الموقع الجغرافي الأولي وتكون القيمة التلقائية هي GPS.
raw_location_accuracy	DoubleValue دقة raw_location كنطاق جغرافي، بالمتر
supplemental_location	LatLng الموقع التكميلي الذي يوفره التطبيق المدمج
supplemental_location_time	Timestamp الطابع الزمني المرتبط بالموقع الجغرافي التكميلي
supplemental_location_sensor	DeliveryVehicleLocationSensor مصدر الموقع التكميلي وتكون القيمة التلقائية هي CUSTOMER_SUPPLIED_LOCATION.
supplemental_location_accuracy	DoubleValue دقة supplemental_location كنطاق جغرافي، بالمتر
road_snapped (deprecated)	bool تم إيقاف هذا العنصر نهائيًا. متوقّفة نهائيًا: استخدِم is_road_snapped بدلاً منها.

DeliveryVehicleLocationSensor

أداة الاستشعار أو المنهجية المستخدَمة لتحديد الموقع الجغرافي.

عمليات التعداد
UNKNOWN_SENSOR	أداة الاستشعار غير محدّدة أو غير معروفة.
GPS	نظام تحديد المواقع العالمي (GPS) أو نظام تحديد المواقع العالمي (GPS) المدعوم.
NETWORK	نظام GPS مدعوم أو معرف برج الاتصالات أو نقطة وصول Wi-Fi.
PASSIVE	معرّف برج الاتصالات أو نقطة وصول WiFi.
ROAD_SNAPPED_LOCATION_PROVIDER	موقع يحدده الجهاز الجوّال ليكون موقع الطريق الأكثر احتمالاً.
CUSTOMER_SUPPLIED_LOCATION	موقع جغرافي يوفّره العميل من مصدر مستقل. يتم عادةً استخدام هذه القيمة للموقع الجغرافي الذي يتم تقديمه من مصادر أخرى غير الجهاز الجوّال الذي يشغل حزمة SDK لبرنامج التشغيل. إذا تم وصف المصدر الأصلي بإحدى قيم التعداد الأخرى، استخدِم تلك القيمة. يتم عادةً توفير المواقع الجغرافية التي تم وضع علامة CUSTOMER_SUPPLIED_LOCATION عليها عبر last_location.supplemental_location_sensor الخاصة بـ DeliveryVehicle.
FLEET_ENGINE_LOCATION	موقع جغرافي احتسبه Fleet Engine استنادًا إلى الإشارات المتاحة له. النتائج فقط. سيتم رفض هذه القيمة في حال تلقّيها في طلب.
FUSED_LOCATION_PROVIDER	مزوّد الموقع الجغرافي المدمج في Android
CORE_LOCATION	مقدم الموقع على أنظمة التشغيل Apple.

DeliveryVehicleNavigationStatus

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

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

GetDeliveryVehicleRequest

رسالة طلب GetDeliveryVehicle.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
name	string مطلوب. يجب أن يكون بالتنسيق providers/{provider}/deliveryVehicles/{delivery_vehicle}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project

GetTaskRequest

رسالة طلب GetTask.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
name	string مطلوب. يجب أن يكون بالتنسيق providers/{provider}/tasks/{task}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project

GetTaskTrackingInfoRequest

رسالة طلب GetTaskTrackingInfoRequest.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
name	string مطلوب. يجب أن يكون بالتنسيق providers/{provider}/taskTrackingInfo/{tracking_id}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud، ويجب أن يكون tracking_id هو رقم تعريف التتبّع المرتبط بالمهمة. يمكن أن يكون الاسم providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id كمثال.

ListDeliveryVehiclesRequest

رسالة طلب ListDeliveryVehicles.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
parent	string مطلوب. يجب أن يكون بالتنسيق providers/{provider}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project
page_size	int32 اختياريّ. تمثّل هذه السمة الحدّ الأقصى لعدد المركبات المطلوب إرجاعها. قد تعرض الخدمة عددًا أقل من هذا الرقم. وإذا لم تحدِّد هذا الرقم، سيحدّد الخادم عدد النتائج التي سيتم عرضها.
page_token	string اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "ListDeliveryVehicles". يجب تقديم ذلك لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListDeliveryVehicles مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.
filter	string اختياريّ. عبارة عن طلب بحث للفلترة يتم تطبيقه عند إدراج مركبات التسليم. راجِع http://aip.dev/160 للاطّلاع على أمثلة عن بنية الفلاتر. إذا لم تحدّد قيمة أو إذا حدّدت سلسلة فارغة للفلتر، سيتم إرجاع جميع مركبات التسليم. يُرجى العلم أنّ طلبات البحث المتاحة لـ ListDeliveryVehicles هي فقط تلك المتعلقة بسمات المركبات (على سبيل المثال، attributes.<key> = <value> أو attributes.<key1> = <value1> AND attributes.<key2> = <value2>). ويتم أيضًا تخزين جميع السمات كسلاسل، وبالتالي فإنّ المقارنات الوحيدة المسموح بها مع السمات هي مقارنات السلاسل. للمقارنة مع القيم الرقمية أو المنطقية، يجب اقتباس القيم بشكل صريح ليتم التعامل معها كسلاسل (على سبيل المثال، attributes.<key> = "10" أو attributes.<key> = "true"). الحد الأقصى لعدد القيود المسموح بها في طلب بحث الفلتر هو 50. القيد هو جزء من طلب النموذج attribute.<KEY> <COMPARATOR> <VALUE>، على سبيل المثال attributes.foo = bar هو قيد واحد.
viewport	Viewport اختياريّ. فلتر يحدّ من المركبات التي يتم عرضها على المركبات التي تم عرضها في آخر موقع جغرافي معروف كان ضمن المنطقة المستطيلة التي حدّدها إطار العرض

ListDeliveryVehiclesResponse

رسالة الردّ ListDeliveryVehicles.

الحقول
delivery_vehicles[]	DeliveryVehicle مجموعة مركبات التسليم التي تستوفي معايير الفلترة المطلوبة في حال عدم تحديد فلتر، يعرض الطلب جميع مركبات التسليم. ويمكن أن يكون الرد الناجح فارغًا أيضًا. تشير الردّ الفارغة إلى أنّه لم يتم العثور على أي مركبات توصيل تستوفي معايير الفلترة المطلوبة.
next_page_token	string يمكنك ضبط هذا الرمز المميّز في ListDeliveryVehiclesRequest لمواصلة عرض النتائج. عند عرض جميع النتائج، لن يكون هذا الحقل في الاستجابة أو سيكون سلسلة فارغة.
total_size	int64 إجمالي عدد مركبات التسليم التي تتطابق مع معايير الطلب في جميع الصفحات

ListTasksRequest

رسالة طلب ListTasks.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
parent	string مطلوب. يجب أن يكون بالتنسيق providers/{provider}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project
page_size	int32 اختياريّ. الحد الأقصى لعدد "مهام Google" المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. وإذا لم تحدِّد هذه القيمة، سيحدِّد الخادم عدد النتائج التي سيتم عرضها.
page_token	string اختياريّ. رمز مميّز للصفحة تم تلقّيه من استدعاء ListTasks سابق. ويمكنك توفيره لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListTasks مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.
filter	string اختياريّ. طلب بحث فلتر ليتم تطبيقه عند إدراج "مهام Google". راجِع http://aip.dev/160 للاطّلاع على أمثلة على بنية الفلاتر. إذا لم تحدِّد قيمة أو إذا أجريت فلترة على سلسلة فارغة، سيتم عرض جميع "مهام Google". للحصول على معلومات عن خصائص "مهام Google" التي يمكنك الفلترة وفقًا لها، يُرجى الاطّلاع على سرد المهام.

ListTasksResponse

الردّ ListTasks الذي يتضمّن مجموعة "مهام Google" التي تستوفي معايير الفلتر في ListTasksRequest

الحقول
tasks[]	Task مجموعة من "المهام" التي تستوفي معايير الفلترة المطلوبة. عند عدم تحديد فلتر، يعرض الطلب جميع المهام. ويمكن أن يكون الرد الناجح فارغًا أيضًا. تشير الاستجابة الفارغة إلى عدم العثور على أي "مهام" تستوفي معايير الفلتر المطلوبة.
next_page_token	string عليك تمرير هذا الرمز المميّز في ListTasksRequest للمتابعة إلى قائمة النتائج. إذا تم عرض جميع النتائج، فهذا الحقل سيكون إما سلسلة فارغة أو لا يظهر في الاستجابة.
total_size	int64 إجمالي عدد المهام التي تطابق معايير الطلب في جميع الصفحات.

LocationInfo

موقع جغرافي يتضمن أي معرّفات إضافية.

الحقول
point	LatLng إحداثيات الموقع.

المهمة

تمثل المهمة في واجهة برمجة تطبيقات التسليم إجراءً واحدًا للتتبع. بشكل عام، هناك فرق بين المهام المتعلقة بالشحن ومهام التقسيم. يمكن أن يكون للشحن عدة مهام مرتبطة بها. على سبيل المثال، يمكن أن تكون هناك مهمة واحدة للاستلام وأخرى للتوصيل أو النقل. أيضًا، يمكن التعامل مع المهام المختلفة لشحنة معينة بواسطة مركبات مختلفة. على سبيل المثال، يمكن لمركبة واحدة التعامل مع عملية الاستلام، وتوجيه الشحنة إلى المركز، بينما تقود مركبة أخرى الشحنة نفسها من المركز إلى موقع التسليم.

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

الحقول
name	string يجب أن يكون بالتنسيق providers/{provider}/tasks/{task}.
type	Type مطلوب. غير قابل للتغيير. تحدد نوع المهمة. على سبيل المثال، استراحة أو شحنة.
state	State مطلوب. حالة تنفيذ "المهمة" الحالية.
task_outcome	TaskOutcome نتيجة المهمة.
task_outcome_time	Timestamp الطابع الزمني الذي يشير إلى وقت ضبط نتيجة Task من قِبل الموفّر.
task_outcome_location	LocationInfo الموقع الجغرافي الذي تم فيه ضبط نتيجة Task. يتم تعديل هذه القيمة كجزء من UpdateTask. إذا لم يعدّل مقدّم الخدمة هذه القيمة بشكل صريح، يملأها Fleet Engine تلقائيًا بآخر موقع جغرافي معروف للمركبة (الموقع الجغرافي الأوّلي).
task_outcome_location_source	TaskOutcomeLocationSource يشير إلى مصدر قيمة task_outcome_location.
tracking_id	string غير قابل للتغيير. يسهّل هذا الحقل تخزين المعرف حتى تتمكن من تجنب استخدام تعيين معقد. لا يمكنك ضبط tracking_id للمهام من النوع UNAVAILABLE وSCHEDULED_STOP. تخضع أرقام التعريف هذه للقيود التالية: يجب أن تكون سلسلة Unicode صالحة. لا يتجاوز عدد الأحرف 64 حرفًا كحد أقصى. تمت التسوية وفقًا لنموذج تسوية Unicode C. لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
delivery_vehicle_id	string النتائج فقط. رقم تعريف المركبة التي تنفّذ هذه المهمة. تخضع معرّفات مركبات التسليم للقيود التالية: يجب أن تكون سلسلة Unicode صالحة. لا يتجاوز عدد الأحرف 64 حرفًا كحد أقصى. تمت التسوية وفقًا لنموذج تسوية Unicode C. لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
planned_location	LocationInfo غير قابل للتغيير. الموقع الذي سيتم فيه إكمال المهمّة اختيارية في "مهام UNAVAILABLE"، ولكنها مطلوبة لجميع "مهام Google" الأخرى
task_duration	Duration مطلوب. غير قابل للتغيير. الوقت اللازم لتنفيذ "مهمة" في هذا الموقع
target_time_window	TimeWindow الفترة الزمنية التي يجب أن تكتمل خلالها المهمة.
journey_sharing_info	JourneySharingInfo النتائج فقط. الحقول الخاصة بمشاركة رحلات البحث لا تتم تعبئة هذا الحقل عندما تكون الولاية هي CLOSED.
task_tracking_view_config	TaskTrackingViewConfig تهيئة تتبع المهام التي تحدد عناصر البيانات التي تكون مرئية للمستخدمين النهائيين تحت أي ظروف.
attributes[]	TaskAttribute قائمة بسمات "Task" المخصّصة يجب أن يكون لكل سمة مفتاح فريد.

JourneySharingInfo

مشاركة بيانات حقول معيّنة

الحقول
remaining_vehicle_journey_segments[]	VehicleJourneySegment معلومات التتبع للمحطات التي ستجريها المركبة المخصصة قبل إكمال هذه المهمة. تجدر الإشارة إلى أنّ هذه القائمة يمكن أن تحتوي على نقاط توقف من المهام الأخرى. يحتوي الجزء الأول، Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) أو Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST)، على معلومات المسار من آخر موقع معروف للسائق حتى VehicleStop القادم. يتم عادةً الحصول على معلومات المسار الحالية من تطبيق السائق، باستثناء بعض الحالات المُشار إليها في مستندات "DeliveryVehicle.current_route_segment". تتم تعبئة الأجزاء الأخرى في Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) أو Task.journeySharingInfo.remainingVehicleJourneySegments (REST) من خلال Fleet Engine. وهي توفّر معلومات المسارات بين VehicleStops متبقية.
last_location	DeliveryVehicleLocation يشير إلى آخر موقع تم الإبلاغ عنه للمركبة المخصّصة له.
last_location_snappable	bool يشير هذا الحقل إلى ما إذا كان يمكن تثبيت الموقع الجغرافي الأخير للمركبة على current_route_segment. تكون هذه القيمة False في حال عدم توفّر last_location أو current_route_segment. يتم احتساب هذه القيمة من خلال Fleet Engine. ويتم تجاهل التحديثات من العملاء.

الحالة

حالة المهمة. يشير هذا إلى تقدم المهام.

عمليات التعداد
STATE_UNSPECIFIED	تلقائي: يتم استخدامه لحالة مهمة غير محدّدة أو غير معروفة.
OPEN	يبدو أنّه لم يتم بعد تخصيص المهمة لمركبة تسليم، أو أنّ مركبة التسليم لم تجتَز بعد محطة المركبة المخصّصة لبرنامج "Task".
CLOSED	عند اجتياز المركبة محطة توقف المركبة لتنفيذ هذه المهمة.

TaskOutcome

يشير ذلك المصطلح إلى نتيجة محاولة تنفيذ مهمة. عند إغلاق "TaskState"، تشير القيمة TaskOutcome إلى ما إذا تم إكمالها بنجاح.

عمليات التعداد
TASK_OUTCOME_UNSPECIFIED	نتيجة المهمة قبل تعيين قيمتها.
SUCCEEDED	تمّ إكمال المهمّة بنجاح.
FAILED	تعذَّر إكمال المهمة أو تم إلغاؤها.

TaskOutcomeLocationSource

تشير هذه السمة إلى هوية المصدر الذي ملأ task_outcome_location.

عمليات التعداد
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED	نتيجة المهمة قبل تعيينها.
PROVIDER	حدَّد موفّر الخدمة task_outcome_location.
LAST_VEHICLE_LOCATION	لم يحدّد موفِّر الخدمة task_outcome_location، لذلك استخدم Fleet Engine آخر موقع جغرافي معروف للمركبة.

النوع

نوع المهمة.

عمليات التعداد
TYPE_UNSPECIFIED	نوع المهمة غير معروف بشكل تلقائي.
PICKUP	مهمة الاستلام هي الإجراء الذي يتم اتخاذه لاستلام شحنة من العميل. يجب أن تستخدم عمليات استلام المركبات من المستودعات أو المركبات نوع SCHEDULED_STOP.
DELIVERY	مهمة التسليم هي الإجراء الذي يتم اتخاذه لتسليم شحنة إلى العميل النهائي. يجب أن يستخدم خيار تسليم المركبات من المستودع أو خدمة التغذية النوع SCHEDULED_STOP.
SCHEDULED_STOP	تُستخدم مهمة الإيقاف المجدولة لأغراض التخطيط. على سبيل المثال، يمكن أن تمثل التقاط أو تسليم الشحنات من مركبات الإطعام أو المستودعات. ولا ينبغي استخدامها لأي شحنات يتم استلامها أو تسليمها من عميل نهائي.
UNAVAILABLE	مهمّة تعني أنّ المركبة غير متاحة للصيانة على سبيل المثال، يمكن أن يحدث ذلك عندما يأخذ السائق استراحة أو عندما تتم إعادة إضافة الوقود.

TaskAttribute

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

الحقول
key	string مفتاح السمة. لا يجوز أن تحتوي المفاتيح على علامة النقطتين (:).
حقل الاتحاد task_attribute_value. قيمة السمة، يمكن أن تكون في سلسلة أو قيمة منطقية أو نوع مزدوج. إذا لم يتم ضبط أي سمة، سيتم تخزين قيمة TaskAttribute string_value كسلسلة فارغة "". يمكن أن يكون task_attribute_value واحدًا فقط مما يلي:
string_value	string قيمة السمة المكتوبة بالسلسلة
bool_value	bool قيمة السمة المكتوبة بطريقة منطقية
number_value	double قيمة سمة من نوعين

TaskTrackingInfo

الرسالة "TaskTrackingInfo". تحتوي الرسالة على معلومات تتبع المهام التي سيتم استخدامها للعرض. إذا كان معرّف التتبع مرتبطًا بمهام متعددة، يستخدم Fleet Engine إرشادات لتحديد أي مهمة TaskTrackingInfo لتحديدها.

الحقول
name	string يجب أن يكون بالتنسيق providers/{provider}/taskTrackingInfo/{tracking}، حيث يمثل tracking رقم تعريف التتبع.
tracking_id	string غير قابل للتغيير. رقم تعريف تتبع مهمة. * يجب أن تكون سلسلة Unicode صالحة. * الحد الأقصى للطول: 64 حرفًا. * تمت تسويتها وفقًا لنموذج تسوية Unicode C. * يجب ألا يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
vehicle_location	DeliveryVehicleLocation الموقع الجغرافي الأخير للمركبة
route_polyline_points[]	LatLng قائمة بالنقاط التي عند ربطها تشكل خطوطًا متعددة للمسار المتوقع للمركبة إلى موقع هذه المهمة.
remaining_stop_count	Int32Value يشير إلى عدد مرات التوقف المتبقية للمركبة حتى يتم الوصول إلى إيقاف المهمة، بما في ذلك إيقاف المهمة. على سبيل المثال، إذا كانت المحطة التالية للمركبة هي محطة المهمة، ستكون القيمة 1.
remaining_driving_distance_meters	Int32Value إجمالي المسافة المتبقية بالمتر إلى VehicleStop موضع الاهتمام.
estimated_arrival_time	Timestamp الطابع الزمني الذي يشير إلى وقت الوصول المقدّر إلى موقع المحطة الجغرافي
estimated_task_completion_time	Timestamp الطابع الزمني الذي يشير إلى الوقت المقدّر لإكمال مهمة
state	State حالة تنفيذ "المهمة" الحالية.
task_outcome	TaskOutcome يشير ذلك المصطلح إلى نتيجة محاولة تنفيذ مهمة.
task_outcome_time	Timestamp الطابع الزمني الذي يشير إلى وقت ضبط نتيجة المهمة من قِبل الموفّر
planned_location	LocationInfo غير قابل للتغيير. الموقع الذي سيتم فيه إكمال المهمّة
target_time_window	TimeWindow الفترة الزمنية التي يجب أن تكتمل خلالها المهمة.
attributes[]	TaskAttribute السمات المخصصة التي تم تعيينها على المهمة.

TaskTrackingViewConfig

هي رسالة الضبط التي تحدِّد متى يجب أن يظهر عنصر البيانات للمهمة للمستخدمين النهائيين.

الحقول
route_polyline_points_visibility	VisibilityOption الحقل الذي يحدد متى يمكن أن تكون النقاط المتعددة الخطوط للمسار مرئية. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
estimated_arrival_time_visibility	VisibilityOption الحقل الذي يحدّد الوقت المقدّر للوصول مرئيًا. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
estimated_task_completion_time_visibility	VisibilityOption الحقل الذي يحدد الوقت المقدّر لإكمال المهمة في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
remaining_driving_distance_visibility	VisibilityOption الحقل الذي يحدد متى يمكن إظهار المسافة المتبقية بالسيارة. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
remaining_stop_count_visibility	VisibilityOption الحقل الذي يحدد عدد مرات التوقّف المتبقية ويظهر فيه. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.
vehicle_location_visibility	VisibilityOption الحقل الذي يحدّد الحالات التي يمكن فيها رؤية الموقع الجغرافي للمركبة في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.

VisibilityOption

رسالة الخيار التي تحدِّد متى يجب أن يكون عنصر البيانات مرئيًا للمستخدمين النهائيين.

الحقول
حقل الاتحاد visibility_option. خيار مستوى الرؤية المحدّد الذي تم اختياره. يمكن أن يكون visibility_option واحدًا فقط مما يلي:
remaining_stop_count_threshold	int32 يكون عنصر البيانات هذا مرئيًا للمستخدمين إذا كان عدد المحطات المتبقية <= still_stop_count_threshold.
duration_until_estimated_arrival_time_threshold	Duration يكون عنصر البيانات هذا مرئيًا للمستخدمين إذا كان الوقت المقدّر للوصول إلى المحطة <= duration_until_estimated_arrival_time_threshold.
remaining_driving_distance_meters_threshold	int32 يكون عنصر البيانات هذا مرئيًا للمستخدمين إذا كانت مسافة القيادة المتبقية بالأمتار <= still_driving_distance_meters_threshold.
always	bool في حال ضبط عنصر البيانات هذا على "صحيح"، سيظهر دائمًا للمستخدمين النهائيين بدون حدود. لا يمكن ضبط هذا الحقل على "خطأ".
never	bool إذا تم ضبط هذه السياسة على "صحيح"، يتم دائمًا إخفاء عنصر البيانات هذا عن المستخدمين النهائيين بدون أي حدود. لا يمكن ضبط هذا الحقل على "خطأ".

TimeWindow

نطاق زمني

الحقول
start_time	Timestamp مطلوب. وقت بدء الفترة الزمنية (شاملةً).
end_time	Timestamp مطلوب. وقت انتهاء الفترة الزمنية (شاملةً).

UpdateDeliveryVehicleRequest

رسالة طلب UpdateDeliveryVehicle.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
delivery_vehicle	DeliveryVehicle مطلوب. تعديل الكيان DeliveryVehicle المطلوب تطبيقه. ملاحظة: لا يمكنك تحديث اسم DeliveryVehicle.
update_mask	FieldMask مطلوب. قناع حقل يشير إلى الحقول DeliveryVehicle المطلوب تعديلها. ملاحظة: يجب أن يحتوي قناع update_mask على حقل واحد على الأقل. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "remaining_vehicle_journey_segments"

UpdateTaskRequest

رسالة طلب UpdateTask.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان طلب Standard Delivery API
task	Task مطلوب. المهمة المرتبطة بالتحديث. تحتفظ Fleet Engine بالحقول التالية. ويُرجى عدم تعديلها باستخدام Task.update. last_location. last_location_snappable. name. remaining_vehicle_journey_segments. task_outcome_location_source. ملاحظة: لا يمكنك تغيير قيمة task_outcome بعد ضبطها. إذا تم إسناد المهمة إلى مركبة تسليم، لا تضبط حالة المهمة على "مغلقة" باستخدام Task.update. بدلاً من ذلك، يمكنك إزالة VehicleStop التي تحتوي على المهمة من مركبة التسليم، التي تضبط حالة المهمة تلقائيًا على "مغلقة".
update_mask	FieldMask مطلوب. قناع الحقل الذي يشير إلى حقول "المهام" المطلوب تعديلها. ملاحظة: يجب أن يحتوي update_mask على حقل واحد على الأقل. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "task_outcome,task_outcome_time,task_outcome_location"

VehicleJourneySegment

تمثّل هذه السمة فئة التنقّل الخاصة بمركبة، من محطتها السابقة إلى المحطة الحالية. إذا كانت هذه هي أول محطة نشطة، تكون عندئذٍ من الموقع الجغرافي الحالي للمركبة إلى هذه المحطة.

الحقول
stop	VehicleStop تُحدِّد موقع المحطة، إلى جانب Task المرتبطة بالمحطة. قد لا تكون بعض حقول AutomotiveStop إذا كان جزء الرحلة هذا جزءًا من JourneySharingInfo.
driving_distance_meters	Int32Value النتائج فقط. مسافة السفر من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة أجزاء الرحلة، تكون نقطة البداية هي موقع المركبة الذي تم تسجيله عند إضافة هذه المحطة إلى القائمة. قد لا يتوفّر هذا الحقل إذا كان جزء الرحلة هذا جزءًا من JourneySharingInfo.
driving_duration	Duration النتائج فقط. مدة الرحلة من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة أجزاء الرحلة، تكون نقطة البداية هي موقع المركبة الذي تم تسجيله في وقت إضافة هذه المحطة إلى القائمة. إذا تمّ تحديد هذا الحقل في المسار Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) أو Task.remainingVehicleJourneySegments[0].drivingDuration (REST)، قد تتم تعبئته بالقيمة من DeliveryVehicle.remaining_duration (gRPC) أو DeliveryVehicle.remainingDuration (REST). يوفّر ذلك مدة القيادة المتبقية من آخر موقع جغرافي معروف لتطبيق السائق بدلاً من وقت القيادة من المحطة السابقة.
path[]	LatLng النتائج فقط. المسار من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة أجزاء الرحلة، يكون هذا هو المسار من الموقع الجغرافي الحالي للمركبة إلى هذه المحطة عند إضافة المحطة إلى القائمة. قد لا يتوفّر هذا الحقل إذا كان جزء الرحلة هذا جزءًا من JourneySharingInfo. إذا تم تحديد هذا الحقل في المسار Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) أو Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST)، قد تتم ملؤه بـ LatLng التي تم فك ترميزها من DeliveryVehicle.current_route_segment (gRPC) أو DeliveryVehicle.currentRouteSegment (REST). يوفّر هذا المسار مسار القيادة من أحدث موقع جغرافي معروف لتطبيق السائق بدلاً من المسار من المحطة السابقة.

VehicleStop

تشير هذه السمة إلى نقطة توقّف فيها مركبة لإجراء ثانية واحدة أو أكثر من Task.

الحقول
planned_location	LocationInfo مطلوب. تمثّل هذه السمة موقع المحطة. تجدر الإشارة إلى أن المواقع الجغرافية في Task قد لا تتطابق تمامًا مع هذا الموقع الجغرافي، ولكنها ستكون ضمن مسافة قصيرة منه. لن تتم تعبئة هذا الحقل في الردّ على مكالمة GetTask.
tasks[]	TaskInfo قائمة Task التي سيتم إجراؤها في هذه المحطة لن تتم تعبئة هذا الحقل في الردّ على مكالمة GetTask.
state	State حالة VehicleStop. لن تتم تعبئة هذا الحقل في الردّ على مكالمة GetTask.

الحالة

الحالة الحالية لـ VehicleStop

عمليات التعداد
STATE_UNSPECIFIED	غير معروف.
NEW	تم الإنشاء، ولكن لا يتم التوجيه بشكل نشط.
ENROUTE	تم تعيينه والتوجيه النشط.
ARRIVED	وصلت إلى المحطة. يفترض أنه عندما يتم توجيه المركبة إلى المحطة التالية، أن جميع المحطات السابقة قد اكتملت.

TaskInfo

معلومات إضافية حول المهمة التي تم تنفيذها في هذه المحطة.

الحقول
task_id	string معرّف المهمة. لن تتم تعبئة هذا الحقل في الردّ على مكالمة GetTask. تخضع معرّفات المهام للقيود التالية: يجب أن تكون سلسلة Unicode صالحة. لا يتجاوز عدد الأحرف 64 حرفًا كحد أقصى. تمت التسوية وفقًا لنموذج تسوية Unicode C. لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
task_duration	Duration النتائج فقط. تمثّل هذه السمة الوقت اللازم لتنفيذ المهمّة.
target_time_window	TimeWindow النتائج فقط. الفترة الزمنية التي يجب أن تكتمل خلالها المهمة. لم يتم ضبط ذلك إلا في الردّ على GetDeliveryVehicle.