TripLog

سجلّ مرجع "رحلة" في Fleet Engine

تمثيل JSON 
{
  "name": string,
  "status": enum (TripStatusLog),
  "tripType": enum (TripTypeLog),
  "vehicleId": string,
  "lastLocation": {
    object (VehicleLocationLog)
  },
  "currentRouteSegmentEndPoint": {
    object (TripWaypointLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "actualPickupPoint": {
    object (StopLocationLog)
  },
  "actualPickupArrivalPoint": {
    object (StopLocationLog)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocationLog)
    }
  ],
  "intermediateDestinationIndex": integer,
  "intermediateDestinationsVersion": string,
  "actualIntermediateDestinations": [
    {
      object (StopLocationLog)
    }
  ],
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocationLog)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "actualDropoffPoint": {
    object (StopLocationLog)
  },
  "dropoffTime": string,
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "numberOfPassengers": integer,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolylineLog)
  },
  "attributes": [
    {
      object (TripAttributeLog)
    }
  ]
}
الحقول
name

string

اسم مورد الرحلة بالتنسيق providers/{providerId}/trips/{tripId}.
status

enum (TripStatusLog)

حالة الرحلة
tripType

enum (TripTypeLog)

نوع الرحلة
vehicleId

string

معرّف المركبة التي تم إسناد الرحلة إليها.
lastLocation

object (VehicleLocationLog)

آخر موقع تم الإبلاغ عنه للمركبة على طول المسار
currentRouteSegmentEndPoint

object (TripWaypointLog)

نقطة الطريق التي تنتهي عندها currentRouteSegment
pickupPoint

object (TerminalLocationLog)

الموقع الجغرافي الذي يشير إليه العميل لكي يتم استلام الطلب منه
actualPickupPoint

object (StopLocationLog)

الموقع الجغرافي الفعلي الذي تم فيه استلام العميل
actualPickupArrivalPoint

object (StopLocationLog)

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

string (Timestamp format)

وقت تسليم العميل يمكن أن تكون في المستقبل أو في الماضي.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر التي لا تُعدّ "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
intermediateDestinations[]

object (TerminalLocationLog)

المحطات الوسيطة بالترتيب المطلوب (بالإضافة إلى محطتَي الاستلام والإرجاع)
intermediateDestinationIndex

integer

عندما يكون TripStatus هو ENROUTE_TO_INTERMEDIATE_DESTINATION، يكون رقمًا بين [0..N-1] يشير إلى الوجهة الوسيطة التي ستعبرها المركبة بعد ذلك. عندما تكون قيمة TripStatus هي ARRIVED_AT_INTERMEDIATE_DESTINATION، يكون رقمًا بين [0..N-1] يشير إلى الوجهة الوسيطة التي هي الموقع الجغرافي الحالي للمركبة.
intermediateDestinationsVersion

string (Timestamp format)

نسخة الوجهات الوسيطة المقدَّمة

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر التي لا تُعدّ "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
actualIntermediateDestinations[]

object (StopLocationLog)

الوقت والموقع الجغرافي الفعليان اللذان تم فيهما استلام العميل من وجهة وسيطة يتيح هذا الحقل لمقدّم الخدمة تقديم ملاحظات حول معلومات الاستلام الفعلية في الوجهات الوسيطة.
actualIntermediateDestinationArrivalPoints[]

object (StopLocationLog)

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

object (TerminalLocationLog)

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

object (StopLocationLog)

الموقع الجغرافي الفعلي الذي تم فيه إنزال العميل
dropoffTime

string (Timestamp format)

الوقت الذي سيتم فيه إنزال العميل أو تم إنزاله

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر التي لا تُعدّ "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
remainingDistanceMeters

integer

المسافة المتبقية للقيادة في جزء المسار الحالي
etaToFirstWaypoint

string (Timestamp format)

وقت الوصول المقدَّر إلى نقطة الطريق التالية (الإدخال الأول في حقل Trip.remaining_waypoints).

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر التي لا تُعدّ "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
remainingTimeToFirstWaypoint

string (Duration format)

الوقت المتبقّي للوصول إلى نقطة الطريق التالية (أول إدخال في الحقل Trip.remaining_waypoints).

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

integer

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

object (ConsumableTrafficPolylineLog)

أحوال حركة المرور على طول currentRouteSegment، عند توفّرها
attributes[]

object (TripAttributeLog)

قائمة بسمات الرحلة المخصّصة

StopLocationLog

الموقع الجغرافي الفعلي الذي يحدث فيه التوقف (للتقاط أو التسليم)

تمثيل JSON 
{
  "timestamp": string,
  "point": {
    object (LatLng)
  }
}
الحقول
timestamp

string (Timestamp format)

الطابع الزمني لتسجيل الموقع الجغرافي

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر التي لا تُعدّ "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
point

object (LatLng)

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

TripAttributeLog

سمة يتم التعبير عنها كزوج مفتاح/قيمة مرتبط برحلة

تمثيل JSON 
{
  "key": string,

  // Union field trip_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field trip_attribute_value.
}
الحقول
key

string

مفتاح السمة
حقل الربط trip_attribute_value يمكن أن تكون قيمة السمة من النوع string أو bool أو double. يمكن أن يكون trip_attribute_value واحدًا فقط مما يلي:
stringValue

string

قيمة سمة من النوع سلسلة
boolValue

boolean

قيمة سمة من النوع المنطقي
numberValue

number

قيمة سمة ذات نوعَين