REST Resource: providers.trips

{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}

string

النتائج فقط. بالتنسيق "providers/{provider}/trips/{trip}"

string

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

enum (TripStatus)

حالة الرحلة الحالية.

enum (TripType)

نوع الرحلة.

object (TerminalLocation)

الموقع الجغرافي الذي يشير فيه العميل إلى أنّه سيتم استلامه

object (StopLocation)

الإدخال فقط. الموقع الجغرافي الفعلي حيث تم نقل العميل إلى مكانه وزمانه هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات وآراء حول معلومات الاستلام الفعلية.

object (StopLocation)

الإدخال فقط. الوقت والموقع الجغرافي الفعلي لوصول السائق إلى نقطة الاستلام. هذا الحقل مخصَّص لتقديم ملاحظات عن معلومات الوصول الفعلية إلى نقطة الاستلام.

string (Timestamp format)

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

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

object (TerminalLocation)

يتوقف وسيط على إجراء طلبات الرحلة (بالإضافة إلى الاستلام والمغادرة). في البداية، لن يكون هذا الخيار متاحًا للرحلات المشترَكة.

string (Timestamp format)

يشير إلى آخر مرة تم فيها تعديل intermediateDestinations. يجب أن يخزّن الخادم هذه القيمة مؤقتًا وأن يمرِّرها في UpdateTripRequest عند تحديث intermediateDestinationIndex لضمان عدم تغيير intermediateDestinations.

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

integer

عندما تكون قيمة الحقل "TripStatus" هي ENROUTE_TO_INTERMEDIATE_DESTINATION، يكون رقم يتراوح بين [0..N-1] يشير إلى الوجهة الوسيطة التي ستقطعها المركبة بعد ذلك. عندما تكون قيمة السمة TripStatus هي ARRIVED_AT_INTERMEDIATE_DESTINATION، يشير الرقم بين [0..N-1] إلى الوجهة الوسيطة التي تنطلق إليها المركبة. يضبط المزوّد هذه القيمة. وفي حال عدم توفُّر intermediateDestinations، يتم تجاهل هذا الحقل.

object (StopLocation)

الإدخال فقط. الوقت والموقع الفعلي لوصول السائق إلى وجهة وسيطة. هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات عن معلومات الوصول الفعلية إلى وجهات وسيطة.

object (StopLocation)

الإدخال فقط. تمثّل هذه السمة الوقت والمكان الفعليَين حيث تم اختيار العميل من وجهة وسيطة ومكانه. هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات وآراء حول معلومات الاستلام الفعلية في الوجهات المتوسطة.

object (TerminalLocation)

الموقع الجغرافي الذي يشير فيه العميل إلى أنه سيتم تسليمه.

object (StopLocation)

الإدخال فقط. الوقت والمكان الفعليين لإنزال العميل ومكان تسليمه. هذا الحقل مخصص لمقدم الخدمة لتقديم ملاحظات وآراء عن معلومات الانسحاب الفعلية.

string (Timestamp format)

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

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

object (TripWaypoint)

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

object (TripWaypoint)

يتيح هذا الحقل الترتيب اليدوي لنقاط الطريق الخاصة بالرحلة. يتضمّن الملف جميع نقاط الطريق المتبقية للمركبة المخصصة لها، بالإضافة إلى نقاط طرق الاستلام والتسليم لهذه الرحلة. في حال لم يتم تعيين الرحلة لمركبة، سيتجاهل Fleet Engine هذا الحقل. لأسباب تتعلق بالخصوصية، تتم تعبئة هذا الحقل عن طريق الخادم في مكالمات trips.update وtrips.create فقط، وليس في مكالمات trips.get.

object (LatLng)

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

string

النتائج فقط. مسار مُشفَّر إلى نقطة الطريق التالية.

ملاحظة: هذا الحقل مخصّص فقط للاستخدام من قِبل "حزمة تطوير البرامج (SDK) لبرنامج التشغيل" و"حزمة تطوير البرامج (SDK) للمستهلك". لا تتوفّر إمكانية فك الترميز بعد.

string (Timestamp format)

النتائج فقط. يشير إلى آخر مرة تم فيها تعديل المسار.

ملاحظة: هذا الحقل مخصّص فقط للاستخدام من قِبل "حزمة تطوير البرامج (SDK) لبرنامج التشغيل" و"حزمة تطوير البرامج (SDK) للمستهلك".

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

object (ConsumableTrafficPolyline)

النتائج فقط. تشير إلى ظروف حركة المرور على طول currentRouteSegment عندما تكون متاحة.

ملاحظة: هذا الحقل مخصّص فقط للاستخدام من قِبل "حزمة تطوير البرامج (SDK) لبرنامج التشغيل" و"حزمة تطوير البرامج (SDK) للمستهلك".

string (Timestamp format)

النتائج فقط. يشير إلى آخر مرة تم فيها تعديل currentRouteSegmentTraffic.

ملاحظة: هذا الحقل مخصّص فقط للاستخدام من قِبل "حزمة تطوير البرامج (SDK) لبرنامج التشغيل" و"حزمة تطوير البرامج (SDK) للمستهلك".

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

object (TripWaypoint)

النتائج فقط. النقطة التي ينتهي عندها currentRouteSegment.

integer

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

string (Timestamp format)

النتائج فقط. الوقت المقدر للوصول إلى نقطة الطريق التالية (الإدخال الأول في حقل remainingWaypoints). تكون القيمة غير محدّدة إذا لم يتم تخصيص الرحلة لمركبة أو إذا كانت الرحلة غير نشطة (مكتملة أو ملغاة).

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

string (Duration format)

النتائج فقط. المدة بدءًا من إرجاع بيانات الرحلة إلى الوقت في Trip.eta_to_first_waypoint. تكون القيمة غير محدّدة إذا لم يتم تخصيص الرحلة لمركبة أو إذا كانت الرحلة غير نشطة (مكتملة أو ملغاة).

مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ "s". مثال: "3.5s".

string (Timestamp format)

النتائج فقط. يشير إلى آخر مرة تم فيها تغيير remainingWaypoints (تمت إضافة نقطة طريق أو إزالتها أو تغييرها).

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

string (Timestamp format)

النتائج فقط. يشير إلى آخر مرة تم فيها تعديل remainingWaypoints.path_to_waypoint وremainingWaypoints.traffic_to_waypoint. يجب أن يخزّن تطبيق العميل هذه القيمة مؤقتًا وتمريرها في GetTripRequest لضمان عرض المسارات والزيارات لـ remainingWaypoints فقط في حال تعديلها.

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

integer

غير قابل للتغيير. تشير هذه القيمة إلى عدد الركاب في هذه الرحلة ولا تشمل السائق. يجب أن تتوفّر للمركبة القدرة على إرجاعها بعد الاستجابة vehicles.search.

object (VehicleLocation)

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

boolean

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

enum (TripView)

المجموعة الفرعية من حقول الرحلة التي تتم تعبئتها وكيفية تفسيرها.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

مطلوبة. تشير إلى الموقع الجغرافي الفعلي.

string (Timestamp format)

تشير هذه السمة إلى وقت حدوث التوقّف.

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

string (Timestamp format)

الإدخال فقط. تمّ الإيقاف. استخدام حقل الطابع الزمني

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