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)

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

object (LatLng)

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

string

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

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

string (Timestamp format)

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

ملاحظة: هذا الحقل مخصّص فقط لاستخدام حِزم تطوير البرامج (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) الخاصة بالسائقين والمستهلكين.

يجب أن يكون طابعًا زمنيًا بالتنسيق 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".