REST Resource: providers.tasks

{
  "name": string,
  "type": enum (Type),
  "state": enum (State),
  "taskOutcome": enum (TaskOutcome),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfo)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSource),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfo)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  },
  "journeySharingInfo": {
    object (JourneySharingInfo)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfig)
  },
  "attributes": [
    {
      object (TaskAttribute)
    }
  ]
}

string

يجب أن يكون بالتنسيق providers/{provider}/tasks/{task}.

enum (Type)

مطلوب. غير قابل للتغيير تحدِّد هذه السمة نوع المهمة. على سبيل المثال، استراحة أو شحنة.

enum (State)

مطلوب. حالة تنفيذ "المهمة" الحالية.

enum (TaskOutcome)

نتيجة "المهمة".

string (Timestamp format)

الطابع الزمني الذي يشير إلى وقت ضبط مزوّد الخدمة لنتيجة Task

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

object (LocationInfo)

الموقع الجغرافي الذي تمّ فيه ضبط نتيجة Task يتم تعديل هذه القيمة كجزء من tasks.patch. إذا لم يعدّل مقدّم الخدمة هذه القيمة بشكل صريح، يملأها Fleet Engine تلقائيًا بآخر موقع جغرافي معروف للمركبة (الموقع الجغرافي الأوّلي).

enum (TaskOutcomeLocationSource)

يشير إلى مصدر قيمة taskOutcomeLocation.

string

غير قابل للتغيير يسهّل هذا الحقل تخزين المعرف حتى تتمكن من تجنب استخدام تعيين معقد. لا يمكنك ضبط trackingId للمهام من النوعَين UNAVAILABLE وSCHEDULED_STOP. تخضع أرقام التعريف هذه للقيود التالية:

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

string

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

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

object (LocationInfo)

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

string (Duration format)

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

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"

object (TimeWindow)

الفترة الزمنية التي يجب أن تكتمل خلالها المهمة.

object (JourneySharingInfo)

النتائج فقط. الحقول المتعلّقة بمشاركة الرحلة لا تتم تعبئة هذا الحقل عندما تكون الحالة CLOSED.

object (TaskTrackingViewConfig)

الإعدادات لتتبُّع المهام التي تحدِّد عناصر البيانات التي تظهر للمستخدمين النهائيين في ظلّ أيّ ظروف

object (TaskAttribute)

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

{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "lastLocationSnappable": boolean
}

object (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 المتبقية.

object (DeliveryVehicleLocation)

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

boolean

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

{
  "routePolylinePointsVisibility": {
    object (VisibilityOption)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOption)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOption)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOption)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOption)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOption)
  }
}

object (VisibilityOption)

الحقل الذي يحدد متى يمكن أن تكون النقاط المتعددة الخطوط للمسار مرئية. في حال عدم تحديد هذا الحقل، سيتم استخدام الإعدادات التلقائية لمستوى مستوى المشروع لمستوى مستوى المشروع لهذه البيانات.

object (VisibilityOption)

الحقل الذي يحدّد الحالات التي يمكن فيها عرض الوقت المقدَّر للوصول في حال عدم تحديد هذا الحقل، سيتم استخدام إعدادات إذن الوصول التلقائية على مستوى المشروع لهذه البيانات.

object (VisibilityOption)

الحقل الذي يحدّد الحالات التي يمكن فيها ظهور الوقت المقدَّر لإكمال المهمة في حال عدم تحديد هذا الحقل، سيتم استخدام الإعدادات التلقائية لمستوى مستوى المشروع لمستوى مستوى المشروع لهذه البيانات.

object (VisibilityOption)

الحقل الذي يحدّد الحالات التي يمكن فيها عرض المسافة المتبقّية للقيادة في حال عدم تحديد هذا الحقل، سيتم استخدام الإعدادات التلقائية لمستوى مستوى المشروع لمستوى مستوى المشروع لهذه البيانات.

object (VisibilityOption)

الحقل الذي يحدد عدد مرات التوقّف المتبقية ويظهر فيه. في حال عدم تحديد هذا الحقل، سيتم استخدام الإعدادات التلقائية لمستوى مستوى المشروع لمستوى مستوى المشروع لهذه البيانات.

object (VisibilityOption)

الحقل الذي يحدِّد الحالات التي يمكن فيها ظهور الموقع الجغرافي للمركبة في حال عدم تحديد هذا الحقل، سيتم استخدام الإعدادات التلقائية لمستوى مستوى المشروع لمستوى مستوى المشروع لهذه البيانات.

{

  // Union field visibility_option can be only one of the following:
  "remainingStopCountThreshold": integer,
  "durationUntilEstimatedArrivalTimeThreshold": string,
  "remainingDrivingDistanceMetersThreshold": integer,
  "always": boolean,
  "never": boolean
  // End of list of possible types for union field visibility_option.
}

integer

يكون عنصر البيانات هذا مرئيًا للمستخدمين إذا كان عدد مرات التوقف المتبقي <=COUNTStopCountThreshold.

string (Duration format)

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

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"

integer

يظهر عنصر البيانات هذا للمستخدمين النهائيين إذا كانت المسافة المتبقية للقيادة بالكيلومترات <= remainingDrivingDistanceMetersThreshold.

boolean

في حال ضبط عنصر البيانات هذا على "صحيح"، سيظهر دائمًا للمستخدمين النهائيين بدون حدود. لا يمكن ضبط هذا الحقل على "خطأ".

boolean

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