SearchVehiclesLog

تفاصيل حول طلب SearchVehicles والاستجابة له

ملاحظة: يخضع هذا السجلّ للتقسيم على حقل المطابقات إذا تجاوز إجمالي حجم السجلّ 256 كيلوبايت. يمكنك الاطّلاع على تقسيم السجلّات لمزيد من التفاصيل.

تمثيل JSON 
{
  "request": {
    object (SearchVehiclesRequestLog)
  },
  "response": {
    object (SearchVehiclesResponseLog)
  },
  "errorResponse": {
    object (ErrorResponseLog)
  }
}
الحقول
request

object (SearchVehiclesRequestLog)

تم إرسال الطلب إلى Fleet Engine.
response

object (SearchVehiclesResponseLog)

الاستجابة التي تم إرجاعها إلى العميل إذا أدّى طلب RPC إلى حدوث خطأ، لن يتم ضبط الاستجابة.
errorResponse

object (ErrorResponseLog)

استجابة الخطأ التي تم عرضها للعميل سيتم إلغاء ضبطه في حال نجاح طلب RPC.

SearchVehiclesRequestLog

تفاصيل حول طلب SearchVehicles

تمثيل JSON 
{
  "header": {
    object (RequestHeaderLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "searchTripTypes": [
    enum (TripTypeLog)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleTypeLog)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttributeLog)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "matchOrderBy": enum (VehicleMatchOrderLog),
  "includeBackToBack": boolean,
  "tripId": string,
  "filter": string
}
الحقول
header

object (RequestHeaderLog)

عنوان الطلب
pickupPoint

object (TerminalLocationLog)

نقطة الاستلام التي تريد البحث بالقرب منها
dropoffPoint

object (TerminalLocationLog)

الموقع الجغرافي المقصود لتسليم الطلب من قِبل العميل
pickupRadiusMeters

integer

تُستخدَم لتحديد نطاق البحث عن المركبات حول نقطة الاستلام.
count

integer

تُستخدَم لتحديد الحد الأقصى لعدد المركبات التي سيتم عرضها.
minimumCapacity

integer

لتحديد الحد الأدنى المطلوب لسعة المركبة.
searchTripTypes[]

enum (TripTypeLog)

يحصر البحث في المركبات التي تتيح استخدام نوع واحد على الأقل من أنواع الرحلات المحدّدة.
maximumStaleness

string (Duration format)

يحصر البحث بالمركبات التي عدّلت مواقعها الجغرافية خلال المدة المحدّدة من الآن.

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

object (VehicleTypeLog)

أنواع المركبات التي يتم البحث عنها
requiredAttributes[]

object (VehicleAttributeLog)

يحدّ هذا الخيار من البحث ليشمل المركبات التي تتضمّن السمات المحدّدة فقط.
requiredOneOfAttributes[]

object (VehicleAttributeListLog)

يحصر البحث في المركبات التي تحتوي على سمة واحدة على الأقل من السمات المحدّدة المطبّقة على كل VehicleAttributeList.
requiredOneOfAttributeSets[]

object (VehicleAttributeListLog)

يحصر البحث في المركبات التي تحتوي على مجموعة واحدة على الأقل من السمات المحدّدة في VehicleAttributeList.
matchOrderBy

enum (VehicleMatchOrderLog)

ترتيب نتائج البحث
includeBackToBack

boolean

يشير إلى ما إذا كانت المركبة التي لديها رحلة نشطة مؤهّلة لمطابقة أخرى.
tripId

string

معرّف الرحلة المرتبط بطلب البحث عن المركبات
filter

string

طلب بحث AIP-160 الذي يحدّ من المركبات المعروضة استنادًا إلى سمات المركبات

VehicleAttributeListLog

نوع بيانات قائمة قوائم لسمة VehicleAttributeLog

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

object (VehicleAttributeLog)

قائمة بالسمات في هذه المجموعة

SearchVehiclesResponseLog

تفاصيل حول استجابة SearchVehicles

تمثيل JSON 
{
  "matchIds": [
    string
  ],
  "matches": [
    {
      object (VehicleMatchLog)
    }
  ]
}
الحقول
matchIds[]
(deprecated)

string

تم إيقافها نهائيًا: قائمة أرقام تعريف المركبات التي تم إرجاعها يُرجى استخدام matches.vehicle.name لإنشاء هذا المعرّف.
matches[]

object (VehicleMatchLog)

قائمة بمطابقات المركبات للمركبات التي تم إرجاعها

VehicleMatchLog

سجلّ نتيجة VehicleMatch في SearchVehicles

تمثيل JSON 
{
  "vehicle": {
    object (VehicleLog)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripTypeLog),
  "vehicleMatchType": enum (VehicleMatchTypeLog),
  "requestedOrderedBy": enum (VehicleMatchOrderLog),
  "orderedBy": enum (VehicleMatchOrderLog)
}
الحقول
vehicle

object (VehicleLog)

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

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"
vehiclePickupDistanceMeters

integer

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

integer

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

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"
vehiclePickupToDropoffDistanceMeters

integer

المسافة التي تقطعها المركبة (بالمتر) من نقطة الاستلام إلى نقطة التسليم المحدّدة في الطلب المسافة هي بين النقطتَين فقط ولا تشمل موقع المركبة أو أي نقاط مسار أخرى قبل وصول المركبة إلى نقطة الاستلام أو نقطة التسليم. لن يتمّ ملء القيمة إلّا عند تحديد نقطة تسليم في الطلب. تشير القيمة الفارغة إلى تعذُّر احتساب المسافة من نقاط الاستلام إلى نقاط التسليم المحدّدة في الطلب.
tripType

enum (TripTypeLog)

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

enum (VehicleMatchTypeLog)

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

enum (VehicleMatchOrderLog)

الطريقة التي طلبها المتصل لترتيب مطابقات المركبات.
orderedBy

enum (VehicleMatchOrderLog)

الطريقة الفعلية المستخدَمة لطلب هذه المركبة. سيتطابق هذا عادةً مع حقل order_by من الطلب. ومع ذلك، في حالات معيّنة، مثل تعذُّر الوصول إلى خدمات "خرائط Google" الخلفية، قد يتم استخدام طريقة مختلفة (مثل PICKUP_POINT_STRAIGHT_DISTANCE).