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)

يقصر البحث على المركبات التي تشمل سمة واحدة على الأقل من السمات المحددة المطبّقة على كل AutomotiveAttributeList.

requiredOneOfAttributeSets[]

object (VehicleAttributeListLog)

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

matchOrderBy

enum (VehicleMatchOrderLog)

ترتيب نتيجة البحث

includeBackToBack

boolean

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

tripId

string

رقم تعريف الرحلة المرتبطة بطلب searchVehiclesRequest.

filter

string

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

VehicleAttributeListLog

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

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

object (VehicleAttributeLog)

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

SearchVehiclesResponseLog

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

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

string

مهملة: قائمة بأرقام تعريف المركبات التي تم إرجاعها يُرجى استخدام Sync.vehicle.name للحصول على هذا المعرّف.

matches[]

object (VehicleMatchLog)

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

VehicleMatchLog

سجلّ نتيجة SearchVehicles CompanyMatch.

تمثيل 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)

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

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

vehiclePickupDistanceMeters

integer

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

vehiclePickupStraightLineDistanceMeters

integer

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

vehicleDropoffEta

string (Timestamp format)

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

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

vehiclePickupToDropoffDistanceMeters

integer

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

tripType

enum (TripTypeLog)

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

vehicleMatchType

enum (VehicleMatchTypeLog)

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

requestedOrderedBy

enum (VehicleMatchOrderLog)

الطريقة التي طلبها المتصل لترتيب النتائج المطابقة للمركبات.

orderedBy

enum (VehicleMatchOrderLog)

هذه هي الطريقة الفعلية المستخدمة لطلب هذه المركبة. وعادةً ما يتطابق هذا مع الحقل "order_by" في الطلب. ومع ذلك، في بعض الحالات مثل فشل الخلفيات في "خرائط Google"، قد يتم استخدام طريقة مختلفة (مثل PICKUP_POINT_STRAIGHT_DISTANCE).