REST Resource: providers.deliveryVehicles

{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}

string

نام منحصر به فرد این وسیله نقلیه تحویلی. قالب providers/{provider}/deliveryVehicles/{vehicle} است.

object ( DeliveryVehicleLocation )

آخرین مکان گزارش شده از وسیله نقلیه تحویل.

enum ( DeliveryVehicleNavigationStatus )

وضعیت ناوبری وسیله نقلیه تحویلی.

string ( bytes format)

چند خط کدگذاری شده مسیری را که ناوبری توصیه می‌کند تا ایستگاه بعدی انتخاب کنید را مشخص می‌کند. برنامه درایور شما این را با رسیدن به ایستگاه یا عبور از آن و هنگامی که مسیریابی تغییر مسیر می دهد، به روز می کند. این LatLng ها در Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) یا Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) ​​برای همه Tasks های فعال اختصاص داده شده به وسیله نقلیه بازگردانده می شوند.

چند مورد وجود دارد که ممکن است از این فیلد برای پر کردن Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) یا Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) ​​استفاده نشود:

• نقطه پایانی currentRouteSegment DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) یا DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST) ​​مطابقت ندارد.

• برنامه درایور اخیراً مکان خود را به‌روزرسانی نکرده است، بنابراین آخرین مقدار به‌روزرسانی‌شده برای این فیلد ممکن است قدیمی باشد.

• برنامه راننده اخیراً مکان خود را به‌روزرسانی کرده است، اما currentRouteSegment قدیمی است و به توقف قبلی وسیله نقلیه اشاره می‌کند.

در این موارد، Fleet Engine این فیلد را با مسیری از VehicleStop اخیراً تصویب شده تا VehicleStop آینده پر می‌کند تا اطمینان حاصل کند که مصرف‌کننده این فیلد بهترین اطلاعات موجود در مسیر فعلی خودروی تحویل را دارد.

رشته ای با کد base64.

object ( LatLng )

مکانی که در آن currentRouteSegment به پایان می رسد. این در حال حاضر توسط برنامه راننده پر نشده است، اما می توانید آن را در تماس های deliveryVehicles.patch ارائه کنید. این یا LatLng از توقف خودروی آینده است، یا آخرین LatLng از currentRouteSegment . سپس Fleet Engine تمام تلاش خود را برای درون یابی به یک VehicleStop واقعی انجام می دهد.

اگر قسمت currentRouteSegment خالی باشد، این فیلد در تماس های deliveryVehicles.patch نادیده گرفته می شود.

integer

مسافت رانندگی باقیمانده برای قطعه currentRouteSegment . برنامه Driver معمولاً این فیلد را فراهم می کند، اما برخی شرایط وجود دارد که در آن Fleet Engine مقدار ارسال شده توسط برنامه را لغو می کند. برای اطلاعات بیشتر، به DeliveryVehicle.current_route_segment مراجعه کنید. این فیلد در Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) یا Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) ​​برای همه Task فعال اختصاص داده شده به وسیله نقلیه تحویل داده شده است.

اگر قسمت currentRouteSegment خالی باشد، Fleet Engine این فیلد را در UpdateDeliveryVehicleRequest نادیده می گیرد.

string ( Duration format)

زمان باقیمانده رانندگی برای قطعه currentRouteSegment . برنامه Driver معمولاً این فیلد را فراهم می کند، اما برخی شرایط وجود دارد که در آن Fleet Engine مقدار ارسال شده توسط برنامه را لغو می کند. برای اطلاعات بیشتر، به DeliveryVehicle.current_route_segment مراجعه کنید. این فیلد در Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) یا Task.remainingVehicleJourneySegments[0].drivingDuration (REST) ​​برای همه وظایف فعال اختصاص داده شده به وسیله نقلیه تحویل داده شده است.

اگر قسمت currentRouteSegment خالی باشد، Fleet Engine این فیلد را در UpdateDeliveryVehicleRequest نادیده می گیرد.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

object ( VehicleJourneySegment )

بخش های سفر اختصاص داده شده به این وسیله نقلیه تحویل، از آخرین مکان گزارش شده خودرو شروع می شود. این فیلد در پاسخ deliveryVehicles.list پر نخواهد شد.

object ( DeliveryVehicleAttribute )

فهرستی از ویژگی‌های خودروی تحویل سفارشی. یک وسیله نقلیه تحویل حداکثر می تواند 100 ویژگی داشته باشد و هر ویژگی باید یک کلید منحصر به فرد داشته باشد.

enum ( DeliveryVehicleType )

نوع این وسیله نقلیه تحویلی. اگر تنظیم نشود، به طور پیش‌فرض روی AUTO خواهد بود.

{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}

string

کلید ویژگی

string

مقدار ویژگی

string

مقدار مشخصه را رشته ای تایپ کرد.

توجه: این همان فیلد value است که در نهایت منسوخ خواهد شد. برای ایجاد یا به‌روزرسانی روش‌ها، می‌توان از هر یک از فیلدها استفاده کرد، اما اکیداً توصیه می‌شود از stringValue استفاده کنید. اگر هم stringValue و هم value تنظیم شده باشند، باید یکسان باشند وگرنه خطایی ایجاد می شود. هر دو فیلد در پاسخ ها پر شده اند.

boolean

مقدار مشخصه تایپ شده بولی.

number

مقدار مشخصه را دوبار تایپ کرد.