Package maps.fleetengine.delivery.v1

الفهرس

DeliveryService

خدمة توصيل The Last Mile

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، ولكن يجب أن يحتوي على جميع 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 حرفًا كحد أقصى.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
delivery_vehicle

DeliveryVehicle

مطلوب. عنصر DeliveryVehicle المطلوب إنشاؤه. عند إنشاء مركبة تسليم جديدة، يمكنك ضبط الحقول الاختيارية التالية:

  • كتابة
  • last_location
  • سمات

ملاحظة: يتم تجاهل حقل 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 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
task

Task

مطلوب. عنصر المهمة المطلوب إنشاؤه. عند إنشاء مهمة، تكون الحقول التالية مطلوبة:

  • type
  • state (يجب ضبطه على OPEN)
  • tracking_id (يجب عدم ضبطها للمهام من النوع UNAVAILABLE أو SCHEDULED_STOP، ولكنّها مطلوبة لجميع أنواع المهام الأخرى)
  • planned_location (اختيارية لمهام UNAVAILABLE)
  • task_duration

ملاحظة: يتم تجاهل حقل name في "المهمة". يجب عدم ضبط جميع حقول "المهمة" الأخرى، وإلا سيتم عرض خطأ.

DeliveryRequestHeader

يحتوي RequestHeader على حقول شائعة لجميع طلبات Delivery 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) التي تُجري المكالمة هي Consumer.
DRIVER حزمة تطوير البرامج (SDK) التي تُجري المكالمة هي Driver.
JAVASCRIPT حزمة تطوير البرامج (SDK) التي تستدعي واجهة برمجة التطبيقات هي JavaScript.

DeliveryVehicle

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

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

الحقول
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 إلى محطة AutomotiveStop القادمة للتأكّد من أنّ مستهلك هذا الحقل لديه أفضل المعلومات المتاحة حول المسار الحالي لمركبة التسليم.
current_route_segment_end_point

LatLng

الموقع الجغرافي الذي ينتهي فيه current_route_segment. لا يتم حاليًا تعبئة هذا الحقل من خلال تطبيق السائق، ولكن يمكنك تقديمه في مكالمات UpdateDeliveryVehicle. إما أن يكون LatLng من محطة المركبات القادمة، أو آخر LatLng من current_route_segment. سيبذل "محرك الأسطول" قصارى جهده بعد ذلك لإجراء عملية الاستقراء إلى 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

تصف سمة المركبة كزوج مفتاح/قيمة. لا يمكن أن يتجاوز طول سلسلة "المفتاح:القيمة" 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) المُساعد أو رقم تعريف برج الاتصالات أو نقطة وصول شبكة Wi-Fi
PASSIVE رقم تعريف البرج الخلوي أو نقطة وصول Wi-Fi
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 تتوفّر ميزة "الاتّجاهات المفصّلة"، ودخلت ميزة التنقّل في تطبيق "سائق Google" في وضع 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

اختياريّ. طلب بحث فلتر لتطبيقه عند إدراج "المهام" راجِع http://aip.dev/160 للاطّلاع على أمثلة على بنية الفلاتر. إذا لم تحدِّد قيمة أو إذا أجريت فلترة على سلسلة فارغة، سيتم عرض جميع "مهام Google". للحصول على معلومات عن سمات المهام التي يمكنك الفلترة حسبها، اطّلِع على قائمة المهام.

ListTasksResponse

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

الحقول
tasks[]

Task

مجموعة "المهام" التي تستوفي معايير الفلترة المطلوبة في حال عدم تحديد فلتر، يعرض الطلب جميع المهام. ويمكن أن يكون الرد الناجح فارغًا أيضًا. يشير الردّ الفارغ إلى أنّه لم يتم العثور على أي "مهام" تستوفي معايير الفلتر المطلوبة.
next_page_token

string

نقْل هذا الرمز المميّز في ListTasksRequest لمواصلة إدراج النتائج. إذا تم عرض جميع النتائج، يكون هذا الحقل إما سلسلة فارغة أو لا يظهر في الاستجابة.
total_size

int64

إجمالي عدد "المهام" التي تتطابق مع معايير الطلب، في جميع الصفحات

LocationInfo

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

الحقول
point

LatLng

إحداثيات الموقع الجغرافي

المهمة

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

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

الحقول
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 حرفًا كحد أقصى.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
delivery_vehicle_id

string

النتائج فقط. معرّف المركبة التي تنفّذ هذه المهمة. تخضع معرّفات مركبات التسليم للقيود التالية:

  • يجب أن تكون سلسلة Unicode صالحة.
  • الحد الأقصى لعدد الأحرف هو 64 حرفًا.
  • تمت التسوية وفقًا لنموذج تسوية Unicode C.
  • يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
planned_location

LocationInfo

غير قابل للتغيير الموقع الجغرافي الذي سيتم إكمال المهمة فيه اختيارية في "مهام UNAVAILABLE"، ولكنها مطلوبة لجميع "مهام Google" الأخرى
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. تكون هذه القيمة 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

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

الحقول
key

string

مفتاح السمة لا يجوز أن تحتوي المفاتيح على رمز النقطتَين (:).
حقل الربط task_attribute_value يمكن أن تكون قيمة السمة من النوع string أو bool أو double. في حال عدم ضبط أيّ منها، سيتم تخزين سلسلة_قيمة سمة_المهمة على أنّها السلسلة الفارغة "". يمكن أن يكون 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

يظهر عنصر البيانات هذا للمستخدمين النهائيين إذا كان عدد المحطات المتبقية <= remaining_stop_count_threshold.
duration_until_estimated_arrival_time_threshold

Duration

يكون عنصر البيانات هذا مرئيًا للمستخدمين إذا كان الوقت المقدّر للوصول إلى المحطة <= duration_until_estimated_arrival_time_threshold.
remaining_driving_distance_meters_threshold

int32

يظهر عنصر البيانات هذا للمستخدمين النهائيين إذا كانت المسافة المتبقية للقيادة بالكيلومترات <= remaining_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 المرتبطة بالحافلة. قد لا تكون بعض حقول 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 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
task_duration

Duration

النتائج فقط. الوقت المطلوب لتنفيذ المهمة.
target_time_window

TimeWindow

النتائج فقط. الفترة الزمنية التي يجب إنجاز المهمة خلالها. لا يتم ضبط هذا الإعداد إلا في الاستجابة لطلب GetDeliveryVehicle.