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)

رانندگی ETA خودرو به نقطه تحویل مشخص شده در درخواست. مقدار خالی نشان دهنده نقص در محاسبه ETA برای خودرو است. اگر 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)

رانندگی کامل وسیله نقلیه تا نقطه سقوط مشخص شده در درخواست. ETA شامل توقف در هر نقطه بین راهی قبل از dropoffPoint مشخص شده در درخواست است. مقدار فقط زمانی پر می شود که یک نقطه رها کردن در درخواست مشخص شده باشد. مقدار خالی نشان دهنده خطا در محاسبه ETA است.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

vehiclePickupToDropoffDistanceMeters

integer

فاصله رانندگی وسیله نقلیه (بر حسب متر) از نقطه تحویل تا نقطه سقوط مشخص شده در درخواست. فاصله فقط بین دو نقطه است و شامل مکان وسیله نقلیه یا هر نقطه دیگری که باید قبل از بازدید وسیله نقلیه از نقطه تحویل و یا نقطه سقوط از آن بازدید شود، نمی شود. مقدار فقط زمانی پر می شود که یک dropoffPoint در درخواست مشخص شده باشد. یک مقدار خالی نشان دهنده خطا در محاسبه فاصله از پیکاپ تا نقطه خروج مشخص شده در درخواست است.

tripType

enum ( TripType )

ضروری. نوع سفر درخواستی که برای محاسبه ETA به نقطه تحویل استفاده شد.

vehicleTripsWaypoints[]

object ( Waypoint )

فهرست مرتب شده ای از نقاط مورد استفاده برای محاسبه ETA. این لیست شامل مکان وسیله نقلیه، نقاط وانت سفرهای فعال برای وسیله نقلیه و نقاط وانت ارائه شده در درخواست است. لیست خالی نشان دهنده نقص در محاسبه ETA برای خودرو است.

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

نوع مسابقه وسیله نقلیه

Enums
UNKNOWN نوع تطبیق وسیله نقلیه ناشناخته
EXCLUSIVE این وسیله نقلیه در حال حاضر هیچ سفری برای آن تعیین نشده است و می تواند به نقطه وانت ادامه دهد.
BACK_TO_BACK وسیله نقلیه در حال حاضر به یک سفر اختصاص داده شده است، اما می تواند پس از تکمیل سفر در حال انجام، به نقطه وانت ادامه دهد. ETA و محاسبات مسافت، سفر موجود را در نظر می گیرند.
CARPOOL این وسیله نقلیه دارای ظرفیت کافی برای یک سواری مشترک است.
CARPOOL_BACK_TO_BACK خودرو قبل از رفتن به نقطه وانت، سفر فعلی و فعال خود را به پایان خواهد رساند. ETA و محاسبات مسافت، سفر موجود را در نظر می گیرند.