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 (رسالة)
• SearchTasksRequest (رسالة) (متوقّفة نهائيًا)
• SearchTasksResponse (رسالة) (متوقّفة نهائيًا)
• 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 التي تستوفي معايير الفلترة المحدّدة.

SearchTasks
تم إيقاف هذا العنصر نهائيًا. rpc SearchTasks(SearchTasksRequest) returns (SearchTasksResponse) مهملة: يمكنك استخدام GetTaskTrackingInfo بدلاً منها.

UpdateDeliveryVehicle

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

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

BatchCreateTasksRequest

رسالة الطلب BatchCreateTask.

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

BatchCreateTasksResponse

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

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

CreateDeliveryVehicleRequest

رسالة الطلب CreateDeliveryVehicle.

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

CreateTaskRequest

رسالة الطلب CreateTask.

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

DeliveryRequestHeader

يحتوي عنوان الطلب على حقول شائعة لكل طلبات استدعاء إجراء عن بُعد (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) للاتصال هي Driver.
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. عادةً ما يوفّر تطبيق Drive هذا الحقل، ولكن هناك بعض الحالات التي يلغي فيها 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 إذا كان الحقل current_route_segment فارغًا.
remaining_duration	Duration الوقت المتبقّي للقيادة في current_route_segment. عادةً ما يوفّر تطبيق Drive هذا الحقل، ولكن هناك بعض الحالات التي يلغي فيها 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) أو نظام تحديد المواقع العالمي المساعد.
NETWORK	المساعدة في تحديد المواقع العالمي (GPS) أو معرّف برج الاتصالات أو نقطة وصول WiFi
PASSIVE	رقم تعريف برج الهاتف أو نقطة وصول WiFi
ROAD_SNAPPED_LOCATION_PROVIDER	موقع جغرافي يحدّده الجهاز الجوّال ليكون الموضع الأكثر احتمالاً للطريق.
CUSTOMER_SUPPLIED_LOCATION	موقع يوفّره العميل من مصدر مستقل. عادةً ما يتم استخدام هذه القيمة لموقع جغرافي تم تقديمه من مصادر أخرى غير الجهاز الجوّال الذي يُشغِّل Driver 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 اختياريّ. عنوان الطلب العادي في Delivery API.
name	string مطلوبة. يجب استخدام التنسيق providers/{provider}/deliveryVehicles/{delivery_vehicle}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project

GetTaskRequest

رسالة الطلب GetTask.

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

GetTaskTrackingInfoRequest

رسالة الطلب GetTaskTrackingInfoRequest.

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

ListTasksResponse

استجابة ListTasks التي تحتوي على مجموعة "المهام" التي تستوفي معايير الفلاتر في ListTasksRequest.

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

LocationInfo

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

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

SearchTasksRequest

تم إيقاف هذا العنصر نهائيًا.

مهملة: إصدار GetTaskTrackingInfoRequest لـ "GetTaskTrackingInfo" بدلاً من ذلك.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان الطلب العادي في Delivery API.
parent	string مطلوبة. يجب استخدام التنسيق providers/{provider}. يجب أن يكون موفِّر الخدمة هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project
tracking_id	string مطلوبة. معرِّف مجموعة "مهام Google" ذات الصلة المطلوبة. تخضع أرقام تعريف التتبّع للقيود التالية: يجب أن تكون سلسلة Unicode صالحة. تقتصر على 64 حرفًا كحد أقصى. تتم تسويتها وفقًا لنموذج تسوية Unicode. لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
page_size	int32 اختياريّ. الحد الأقصى لعدد المهام المطلوب عرضها. وقد تعرِض الخدمة قيمة أقل من هذه القيمة. وإذا لم تحدّد هذه القيمة، سيحدِّد الخادم عدد النتائج التي سيتم عرضها.
page_token	string اختياريّ. رمز مميز للصفحة تم استلامه من مكالمة سابقة مع "SearchTasks". يجب توفير هذه القيمة لاسترداد الصفحة اللاحقة. عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدّمة إلى SearchTasks مع الطلب الذي وفّر الرمز المميّز للصفحة.

SearchTasksResponse

تم إيقاف هذا العنصر نهائيًا.

الردّ SearchTasks. يحتوي على مجموعة من المهام التي تستوفي معايير البحث في SearchTasksRequest.

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

مهمة

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

ملاحظة: تستخدم واجهات برمجة التطبيقات 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. لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
delivery_vehicle_id	string النتائج فقط. رقم تعريف المركبة التي تنفّذ هذه المهمة. تخضع معرّفات مركبات التسليم للقيود التالية: يجب أن تكون سلسلة Unicode صالحة. تقتصر على 64 حرفًا كحد أقصى. تتم تسويتها وفقًا لنموذج تسوية Unicode. لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
planned_location	LocationInfo غير قابل للتغيير. الموقع الذي سيتم إنجاز المهمة فيه اختيارية في مهام UNAVAILABLE، ولكنها مطلوبة لجميع المهام الأخرى.
task_duration	Duration مطلوبة. غير قابل للتغيير. الوقت اللازم لتنفيذ مهمة في هذا الموقع الجغرافي.
target_time_window	TimeWindow الفترة الزمنية التي يجب إكمال المهمة خلالها.
journey_sharing_info	JourneySharingInfo النتائج فقط. الحقول الخاصة بمشاركة رحلات البحث. لا تتم تعبئة هذا الحقل عندما تكون الولاية CLOSED.
task_tracking_view_config	TaskTrackingViewConfig إعداد تتبُّع المهام الذي يحدِّد عناصر البيانات التي ستظهر للمستخدمين النهائيين وتحت أي ظروف.
attributes[]	TaskAttribute قائمة بسمات المهام المخصّصة يجب أن يكون لكل سمة مفتاح فريد.

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". وتكون هذه القيمة "خطأ" في حال عدم توفّر 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 يمكن أن تكون قيمة السمة في سلسلة أو قيمة منطقية أو نوع مزدوج. في حال عدم ضبط أي قيمة، سيتم تخزين قيمة string_value في TaskAttribute كسلسلة فارغة "". يمكن أن تكون 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. * لا يجوز أن يحتوي على أي من أحرف 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 ويكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين في حال كان عدد المحطات المتبقية <= العثور على هذه البيانات على ما يرام.
duration_until_estimated_arrival_time_threshold	Duration يكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين إذا كان الوقت المقدّر للوصول (ETA) حتى التوقف <= duration_untill_ العمليات المقدَّرة_arrival_time_threshold.
remaining_driving_distance_meters_threshold	int32 ويكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين إذا كانت مسافة القيادة المتبقية بالمتر <= الوقت المتبقي_driving_distance_meters_threshold.
always	bool أمّا في حال ضبطها على "صحيح"، فسيظهر عنصر البيانات هذا دائمًا للمستخدمين النهائيين بدون حدود. لا يمكن ضبط هذا الحقل على "خطأ".
never	bool في حال ضبط هذه السياسة على "صحيح"، يتم دائمًا إخفاء عنصر البيانات هذا عن المستخدمين النهائيين بدون أي حدود. لا يمكن ضبط هذا الحقل على "خطأ".

TimeWindow

نطاق زمني

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

UpdateDeliveryVehicleRequest

رسالة الطلب UpdateDeliveryVehicle.

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

UpdateTaskRequest

رسالة الطلب UpdateTask.

الحقول
header	DeliveryRequestHeader اختياريّ. عنوان الطلب العادي في 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 المرتبطة بالمحطة. قد لا تتوفّر بعض حقول CompanyStop إذا كان جزء الرحلة هذا جزءًا من "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 أو SearchTasks.
tasks[]	TaskInfo قائمة Task التي سيتم إجراؤها عند هذه المحطة. لن يتم ملء هذا الحقل استجابةً لمكالمة GetTask أو SearchTasks.
state	State تمثّل هذه السمة حالة VehicleStop. لن تتم تعبئة هذا الحقل استجابةً لمكالمة GetTask أو SearchTasks.

الحالة

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

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

TaskInfo

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

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