الفهرس
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 |
---|
تنشئ هذه الدالة مجموعة من عناصر |
CreateDeliveryVehicle |
---|
تنشئ |
CreateTask |
---|
ينشئ عنصر |
GetDeliveryVehicle |
---|
لعرض مثيل |
GetTask |
---|
الحصول على معلومات عن |
GetTaskTrackingInfo |
---|
لعرض مثيل |
ListDeliveryVehicles |
---|
الحصول على جميع |
ListTasks |
---|
الحصول على جميع |
UpdateDeliveryVehicle |
---|
لكتابة بيانات |
UpdateTask |
---|
لتعديل بيانات " |
BatchCreateTasksRequest
رسالة الطلب BatchCreateTask
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. ملاحظة: في حال ضبط هذا الحقل، يجب أن يكون حقل العنوان في رسائل |
parent |
مطلوبة. تمثّل هذه السمة المورد الرئيسي الذي تتم مشاركته من خلال جميع المهام. يجب أن تكون هذه القيمة بالتنسيق |
requests[] |
مطلوبة. رسالة الطلب التي تحدّد الموارد المطلوب إنشاؤها. ملاحظة: يمكنك إنشاء 500 مهمة كحد أقصى في دُفعة واحدة. |
BatchCreateTasksResponse
رسالة الردّ BatchCreateTask
.
الحقول | |
---|---|
tasks[] |
المهام التي تم إنشاؤها |
CreateDeliveryVehicleRequest
رسالة الطلب CreateDeliveryVehicle
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
parent |
مطلوبة. يجب استخدام التنسيق |
delivery_vehicle_id |
مطلوبة. يجب أن يكون رقم تعريف مركبة التسليم فريدًا وخاضعًا للقيود التالية:
|
delivery_vehicle |
مطلوبة. الكيان
ملاحظة: يتم تجاهل الحقل |
CreateTaskRequest
رسالة الطلب CreateTask
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
parent |
مطلوبة. يجب استخدام التنسيق |
task_id |
مطلوبة. يجب أن يكون معرّف المهمة فريدًا، ولكن يجب ألا يكون رقم تعريف تتبُّع الشحنة. لتخزين رقم تعريف تتبُّع الشحنة، استخدِم الحقل
|
task |
مطلوبة. تمثّل هذه السمة كيان المهمة المطلوب إنشاؤه. عند إنشاء مهمة، تكون الحقول التالية مطلوبة:
ملاحظة: يتم تجاهل الحقل |
DeliveryRequestHeader
يحتوي عنوان الطلب على حقول شائعة لكل طلبات استدعاء إجراء عن بُعد (RPC) للتسليم.
الحقول | |
---|---|
language_code |
رمز اللغة BCP-47، مثل en-US أو sr-Latn لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. إذا لم يتم تحديد أي شيء، يمكن أن يكون الرد بأي لغة، مع تفضيل اللغة الإنجليزية في حالة وجود مثل هذا الاسم. مثال على قيمة الحقل: |
region_code |
مطلوبة. رمز CLDR للمنطقة التي نشأ فيها الطلب مثال على قيمة الحقل: |
sdk_version |
تمثّل هذه السمة إصدار حزمة تطوير البرامج (SDK) للمكالمات، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، على سبيل المثال: |
os_version |
يشير إلى إصدار نظام التشغيل الذي تعمل عليه حزمة تطوير البرامج (SDK) للمكالمات. أمثلة على قيمة الحقول: |
device_model |
طراز الجهاز الذي تعمل عليه حزمة تطوير البرامج (SDK) للاتصال أمثلة على قيمة الحقول: |
sdk_type |
نوع حزمة تطوير البرامج (SDK) التي ترسل الطلب. |
maps_sdk_version |
تمثّل هذه السمة إصدار من MapSDK الذي تعتمد عليه حزمة SDK للاتصال، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، على سبيل المثال: |
nav_sdk_version |
تمثّل هذه السمة إصدار NavSDK الذي تعتمد عليه حزمة SDK للاتصال، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، على سبيل المثال: |
platform |
النظام الأساسي لحزمة تطوير البرامج (SDK) للمكالمات |
manufacturer |
الشركة المصنّعة لجهاز Android من حزمة تطوير البرامج (SDK) للاتصال، ولا تسري إلا على حِزم تطوير البرامج (SDK) لنظام التشغيل Android. مثال على قيمة الحقل: |
android_api_level |
مستوى واجهة برمجة تطبيقات Android لحزمة تطوير البرامج (SDK) للاتصال، ولا ينطبق إلا على حِزم تطوير البرامج (SDK) لنظام التشغيل Android. مثال على قيمة الحقل: |
trace_id |
معرّف اختياري يمكن تقديمه لأغراض التسجيل من أجل تحديد الطلب. |
النظام الأساسي
النظام الأساسي لحزمة تطوير البرامج (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 |
الاسم الفريد لمركبة التوصيل هذه. التنسيق هو |
last_location |
آخر موقع جغرافي تم الإبلاغ عنه لمركبة التسليم |
navigation_status |
حالة التنقّل في مركبة التسليم. |
current_route_segment |
الخط المتعدد المشفر الذي يحدد المسار الذي يوصي التنقل بالانتقال إلى نقطة الطريق التالية. يعدِّل تطبيق السائق هذا الحدث عند الوصول إلى محطة معيّنة أو تجاوزها، وعند تغيير مسار التنقّل. يتم عرض هناك بعض الحالات التي قد لا يتم فيها استخدام هذا الحقل لتعبئة
في هذه الحالات، يملأ Fleet Engine هذا الحقل بمسار من أقرب مركبة فيديو تم تمريرها إلى نظام AutomotiveStop. |
current_route_segment_end_point |
الموقع الجغرافي الذي ينتهي فيه سمة يتم تجاهل هذا الحقل في طلبات |
remaining_distance_meters |
مسافة القيادة المتبقية للمسافة يتجاهل Fleet Engine هذا الحقل في |
remaining_duration |
الوقت المتبقّي للقيادة في يتجاهل Fleet Engine هذا الحقل في |
remaining_vehicle_journey_segments[] |
أقسام الرحلة المخصّصة لمركبة التسليم هذه، بدءًا من أحدث موقع جغرافي تم الإبلاغ عنه للمركبة لن تتم تعبئة هذا الحقل كردّ على |
attributes[] |
قائمة بسمات مركبات التوصيل المخصّصة يمكن أن تحتوي مركبة التوصيل على 100 سمة كحدّ أقصى، ويجب أن يكون لكل سمة مفتاح فريد. |
type |
تمثّل هذه السمة نوع مركبة التسليم هذه. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على |
DeliveryVehicleType
تمثّل هذه السمة نوع مركبة التسليم.
عمليات التعداد | |
---|---|
DELIVERY_VEHICLE_TYPE_UNSPECIFIED |
القيمة غير مستخدمة. |
AUTO |
سيارة. |
TWO_WHEELER |
دراجة نارية أو دراجة نارية أو أي مركبة أخرى ذات عجلتين |
BICYCLE |
وسائل النقل التي يشغّلها الإنسان |
PEDESTRIAN |
ناقل بشري، عادةً ما يمشي أو يركض، يتنقل على طول مسارات المشاة. |
DeliveryVehicleAttribute
لوصف سمة مركبة بأنّها زوج المفتاح/القيمة لا يمكن أن يتجاوز طول السلسلة "key:value" 256 حرفًا.
الحقول | |
---|---|
key |
مفتاح السمة. |
value |
تمثّل هذه السمة قيمة السمة. |
حقل الاتحاد delivery_vehicle_attribute_value يمكن أن تكون قيمة السمة في سلسلة أو قيمة منطقية أو نوع مزدوج. يمكن أن يكون الحقل "delivery_vehicle_attribute_value " واحدًا فقط مما يلي: |
|
string_value |
قيمة السمة المكتوبة بسلسلة ملاحظة: يتطابق هذا تمامًا مع الحقل |
bool_value |
قيمة سمة مكتوبة من الناحية المنطقية |
number_value |
قيمة سمة مكتوبة بنمط مزدوج. |
DeliveryVehicleLocation
تشير هذه السمة إلى موقع المركبة وسرعتها وتوجيهها في وقت محدّد.
الحقول | |
---|---|
location |
الموقع الجغرافي للمركبة عند إرسال المركبة إلى Fleet Engine، يتم تحديد موقع المركبة كموقع جغرافي بنظام تحديد المواقع العالمي (GPS). عندما تتلقى ردًا منا في رد، قد يكون الموقع الجغرافي للمركبة إما موقعًا جغرافيًا بنظام تحديد المواقع العالمي (GPS) أو موقعًا تكميليًا أو موقعًا جغرافيًا آخر مقدَّرًا. تم تحديد المصدر في |
horizontal_accuracy |
مهملة: يمكنك استخدام |
latlng_accuracy |
دقة |
heading |
اتجاه المركبة تتحرك بالدرجات. 0 يمثل الشمال. النطاق الصالح هو [0,360). |
bearing_accuracy |
مهملة: يمكنك استخدام |
heading_accuracy |
دقة |
altitude |
الارتفاع بالمتر فوق WGS84 |
vertical_accuracy |
مهملة: يمكنك استخدام |
altitude_accuracy |
تبلغ دقة |
speed_kmph |
سرعة المركبة بالكيلومتر في الساعة. مهملة: يمكنك استخدام |
speed |
سرعة المركبة بالمتر/الثانية |
speed_accuracy |
دقة |
update_time |
الوقت الذي أبلغَت فيه أداة الاستشعار عن |
server_time |
النتائج فقط. الوقت الذي تلقّى فيه الخادم معلومات الموقع الجغرافي. |
location_sensor |
مقدِّم بيانات الموقع الجغرافي (مثل |
is_road_snapped |
ما إذا كان " |
is_gps_sensor_enabled |
الإدخال فقط. يشير إلى ما إذا كان جهاز استشعار نظام تحديد المواقع العالمي (GPS) مفعَّلاً على الجهاز الجوّال. |
time_since_update |
الإدخال فقط. الوقت (بالثواني) منذ إرسال هذا الموقع إلى الخادم لأول مرة. وستكون هذه القيمة صفرًا عند إجراء التعديل الأول. وإذا كان الوقت غير معروف (على سبيل المثال، عند إعادة تشغيل التطبيق)، ستتم إعادة ضبط هذه القيمة على صفر. |
num_stale_updates |
الإدخال فقط. مهملة: يتم الآن استخدام إشارات أخرى لتحديد ما إذا كان أحد المواقع قديمًا أم لا. |
raw_location |
الموقع الجغرافي للمركبة غير المعدّلة (لا تتم معالجته من خلال أداة التقاط صور على الطريق) |
raw_location_time |
طابع زمني مرتبط بالموقع الجغرافي الأولي |
raw_location_sensor |
مصدر الموقع الأولي. وتكون الإعدادات التلقائية |
raw_location_accuracy |
دقة |
supplemental_location |
موقع جغرافي تكميلي يوفّره تطبيق الدمج. |
supplemental_location_time |
طابع زمني مرتبط بالموقع الجغرافي التكميلي |
supplemental_location_sensor |
مصدر الموقع التكميلي. وتكون الإعدادات التلقائية |
supplemental_location_accuracy |
دقة |
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. |
GetDeliveryVehicleRequest
رسالة الطلب GetDeliveryVehicle
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
name |
مطلوبة. يجب استخدام التنسيق |
GetTaskRequest
رسالة الطلب GetTask
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
name |
مطلوبة. يجب استخدام التنسيق |
GetTaskTrackingInfoRequest
رسالة الطلب GetTaskTrackingInfoRequest
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
name |
مطلوبة. يجب استخدام التنسيق |
ListDeliveryVehiclesRequest
رسالة الطلب ListDeliveryVehicles
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
parent |
مطلوبة. يجب استخدام التنسيق |
page_size |
اختياريّ. تمثّل هذه السمة الحدّ الأقصى لعدد المركبات المطلوب إرجاعها. قد تعرِض الخدمة أقلّ من هذا الرقم. وإذا لم تحدّد هذا الرقم، سيحدِّد الخادم عدد النتائج التي سيتم عرضها. |
page_token |
اختياريّ. رمز مميز للصفحة تم استلامه من مكالمة سابقة مع " عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدّمة إلى |
filter |
اختياريّ. استعلام فلتر ليتم تطبيقه عند إدراج مركبات التسليم. راجِع http://aip.dev/160 للحصول على أمثلة على بنية الفلتر. في حال عدم تحديد قيمة أو تحديد سلسلة فارغة للفلتر، يتم عرض جميع مركبات التسليم. يُرجى العلم أنّ طلبات البحث الوحيدة المتوافقة مع يبلغ الحد الأقصى لعدد القيود المسموح بها في طلب بحث الفلتر 50. التقييد هو جزء من طلب البحث بالنموذج |
viewport |
اختياريّ. يشير ذلك المصطلح إلى فلتر يحدّ من المركبات التي يتم عرضها لمركبات أخرى كان آخر موقع جغرافي معروف لها في المنطقة المستطيلة التي حدّدها إطار العرض. |
ListDeliveryVehiclesResponse
رسالة الردّ ListDeliveryVehicles
.
الحقول | |
---|---|
delivery_vehicles[] |
مجموعة مركبات التسليم التي تستوفي معايير التصفية المطلوبة. في حال عدم تحديد أي فلتر، يعرض الطلب جميع مركبات التسليم. ويمكن أن تكون الاستجابة الناجحة فارغة أيضًا. يشير الرد الفارغ إلى أنّه لم يتم العثور على مركبات توصيل تستوفي معايير الفلترة المطلوبة. |
next_page_token |
يمكنك ضبط هذا الرمز المميّز في " |
total_size |
إجمالي عدد مركبات التوصيل التي تتطابق مع معايير الطلب على جميع الصفحات |
ListTasksRequest
رسالة الطلب ListTasks
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
parent |
مطلوبة. يجب استخدام التنسيق |
page_size |
اختياريّ. الحد الأقصى لعدد المهام المطلوب عرضها. وقد تعرِض الخدمة قيمة أقل من هذه القيمة. وإذا لم تحدّد هذه القيمة، سيحدِّد الخادم عدد النتائج التي سيتم عرضها. |
page_token |
اختياريّ. رمز مميز للصفحة تم تلقّيه من مكالمة سابقة لتطبيق عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدّمة إلى |
filter |
اختياريّ. استعلام فلتر ليتم تطبيقه عند إدراج "مهام Google". راجِع http://aip.dev/160 للحصول على أمثلة على بنية الفلتر. إذا لم تحدّد قيمة أو في حال الفلترة على سلسلة فارغة، سيتم عرض جميع "المهام". للحصول على معلومات عن خصائص "المهام" التي يمكنك الفلترة وفقًا لها، راجِع إدراج المهام. |
ListTasksResponse
استجابة ListTasks
التي تحتوي على مجموعة "المهام" التي تستوفي معايير الفلاتر في ListTasksRequest
.
الحقول | |
---|---|
tasks[] |
مجموعة المهام التي تستوفي معايير الفلترة المطلوبة. عندما لا يتم تحديد عامل تصفية، يعرض الطلب جميع المهام. ويمكن أن تكون الاستجابة الناجحة فارغة أيضًا. يشير الردّ الفارغ إلى أنّه لم يتم العثور على أي مهام تستوفي معايير الفلترة المطلوبة. |
next_page_token |
مرِّر هذا الرمز المميّز في " |
total_size |
إجمالي عدد المهام التي تطابق معايير الطلب على جميع الصفحات. |
LocationInfo
موقع جغرافي يتضمن أي معرّفات إضافية.
الحقول | |
---|---|
point |
إحداثيات الموقع |
مهمة
تمثل المهمة في واجهة برمجة تطبيقات التسليم إجراءً واحدًا يجب تتبعه. بشكل عام، هناك فرق بين المهام المتعلقة بالشحن وتعطل المهام. يمكن أن يكون للشحن مهام متعددة مرتبطة بها. على سبيل المثال، قد تكون هناك مهمة واحدة للاستلام ومهمة للتسليم أو النقل. أيضًا، يمكن لمركبات مختلفة التعامل مع المهام المختلفة لشحنة معينة. على سبيل المثال، يمكن لمركبة واحدة تولي عملية الاستلام، وقيادة الشحنة إلى المركز، بينما تقود مركبة أخرى الشحنة نفسها من المركز إلى موقع التسليم.
ملاحظة: تستخدم واجهات برمجة التطبيقات gRPC وREST اصطلاحات تسمية حقول مختلفة. على سبيل المثال، يشير الحقل Task.journey_sharing_info
في واجهة برمجة التطبيقات gRPC والحقل Task.journeySharingInfo
في واجهة برمجة التطبيقات REST إلى الحقل نفسه.
الحقول | |
---|---|
name |
يجب استخدام التنسيق |
type |
مطلوبة. غير قابل للتغيير. تحدد نوع المهمة. مثل استراحة أو شحنة. |
state |
مطلوبة. حالة التنفيذ الحالية للمهمة. |
task_outcome |
نتيجة المهمة. |
task_outcome_time |
الطابع الزمني الذي يشير إلى الوقت الذي ضبط فيه مقدّم الخدمة نتيجة |
task_outcome_location |
تمثّل هذه السمة الموقع الجغرافي الذي تم فيه ضبط نتيجة |
task_outcome_location_source |
يشير إلى مصدر قيمة |
tracking_id |
غير قابل للتغيير. يسهّل هذا الحقل تخزين رقم التعريف لتتجنّب استخدام عملية ربط معقّدة. لا يمكنك ضبط
|
delivery_vehicle_id |
النتائج فقط. رقم تعريف المركبة التي تنفّذ هذه المهمة. تخضع معرّفات مركبات التسليم للقيود التالية:
|
planned_location |
غير قابل للتغيير. الموقع الذي سيتم إنجاز المهمة فيه اختيارية في مهام |
task_duration |
مطلوبة. غير قابل للتغيير. الوقت اللازم لتنفيذ مهمة في هذا الموقع الجغرافي. |
target_time_window |
الفترة الزمنية التي يجب إكمال المهمة خلالها. |
journey_sharing_info |
النتائج فقط. الحقول الخاصة بمشاركة رحلات البحث. لا تتم تعبئة هذا الحقل عندما تكون الولاية |
task_tracking_view_config |
إعداد تتبُّع المهام الذي يحدِّد عناصر البيانات التي ستظهر للمستخدمين النهائيين وتحت أي ظروف. |
attributes[] |
قائمة بسمات المهام المخصّصة يجب أن يكون لكل سمة مفتاح فريد. |
JourneySharingInfo
حقول مشاركة الرحلة المحدَّدة
الحقول | |
---|---|
remaining_vehicle_journey_segments[] |
تتبُّع المعلومات الخاصة بالمحطات التي ستجريها المركبة المحددة قبل إكمال هذه "المهمة". تجدر الإشارة إلى أنّ هذه القائمة يمكن أن تحتوي على محطات توقف من المهام الأخرى. يحتوي الجزء الأول، |
last_location |
تشير هذه السمة إلى آخر موقع جغرافي تم الإبلاغ عنه للمركبة المعنية. |
last_location_snappable |
تشير هذه السمة إلى ما إذا كان يمكن ضبط آخر موقع جغرافي للمركبة على " |
الحالة
حالة المهمة. يشير هذا إلى مستوى تقدّم المهام.
عمليات التعداد | |
---|---|
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 |
مفتاح السمة. لا يجوز أن تحتوي المفاتيح على علامة النقطتين الرأسيتين (:). |
حقل الاتحاد task_attribute_value يمكن أن تكون قيمة السمة في سلسلة أو قيمة منطقية أو نوع مزدوج. في حال عدم ضبط أي قيمة، سيتم تخزين قيمة string_value في TaskAttribute كسلسلة فارغة "". يمكن أن تكون task_attribute_value واحدًا فقط مما يلي: |
|
string_value |
قيمة السمة المكتوبة بسلسلة |
bool_value |
قيمة سمة مكتوبة من الناحية المنطقية |
number_value |
قيمة سمة مكتوبة بنمط مزدوج. |
TaskTrackingInfo
رسالة TaskTrackingInfo
تحتوي الرسالة على معلومات تتبُّع المهام التي سيتم استخدامها للعرض. إذا كان رقم تعريف التتبّع مرتبطًا بمهام متعدّدة، يستخدم Fleet Engine أسلوبًا إرشاديًا لتحديد مهمة TaskTrackingInfo التي يجب اختيارها.
الحقول | |
---|---|
name |
يجب أن يكون بالتنسيق |
tracking_id |
غير قابل للتغيير. رقم تعريف التتبّع لمهمة * يجب أن تكون سلسلة Unicode صالحة. * يجب ألّا يزيد عدد أحرفها عن 64 حرفًا. * تتم تسويتها وفقًا لنموذج تسوية Unicode. * لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow. |
vehicle_location |
آخر موقع جغرافي للمركبة |
route_polyline_points[] |
قائمة بالنقاط التي عند ربطها تشكل خطوطًا متعددة للمسار المتوقع للمركبة إلى موقع هذه المهمة. |
remaining_stop_count |
يشير إلى عدد محطات التوقف المتبقية للمركبة حتى الوصول إلى محطة المهمة، بما في ذلك محطة المهمة. على سبيل المثال، إذا كانت المحطة التالية للمركبة هي محطة المهمة، ستكون القيمة 1. |
remaining_driving_distance_meters |
إجمالي المسافة المتبقية بالمتر إلى |
estimated_arrival_time |
الطابع الزمني الذي يشير إلى الوقت المقدّر للوصول إلى الموقع الجغرافي للمحطة |
estimated_task_completion_time |
الطابع الزمني الذي يشير إلى الوقت المقدَّر لإكمال مهمة معيّنة. |
state |
حالة التنفيذ الحالية للمهمة. |
task_outcome |
يشير ذلك المصطلح إلى نتيجة محاولة تنفيذ إحدى المهام. |
task_outcome_time |
الطابع الزمني الذي يشير إلى الوقت الذي ضبط فيه مقدّم الخدمة نتيجة المهمة |
planned_location |
غير قابل للتغيير. الموقع الذي سيتم إنجاز المهمة فيه |
target_time_window |
الفترة الزمنية التي يجب إكمال المهمة خلالها. |
attributes[] |
السمات المخصّصة التي تم ضبطها في المهمة |
TaskTrackingViewConfig
رسالة الضبط التي تحدِّد الوقت الذي يجب أن يظهر فيه عنصر بيانات لمهمة للمستخدمين النهائيين.
الحقول | |
---|---|
route_polyline_points_visibility |
الحقل الذي يحدِّد متى يمكن أن تكون نقاط الخطوط المتعددة للمسار مرئية. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
estimated_arrival_time_visibility |
الحقل الذي يحدِّد الوقت المقدّر للوصول. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
estimated_task_completion_time_visibility |
الحقل الذي يحدد متى يمكن رؤية الوقت المقدّر لإكمال المهمة في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
remaining_driving_distance_visibility |
يمكن رؤية الحقل الذي يحدِّد المدة المتبقية للقيادة. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
remaining_stop_count_visibility |
يمكن رؤية الحقل الذي يحدِّد عدد محطات التوقف المتبقية. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
vehicle_location_visibility |
الحقل الذي يحدِّد متى يكون الموقع الجغرافي للمركبة مرئيًا. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
VisibilityOption
يشير ذلك المصطلح إلى رسالة الخيار التي تحدِّد متى يجب أن يكون عنصر البيانات مرئيًا للمستخدمين النهائيين.
الحقول | |
---|---|
حقل الاتحاد visibility_option خيار مستوى الرؤية المحدد الذي تم تحديده. يمكن أن يكون الحقل "visibility_option " واحدًا فقط مما يلي: |
|
remaining_stop_count_threshold |
ويكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين في حال كان عدد المحطات المتبقية <= العثور على هذه البيانات على ما يرام. |
duration_until_estimated_arrival_time_threshold |
يكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين إذا كان الوقت المقدّر للوصول (ETA) حتى التوقف <= duration_untill_ العمليات المقدَّرة_arrival_time_threshold. |
remaining_driving_distance_meters_threshold |
ويكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين إذا كانت مسافة القيادة المتبقية بالمتر <= الوقت المتبقي_driving_distance_meters_threshold. |
always |
أمّا في حال ضبطها على "صحيح"، فسيظهر عنصر البيانات هذا دائمًا للمستخدمين النهائيين بدون حدود. لا يمكن ضبط هذا الحقل على "خطأ". |
never |
في حال ضبط هذه السياسة على "صحيح"، يتم دائمًا إخفاء عنصر البيانات هذا عن المستخدمين النهائيين بدون أي حدود. لا يمكن ضبط هذا الحقل على "خطأ". |
TimeWindow
نطاق زمني
الحقول | |
---|---|
start_time |
مطلوبة. وقت بدء الفترة الزمنية (شاملة). |
end_time |
مطلوبة. وقت انتهاء الفترة الزمنية (شاملة). |
UpdateDeliveryVehicleRequest
رسالة الطلب UpdateDeliveryVehicle
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
delivery_vehicle |
مطلوبة. تعديل الكيان |
update_mask |
مطلوبة. قناع حقل يشير إلى حقول هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
UpdateTaskRequest
رسالة الطلب UpdateTask
.
الحقول | |
---|---|
header |
اختياريّ. عنوان الطلب العادي في Delivery API. |
task |
مطلوبة. المهمة المرتبطة بالتعديل يتم الاحتفاظ بالحقول التالية من قِبل Fleet Engine. ولا تعدِّلها باستخدام "
ملاحظة: لا يمكنك تغيير قيمة إذا تم تعيين المهمة إلى مركبة تسليم، لا تضبط حالة المهمة على "مغلقة" باستخدام |
update_mask |
مطلوبة. قناع الحقل الذي يشير إلى حقول "المهام" التي يجب تعديلها. ملاحظة: يجب أن يحتوي هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
VehicleJourneySegment
يمثّل هذا المقياس شريحة السفر في المركبة، من محطتها السابقة إلى المحطة الحالية. إذا كانت هذه هي المحطة الأولى النشطة، تكون من الموقع الجغرافي الحالي للمركبة وحتى هذه المحطة.
الحقول | |
---|---|
stop |
تحدّد هذه السمة الموقع الجغرافي للمحطة، بالإضافة إلى |
driving_distance_meters |
النتائج فقط. مسافة السفر من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة أجزاء الرحلة، تكون نقطة البداية هي الموقع الجغرافي للمركبة المسجَّل وقت إضافة هذه المحطة إلى القائمة. قد لا يتوفّر هذا الحقل إذا كان شريحة الرحلة هذه جزءًا من " |
driving_duration |
النتائج فقط. مدة الرحلة من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة أجزاء الرحلة، تكون نقطة البداية هي الموقع الجغرافي للمركبة المسجَّل وقت إضافة هذه المحطة إلى القائمة. في حال تحديد هذا الحقل في المسار |
path[] |
النتائج فقط. المسار من المحطة السابقة إلى هذه المحطة. إذا كانت المحطة الحالية هي المحطة الأولى في قائمة أجزاء الرحلة، تكون هذه هي المسار من الموقع الجغرافي الحالي للمركبة إلى هذه المحطة في الوقت الذي تمت إضافة المحطة فيه إلى القائمة. قد لا يتوفّر هذا الحقل إذا كان شريحة الرحلة هذه جزءًا من " إذا تم تحديد هذا الحقل في المسار |
VehicleStop
يصِف هذا القسم نقطة تتوقف فيها مركبة عن أداء ثانية واحدة أو أكثر من Task
.
الحقول | |
---|---|
planned_location |
مطلوبة. موقع المحطة. تجدر الإشارة إلى أنّ المواقع الجغرافية في |
tasks[] |
قائمة |
state |
تمثّل هذه السمة حالة |
الحالة
الحالة الحالية لـ VehicleStop
.
عمليات التعداد | |
---|---|
STATE_UNSPECIFIED |
غير معروف. |
NEW |
تم إنشاؤه، ولكن ليس التوجيه بشكل نشط. |
ENROUTE |
يتم تخصيصه وتوجيهه بشكل نشط. |
ARRIVED |
وصلت إلى المحطة. يفترض أنه عند توجيه المركبة إلى المحطة التالية، تكون جميع المحطات قد اكتملت. |
TaskInfo
معلومات إضافية حول المهمة التي تم تنفيذها في هذه المحطة
الحقول | |
---|---|
task_id |
معرِّف المهمة لن تتم تعبئة هذا الحقل استجابةً لمكالمة
|
task_duration |
النتائج فقط. الوقت اللازم لتنفيذ المهمة. |
target_time_window |
النتائج فقط. الفترة الزمنية التي يجب إكمال المهمة خلالها. يتم ضبط هذا الإعداد فقط استجابةً لـ |