- المورد: المهمة
- النوع
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- الطُرق
المرجع: المهمة
تمثل المهمة في واجهة برمجة تطبيقات التسليم إجراءً واحدًا يجب تتبعه. بشكل عام، هناك فرق بين المهام المتعلقة بالشحن وتعطل المهام. يمكن أن يكون للشحن مهام متعددة مرتبطة بها. على سبيل المثال، قد تكون هناك مهمة واحدة للاستلام ومهمة للتسليم أو النقل. أيضًا، يمكن لمركبات مختلفة التعامل مع المهام المختلفة لشحنة معينة. على سبيل المثال، يمكن لمركبة واحدة تولي عملية الاستلام، وقيادة الشحنة إلى المركز، بينما تقود مركبة أخرى الشحنة نفسها من المركز إلى موقع التسليم.
ملاحظة: تستخدم واجهات برمجة التطبيقات gRPC وREST اصطلاحات تسمية حقول مختلفة. على سبيل المثال، يشير الحقل Task.journey_sharing_info
في واجهة برمجة التطبيقات gRPC والحقل Task.journeySharingInfo
في واجهة برمجة التطبيقات REST إلى الحقل نفسه.
تمثيل JSON |
---|
{ "name": string, "type": enum ( |
الحقول | |
---|---|
name |
يجب استخدام التنسيق |
type |
مطلوبة. غير قابل للتغيير. تحدد نوع المهمة. مثل استراحة أو شحنة. |
state |
مطلوبة. حالة التنفيذ الحالية للمهمة. |
taskOutcome |
نتيجة المهمة. |
taskOutcomeTime |
الطابع الزمني الذي يشير إلى الوقت الذي ضبط فيه مقدّم الخدمة نتيجة طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
taskOutcomeLocation |
تمثّل هذه السمة الموقع الجغرافي الذي تم فيه ضبط نتيجة |
taskOutcomeLocationSource |
يشير إلى مصدر قيمة |
trackingId |
غير قابل للتغيير. يسهّل هذا الحقل تخزين رقم التعريف لتتجنّب استخدام عملية ربط معقّدة. لا يمكنك ضبط
|
deliveryVehicleId |
النتائج فقط. رقم تعريف المركبة التي تنفّذ هذه المهمة. تخضع معرّفات مركبات التسليم للقيود التالية:
|
plannedLocation |
غير قابل للتغيير. الموقع الذي سيتم إنجاز المهمة فيه اختيارية في مهام |
taskDuration |
مطلوبة. غير قابل للتغيير. الوقت اللازم لتنفيذ مهمة في هذا الموقع الجغرافي. مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ " |
targetTimeWindow |
الفترة الزمنية التي يجب إكمال المهمة خلالها. |
journeySharingInfo |
النتائج فقط. الحقول الخاصة بمشاركة رحلات البحث. لا تتم تعبئة هذا الحقل عندما تكون الولاية |
taskTrackingViewConfig |
إعداد تتبُّع المهام الذي يحدِّد عناصر البيانات التي ستظهر للمستخدمين النهائيين وتحت أي ظروف. |
attributes[] |
قائمة بسمات المهام المخصّصة يجب أن يكون لكل سمة مفتاح فريد. |
النوع
نوع المهمة
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
يكون نوع المهمة غير معروف بشكل تلقائي. |
PICKUP |
مهمة الاستلام هي الإجراء المتخذ لاستلام شحنة من العميل. يجب أن تستخدم عمليات استلام المركبات من المستودع أو الخلاصة النوع SCHEDULED_STOP . |
DELIVERY |
مهمة التسليم هي الإجراء المتخذ لتسليم شحنة إلى عميل نهائي. يجب أن تستخدم عمليات الانسحاب من المركبات في المستودع أو الخلاصة النوع SCHEDULED_STOP . |
SCHEDULED_STOP |
يتم استخدام مهمة إيقاف مُجدوَلة لأغراض التخطيط. على سبيل المثال، يمكن أن تمثل استلام الشحنات أو تسليمها من مركبات التغذية أو المستودعات. ويجب عدم استخدامها لأي شحنات يتم استلامها أو تسليمها من عميل نهائي. |
UNAVAILABLE |
مهمة تعني أن المركبة غير متاحة للصيانة. على سبيل المثال، يمكن أن يحدث ذلك عندما يأخذ السائق استراحة أو عندما تتم إعادة تعبئة المركبة. |
TaskOutcomeLocationSource
هوية المصدر الذي ملأ taskOutcomeLocation
.
عمليات التعداد | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
نتيجة المهمة قبل تعيينها. |
PROVIDER |
حدّد مقدّم الخدمة السمة taskOutcomeLocation . |
LAST_VEHICLE_LOCATION |
لم يحدّد مقدّم الخدمة السمة taskOutcomeLocation ، لذلك استخدم محرّك Fleet Engine آخر موقع جغرافي معروف للمركبة. |
JourneySharingInfo
حقول مشاركة الرحلة المحدَّدة
تمثيل JSON |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
الحقول | |
---|---|
remainingVehicleJourneySegments[] |
تتبُّع المعلومات الخاصة بالمحطات التي ستجريها المركبة المحددة قبل إكمال هذه "المهمة". تجدر الإشارة إلى أنّ هذه القائمة يمكن أن تحتوي على محطات توقف من المهام الأخرى. يحتوي الجزء الأول، |
lastLocation |
تشير هذه السمة إلى آخر موقع جغرافي تم الإبلاغ عنه للمركبة المعنية. |
lastLocationSnappable |
تشير هذه السمة إلى ما إذا كان يمكن ضبط آخر موقع جغرافي للمركبة على " |
TaskTrackingViewConfig
رسالة الضبط التي تحدِّد الوقت الذي يجب أن يظهر فيه عنصر بيانات لمهمة للمستخدمين النهائيين.
تمثيل JSON |
---|
{ "routePolylinePointsVisibility": { object ( |
الحقول | |
---|---|
routePolylinePointsVisibility |
الحقل الذي يحدِّد متى يمكن أن تكون نقاط الخطوط المتعددة للمسار مرئية. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
estimatedArrivalTimeVisibility |
الحقل الذي يحدِّد الوقت المقدّر للوصول. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
estimatedTaskCompletionTimeVisibility |
الحقل الذي يحدد متى يمكن رؤية الوقت المقدّر لإكمال المهمة في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
remainingDrivingDistanceVisibility |
يمكن رؤية الحقل الذي يحدِّد المدة المتبقية للقيادة. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
remainingStopCountVisibility |
يمكن رؤية الحقل الذي يحدِّد عدد محطات التوقف المتبقية. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
vehicleLocationVisibility |
الحقل الذي يحدِّد متى يكون الموقع الجغرافي للمركبة مرئيًا. في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات الظهور التلقائية على مستوى المشروع لهذه البيانات. |
VisibilityOption
يشير ذلك المصطلح إلى رسالة الخيار التي تحدِّد متى يجب أن يكون عنصر البيانات مرئيًا للمستخدمين النهائيين.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد visibility_option خيار مستوى الرؤية المحدد الذي تم تحديده. يمكن أن يكون الحقل "visibility_option " واحدًا فقط مما يلي: |
|
remainingStopCountThreshold |
يكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين في حال كان عدد المحطات المتبقية <= pendingStopCountThreshold. |
durationUntilEstimatedArrivalTimeThreshold |
يكون عنصر البيانات هذا مرئيًا للمستخدمين النهائيين إذا كان الوقت المقدّر للوصول عند نقطة التوقف <= durationUntitidArrivalTimeThreshold. مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ " |
remainingDrivingDistanceMetersThreshold |
يظهر عنصر البيانات هذا للمستخدمين النهائيين إذا كانت مسافة القيادة المتبقية بالمتر <= العثور على ما تبقى من "المسافة المقطوعة". |
always |
أمّا في حال ضبطها على "صحيح"، فسيظهر عنصر البيانات هذا دائمًا للمستخدمين النهائيين بدون حدود. لا يمكن ضبط هذا الحقل على "خطأ". |
never |
في حال ضبط هذه السياسة على "صحيح"، يتم دائمًا إخفاء عنصر البيانات هذا عن المستخدمين النهائيين بدون أي حدود. لا يمكن ضبط هذا الحقل على "خطأ". |
الطُرق |
|
---|---|
|
تنشئ هذه الدالة مجموعة من عناصر Task الجديدة وتعرضها. |
|
ينشئ عنصر Task جديدًا ويعرضه. |
|
الحصول على معلومات عن Task |
|
الحصول على جميع Task التي تستوفي معايير الفلترة المحدّدة. |
|
لتعديل بيانات "Task " |