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 جديد وإرجاعه
DeleteDeliveryVehicle

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

لحذف مركبة توصيل من Fleet Engine

تعرِض القيمة FAILED_PRECONDITION إذا كان لدى DeliveryVehicle مهام مفتوحة تم تعيينها لها.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

لحذف مهمة واحدة

تعرِض القيمة FAILED_PRECONDITION إذا كانت المهمة "مفتوحة" وتم تعيينها إلى 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 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (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 التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
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 التي تُجري الطلب، لا ينطبق إلا على حِزم 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

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

DeliveryVehicleLocation

الإدخال فقط المواقع الجغرافية التي كانت مركبة التسليم هذه موجودة فيها في السابق والتي لم يتم الإبلاغ عنها بعد إلى Fleet Engine يتم استخدام هذا الإجراء في UpdateDeliveryVehicleRequest لتسجيل المواقع الجغرافية التي تعذّر إرسالها سابقًا إلى الخادم. يحدث ذلك عادةً عندما لا تكون مركبة التسليم متصلة بالإنترنت.
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 هذا الحقل بمسار من VehicleStop الذي تم اجتيازه مؤخرًا إلى VehicleStop القادم لضمان حصول مستخدِم هذا الحقل على أفضل المعلومات المتاحة حول المسار الحالي لمركبة التسليم.
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) لجميع Task النشطة التي تم تعيينها إلى مركبة التسليم.

يتجاهل 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 يمكن أن تكون قيمة السمة من النوع string أو bool أو double. يمكن أن يكون 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 موقع جغرافي يقدّمه العميل من مصدر مستقل وعادةً ما يتم استخدام هذه القيمة لموقع جغرافي يتم توفيره من مصادر أخرى غير الجهاز الجوّال الذي يعمل بنظام التشغيل Driver SDK. إذا كان المصدر الأصلي موضّحًا بإحدى قيم التعداد الأخرى، استخدِم تلك القيمة. يتم عادةً تقديم المواقع الجغرافية التي تم وضع علامة CUSTOMER_SUPPLIED_LOCATION عليها من خلال last_location.supplemental_location_sensor في DeliveryVehicle.
FLEET_ENGINE_LOCATION موقع جغرافي يحتسبه محرّك الأسطول استنادًا إلى الإشارات المتاحة له النتائج فقط. سيتم رفض هذه القيمة إذا تم استلامها في طلب.
FUSED_LOCATION_PROVIDER ميزة "موفِّر الموقع المدمج" من Android
CORE_LOCATION مقدّم خدمات الموقع الجغرافي على أنظمة التشغيل من Apple

DeliveryVehicleNavigationStatus

حالة التنقّل في المركبة

عمليات التعداد
UNKNOWN_NAVIGATION_STATUS حالة التنقّل غير محدّدة.
NO_GUIDANCE وضع التنقّل في تطبيق "سائق Google" هو 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 للحصول على أمثلة على بنية الفلتر. إذا لم تحدّد قيمة، أو إذا كنت تفلتر حسب سلسلة فارغة، يتم عرض جميع المهام. للحصول على معلومات عن سمات "المهام" التي يمكنك الفلترة حسبها، اطّلِع على قائمة المهام.

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 التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
delivery_vehicle_id

string

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

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

LocationInfo

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

يشير إلى ما إذا كان يمكن تثبيت lastLocation للمركبة على current_route_segment. تكون هذه القيمة False إذا لم يكن last_location أو current_route_segment متوفّرَين. يتم احتساب هذه القيمة بواسطة Fleet Engine. يتم تجاهل التعديلات الواردة من العملاء.

الحالة

حالة مهمة. يشير ذلك إلى مستوى تقدّم "مهام Google".

عمليات التعداد
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 حرفًا. * تم تسويتها وفقًا لنموذج تسويتها في يونيكود C. * لا يمكن أن تحتوي على أي من أحرف 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

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

Duration

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

TimeWindow

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