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 جديدًا وتعرضه.
DeleteDeliveryVehicle

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

تحذف هذه الطريقة DeliveryVehicle من Fleet Engine.

تعرض هذه الحالة FAILED_PRECONDITION إذا كانت DeliveryVehicle تتضمّن مهام OPEN تم تعيينها لها.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

تحذف هذه الطريقة مهمة واحدة.

تعرض FAILED_PRECONDITION إذا كانت المهمة OPEN وتم تعيينها إلى DeliveryVehicle.
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 حرفًا.
  • يجب أن تكون البيانات موحّدة وفقًا لمعيار Unicode Normalization Form 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 حرفًا.
  • يجب أن تكون البيانات موحّدة وفقًا لمعيار Unicode Normalization Form C.
  • يجب ألّا يحتوي على أي من أحرف ASCII التالية: "/" أو ":" أو "؟" أو "," أو "#".
task

Task

مطلوب. تمثّل هذه السمة مهمة سيتم إنشاؤها. عند إنشاء مهمة، يجب ملء الحقول التالية:

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

يمكن ضبط الحقول التالية بشكل اختياري:

  • target_time_window
  • task_tracking_view_config
  • attributes

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

DeleteDeliveryVehicleRequest

رسالة طلب DeleteDeliveryVehicle

الحقول
header

DeliveryRequestHeader

اختياريّ. عنوان طلب Delivery API العادي
name

string

مطلوب. يجب أن يكون بالتنسيق providers/{provider}/deliveryVehicles/{delivery_vehicle}. يجب أن يكون provider هو معرّف مشروع Google Cloud. على سبيل المثال، sample-cloud-project.

DeleteTaskRequest

رسالة طلب DeleteTask

الحقول
header

DeliveryRequestHeader

اختياريّ. عنوان طلب Delivery API العادي
name

string

مطلوب. يجب أن يكون بالتنسيق providers/{provider}/tasks/{task}. يجب أن يكون provider هو معرّف مشروع Google Cloud. على سبيل المثال، sample-cloud-project.

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 التي يتم استدعاؤها، وينطبق ذلك فقط على حِزم Android SDK. مثال على قيمة الحقل: 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

آخر موقع جغرافي تم الإبلاغ عنه لمركبة التوصيل
past_locations[]

DeliveryVehicleLocation

الإدخال فقط المواقع الجغرافية التي كانت فيها "مركبة التوصيل" هذه في السابق ولم يتم إبلاغ Fleet Engine بها بعد يتم استخدام هذا الحقل في UpdateDeliveryVehicleRequest لتسجيل المواقع الجغرافية التي تعذّر إرسالها إلى الخادم سابقًا. يحدث ذلك عادةً عندما لا تكون مركبة التوصيل متصلة بالإنترنت.
navigation_status

DeliveryVehicleNavigationStatus

حالة التنقّل لمركبة التوصيل
current_route_segment

bytes

الخط المتعدد المشفّر الذي يحدّد المسار الذي تنصح خدمة التنقّل باتّباعه للوصول إلى نقطة الطريق التالية. يعدّل تطبيق السائق هذه المعلومات عند الوصول إلى محطة أو تجاوزها، وعندما يتم تغيير مسار التنقّل. يتم عرض LatLngs هذه في 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 هذا الحقل بمسار من VehicleStop الذي تمّت زيارته مؤخرًا إلى VehicleStop القادم لضمان حصول مستهلك هذا الحقل على أفضل المعلومات المتاحة عن المسار الحالي لـ "مركبة التوصيل".
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 يوفّر تطبيق السائق هذا الحقل عادةً، ولكن في بعض الحالات، ستتجاهل Fleet Engine القيمة التي يرسلها التطبيق. لمزيد من المعلومات، اطّلِع على DeliveryVehicle.current_route_segment. يتم عرض هذا الحقل في Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) أو Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) لجميع Task النشطة المعيّنة إلى "مركبة التسليم".

يتجاهل Fleet Engine هذا الحقل في UpdateDeliveryVehicleRequest إذا كان الحقل current_route_segment فارغًا.
remaining_duration

Duration

الوقت المتبقي للقيادة في current_route_segment يوفّر تطبيق السائق هذا الحقل عادةً، ولكن في بعض الحالات، ستتجاهل 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 يمكن أن تكون قيمة السمة من النوع string أو bool أو double. يمكن أن تكون delivery_vehicle_attribute_value إحدى القيم التالية فقط:
string_value

string

قيمة السمة من النوع "سلسلة"

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

bool

قيمة السمة من النوع المنطقي
number_value

double

قيمة السمة من النوع 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 كنصف قطر، وذلك بالمتر.
flp_location

LatLng

الموقع الجغرافي من ميزة "موفِّر الموقع المدمج" من Android
flp_update_time

Timestamp

الطابع الزمني لتعديل flp_location
flp_latlng_accuracy_meters

DoubleValue

دقة flp_location بالأمتار كنصف قطر
flp_heading_degrees

Int32Value

الاتجاه الذي تتحرّك فيه المركبة بالدرجات، كما يحدّده "موفِّر الموقع المدمج" يمثّل الرقم 0 الشمال. النطاق الصالح هو [0,360).
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 معرّف برج خلوي أو نقطة وصول Wi-Fi
ROAD_SNAPPED_LOCATION_PROVIDER موقع جغرافي يحدّده الجهاز الجوّال ليكون الموضع الأرجح على الطريق.
CUSTOMER_SUPPLIED_LOCATION موقع جغرافي يقدّمه العميل من مصدر مستقل يتم عادةً استخدام هذه القيمة للموقع الجغرافي المقدَّم من مصادر أخرى غير الجهاز الجوّال الذي يتم تشغيل Driver SDK عليه. إذا كان المصدر الأصلي موصوفًا بإحدى قيم التعداد الأخرى، استخدِم تلك القيمة. يتم عادةً توفير المواقع الجغرافية التي تحمل العلامة CUSTOMER_SUPPLIED_LOCATION من خلال last_location.supplemental_location_sensor في DeliveryVehicle.
FLEET_ENGINE_LOCATION موقع جغرافي تحسبه Fleet Engine استنادًا إلى الإشارات المتاحة لها. النتائج فقط. سيتم رفض هذه القيمة إذا تم تلقّيها في طلب.
FUSED_LOCATION_PROVIDER ميزة "موفِّر الموقع المدمج" من Android
CORE_LOCATION مقدّم خدمة تحديد الموقع الجغرافي على أنظمة تشغيل Apple

DeliveryVehicleNavigationStatus

تعرض هذه السمة حالة التنقّل في المركبة.

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

GetDeliveryVehicleRequest

رسالة طلب GetDeliveryVehicle

الحقول
header

DeliveryRequestHeader

اختياريّ. عنوان طلب Delivery API العادي
name

string

مطلوب. يجب أن يكون بالتنسيق providers/{provider}/deliveryVehicles/{delivery_vehicle}. يجب أن يكون provider هو معرّف مشروع Google Cloud. على سبيل المثال، sample-cloud-project.

GetTaskRequest

رسالة طلب GetTask

الحقول
header

DeliveryRequestHeader

اختياريّ. عنوان طلب Delivery API العادي
name

string

مطلوب. يجب أن يكون بالتنسيق providers/{provider}/tasks/{task}. يجب أن يكون provider هو معرّف مشروع Google Cloud. على سبيل المثال، sample-cloud-project.

GetTaskTrackingInfoRequest

رسالة طلب GetTaskTrackingInfoRequest

الحقول
header

DeliveryRequestHeader

اختياريّ. عنوان طلب Delivery API العادي
name

string

مطلوب. يجب أن يكون بالتنسيق providers/{provider}/taskTrackingInfo/{tracking_id}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud، ويجب أن يكون tracking_id هو رقم تعريف التتبُّع المرتبط بالمهمة. يمكن أن يكون اسم المثال providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

ListDeliveryVehiclesRequest

رسالة طلب ListDeliveryVehicles

الحقول
header

DeliveryRequestHeader

اختياريّ. عنوان طلب Delivery API العادي
parent

string

مطلوب. يجب أن يكون بالتنسيق providers/{provider}. يجب أن يكون provider هو معرّف مشروع Google Cloud. على سبيل المثال، sample-cloud-project.
page_size

int32

اختياريّ. الحدّ الأقصى لعدد المركبات المطلوب عرضه. قد تعرض الخدمة عددًا أقل من هذا الرقم. إذا لم تحدّد هذا الرقم، سيحدّد الخادم عدد النتائج التي سيتم عرضها.
page_token

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب ListDeliveryVehicles سابق. يجب تقديم هذه المعلومات لاسترداد الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListDeliveryVehicles مع الطلب الذي قدّم رمز الصفحة المميز.
filter

string

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

يُرجى العِلم أنّ طلبات البحث الوحيدة المتوافقة مع ListDeliveryVehicles هي تلك التي تتضمّن سمات المركبة (مثل attributes.<key> = <value> أو attributes.<key1> = <value1> AND attributes.<key2> = <value2>). بالإضافة إلى ذلك، يتم تخزين جميع السمات كسلاسل، لذا فإنّ عمليات المقارنة الوحيدة المتوافقة مع السمات هي عمليات مقارنة السلاسل. للمقارنة مع قيم رقمية أو منطقية، يجب وضع القيم بين علامتَي اقتباس بشكلٍ صريح ليتم التعامل معها كسلاسل (على سبيل المثال، attributes.<key> = "10" أو attributes.<key> = "true").

الحدّ الأقصى لعدد القيود المسموح بها في طلب فلترة هو 50. القيد هو جزء من طلب البحث بالتنسيق attribute.<KEY> <COMPARATOR> <VALUE>، على سبيل المثال attributes.foo = bar هو قيد واحد.
viewport

Viewport

اختياريّ. فلتر يقتصر على المركبات التي كان آخر موقع جغرافي معروف لها في المنطقة المستطيلة المحدّدة بواسطة إطار العرض.

ListDeliveryVehiclesResponse

رسالة الرد ListDeliveryVehicles

الحقول
delivery_vehicles[]

DeliveryVehicle

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

string

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

int64

العدد الإجمالي لمركبات التوصيل التي تتطابق مع معايير الطلب، وذلك على مستوى جميع الصفحات

ListTasksRequest

رسالة طلب ListTasks

الحقول
header

DeliveryRequestHeader

اختياريّ. عنوان طلب Delivery API العادي
parent

string

مطلوب. يجب أن يكون بالتنسيق providers/{provider}. يجب أن يكون provider هو معرّف مشروع Google Cloud. على سبيل المثال، sample-cloud-project.
page_size

int32

اختياريّ. الحدّ الأقصى لعدد المهام المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم تحدّد هذه القيمة، سيحدّد الخادم عدد النتائج المطلوب عرضها.
page_token

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب ListTasks سابق. يمكنك تقديم ذلك لاسترداد الصفحة اللاحقة.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListTasks مع الطلب الذي قدّم رمز الصفحة المميز.
filter

string

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

ListTasksResponse

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

الحقول
tasks[]

Task

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

string

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

int64

العدد الإجمالي للمهام التي تتطابق مع معايير الطلب، وذلك على مستوى جميع الصفحات

LocationInfo

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

الحقول
point

LatLng

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

string

اسم مصدر المكان الذي يمثّل هذا الموقع الجغرافي. التنسيق هو places/{place_id}. يجب تحديد point أو place كإدخال. في حال تحديد كليهما، سيتم استخدام point للتوجيه وplace للبيانات الوصفية. لا يتم تضمين place في الناتج إلا إذا تم تضمينه في الإدخال، ما يعني أنّه لا يتم إجراء بحث عن place من LatLng.

هذه ميزة تجريبية.
point_location_source

PointSource

النتائج فقط. مصدر الحقل latlng point هذا جزء من ميزة تجريبية.

PointSource

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

عمليات التعداد
POINT_SOURCE_UNSPECIFIED لم يتم تحديد مصدر النقطة.
POINT_SOURCE_DEVELOPER_PROVIDED تم تقديم LatLng بشكل صريح من قِبل المطوّر.
POINT_SOURCE_CALCULATED_FROM_PLACE تم احتساب 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 حرفًا.
  • يجب أن تكون البيانات موحّدة وفقًا لمعيار Unicode Normalization Form C.
  • يجب ألّا يحتوي على أي من أحرف ASCII التالية: "/" أو ":" أو "؟" أو "," أو "#".
delivery_vehicle_id

string

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

  • يجب أن تكون سلسلة Unicode صالحة.
  • يجب ألا يتجاوز طولها 64 حرفًا.
  • يجب أن تكون البيانات موحّدة وفقًا لمعيار Unicode Normalization Form C.
  • يجب ألّا يحتوي على أي من أحرف ASCII التالية: "/" أو ":" أو "؟" أو "," أو "#".
planned_location

LocationInfo

غير قابل للتغيير الموقع الجغرافي الذي سيتم فيه إكمال المهمة اختيارية في UNAVAILABLE المهام، ولكنّها مطلوبة في جميع المهام الأخرى
task_duration

Duration

مطلوب. غير قابل للتغيير الوقت اللازم لتنفيذ مهمة في هذا الموقع الجغرافي
target_time_window

TimeWindow

الفترة الزمنية التي يجب إكمال المهمة خلالها
journey_sharing_info

JourneySharingInfo

النتائج فقط. الحقول الخاصة بميزة "مشاركة الرحلات" لا تتم تعبئة هذا الحقل عندما تكون الحالة CLOSED.
task_tracking_view_config

TaskTrackingViewConfig

إعدادات تتبُّع المهام التي تحدّد عناصر البيانات المرئية للمستخدمين النهائيين في ظلّ ظروف معيّنة
attributes[]

TaskAttribute

قائمة بسمات المهام المخصّصة. يجب أن تتضمّن كل سمة مفتاحًا فريدًا.

JourneySharingInfo

الحقول المحدّدة لميزة "مشاركة الرحلة"

الحقول
remaining_vehicle_journey_segments[]

VehicleJourneySegment

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

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

DeliveryVehicleLocation

تشير هذه السمة إلى آخر موقع جغرافي تم الإبلاغ عنه للمركبة المخصّصة.
last_location_snappable

bool

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

string

قيمة السمة من النوع "سلسلة"
bool_value

bool

قيمة السمة من النوع المنطقي
number_value

double

قيمة السمة من النوع Double

TaskTrackingInfo

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

الحقول
name

string

يجب أن يكون بالتنسيق providers/{provider}/taskTrackingInfo/{tracking}، حيث يمثّل tracking رقم تعريف التتبّع.
tracking_id

string

غير قابل للتغيير رقم تعريف التتبّع الخاص بمهمة. * يجب أن تكون سلسلة Unicode صالحة. * يجب ألا يتجاوز طولها 64 حرفًا. * تمّت تسويته وفقًا لنموذج التسوية C في Unicode. * يجب ألّا يحتوي على أي من أحرف ASCII التالية: "/" أو ":" أو "؟" أو "," أو "#".
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 بعد ضبطها.

إذا تم تعيين المهمة لمركبة توصيل، لا تضبط حالة المهمة على CLOSED باستخدام Task.update. بدلاً من ذلك، أزِل VehicleStop الذي يحتوي على المهمة من مركبة التوصيل، ما يؤدي تلقائيًا إلى ضبط حالة المهمة على CLOSED.
update_mask

FieldMask

مطلوب. قناع الحقل الذي يشير إلى حقول "المهمة" المطلوب تعديلها. ملاحظة: يجب أن يحتوي update_mask على حقل واحد على الأقل.

هذه قائمة مفصولة بفواصل تتضمّن الأسماء المؤهَّلة بالكامل للحقول. مثال: "task_outcome,task_outcome_time,task_outcome_location"

VehicleJourneySegment

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

الحقول
stop

VehicleStop

تحدّد هذه السمة موقع التوقف، بالإضافة إلى Task المرتبطة به. قد لا تكون بعض حقول VehicleStop متوفّرة إذا كانت شريحة الرحلة هذه جزءًا من 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 Normalization Form C.
  • يجب ألّا يحتوي على أي من أحرف ASCII التالية: "/" أو ":" أو "؟" أو "," أو "#".
task_duration

Duration

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

TimeWindow

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