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)

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

object (VehicleAttributeListLog)

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

enum (VehicleMatchOrderLog)

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

boolean

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

string

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

string

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

VehicleAttributeListLog

تمثّل هذه السمة نوع بيانات قائمة بالعناصر لـ AutomotiveAttributeLog.

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

object (VehicleAttributeLog)

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

SearchVehiclesResponseLog

تفاصيل حول ردّ SearchVehicles

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

string

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

object (VehicleMatchLog)

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

VehicleMatchLog

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

تمثيل 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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
vehiclePickupDistanceMeters

integer

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

integer

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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).