Package maps.fleetengine.delivery.v1

الفهرس

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.