SearchVehiclesResponse

رسالة رد واحدة (vehicles.search)

تمثيل JSON 
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
الحقول
matches[]

object (VehicleMatch)

قائمة بالمركبات التي تستوفي معايير SearchVehiclesRequest، مرتّبة وفقًا للحقل SearchVehiclesRequest.order_by

VehicleMatch

يحتوي على المركبة والتقديرات ذات الصلة للمركبة التي تتطابق مع نقاط الرحلات النشطة للمركبة SearchVehiclesRequest.

تمثيل JSON 
{
  "vehicle": {
    object (Vehicle)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripType),
  "vehicleTripsWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "vehicleMatchType": enum (VehicleMatchType),
  "requestedOrderedBy": enum (VehicleMatchOrder),
  "orderedBy": enum (VehicleMatchOrder)
}
الحقول
vehicle

object (Vehicle)

مطلوبة. مركبة تتطابق مع الطلب.
vehiclePickupEta

string (Timestamp format)

تشير هذه السمة إلى الوقت المقدَّر للوصول للقيادة في المركبة إلى نقطة الاستلام المحدّدة في الطلب. تشير القيمة الفارغة إلى تعذّر احتساب الوقت المقدّر للوصول للمركبة. إذا كانت قيمة الحقل "SearchVehiclesRequest.include_back_to_back" هي true وكانت هذه المركبة تسير في مسارها، يتضمّن العمود "vehiclePickupEta" الوقت المطلوب لإكمال الرحلة النشطة الحالية.

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

integer

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

integer

مطلوبة. هذه السمة تعرض المسافة المستقيمة بين المركبة ونقطة الاستلام المحدّدة في الطلب.
vehicleDropoffEta

string (Timestamp format)

الوقت المقدّر للوصول للمركبة بالكامل إلى نقطة التسليم المحدَّدة في الطلب. ويشمل الوقت المقدّر للوصول التوقف عند أي نقاط طريق قبل dropoffPoint المحدّدة في الطلب. لن تتم تعبئة القيمة إلا عند تحديد نقطة تسليم في الطلب. تشير القيمة الفارغة إلى حدوث خطأ في حساب الوقت المقدر للوصول.

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

integer

مسافة قيادة المركبة (بالمتر) من نقطة الاستلام إلى نقطة التسليم المحدّدة في الطلب وتكون المسافة بين النقطتين فقط ولا تشمل الموقع الجغرافي للمركبة أو أي نقاط أخرى يجب زيارتها قبل أن تزور المركبة نقطة الاستلام أو نقطة التسليم. ولن تتم تعبئة القيمة إلا عند تحديد dropoffPoint في الطلب. تشير القيمة الفارغة إلى تعذّر احتساب المسافة من نقطة الاستلام إلى نقطة التسليم المحدّدة في الطلب.
tripType

enum (TripType)

مطلوبة. تمثّل هذه السمة نوع الرحلة للطلب الذي تم استخدامه لحساب الوقت المقدّر للوصول إلى نقطة الاستلام.
vehicleTripsWaypoints[]

object (Waypoint)

يشير ذلك المصطلح إلى قائمة مرتّبة لنقاط الطريق المستخدَمة لحساب الوقت المقدَّر للوصول. تشمل القائمة الموقع الجغرافي للمركبة ونقاط استلام الرحلات النشطة للمركبة ونقاط الاستلام الواردة في الطلب. تشير القائمة الفارغة إلى تعذُّر احتساب الوقت المقدّر للوصول للمركبة.
vehicleMatchType

enum (VehicleMatchType)

نوع مطابقة المركبة
requestedOrderedBy

enum (VehicleMatchOrder)

الطلب المطلوب لترتيب تطابقات المركبات.
orderedBy

enum (VehicleMatchOrder)

الطلب الفعلي الذي تم استخدامه لهذه المركبة. سيتطابق هذا عادةً مع الحقل "orderBy" في الطلب، ولكن في حالات معيّنة، مثل حدوث خطأ داخلي في الخادم، يمكن استخدام طريقة مختلفة (مثل PICKUP_POINT_STRAIGHT_DISTANCE).

النقطة الوسيطة

لوصف النقاط المتوسطة على طول مسار VehicleMatch في SearchVehiclesResponse. ويتم تمثيل هذا المفهوم بعلامة TripWaypoint في جميع نقاط النهاية الأخرى.

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

object (LatLng)

موقع نقطة الطريق هذه.
eta

string (Timestamp format)

تمثل هذه السمة الوقت المقدَّر الذي ستصل فيه المركبة إلى نقطة الطريق هذه.

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

VehicleMatchType

نوع مطابقة المركبة

عمليات التعداد
UNKNOWN نوع مطابقة غير معروف للمركبة
EXCLUSIVE لم يتم تعيين رحلة للمركبة في الوقت الحالي ويمكنها المتابعة إلى نقطة الاستلام.
BACK_TO_BACK المركبة مخصّصة حاليًا لرحلة، ولكن يمكن المتابعة إلى نقطة الاستلام بعد إكمال الرحلة التي لا تزال قيد التقدّم. تأخذ حسابات الوقت المقدر للوصول والمسافة الرحلة الحالية في الاعتبار.
CARPOOL سعة المركبة كافية.
CARPOOL_BACK_TO_BACK ستُكمل المركبة رحلتها الحالية النشطة قبل المتابعة إلى نقطة الاستلام. تأخذ حسابات الوقت المقدر للوصول والمسافة الرحلة الحالية في الاعتبار.