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) ​​для всех активных задач, назначенных Транспортному средству.

В некоторых случаях это поле может не использоваться для заполнения 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 .

Это поле игнорируется при вызовах deliveryVehicles.patch , если поле currentRouteSegment пусто.

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 , назначенных средству доставки.

Fleet Engine игнорирует это поле в UpdateDeliveryVehicleRequest , если поле currentRouteSegment пусто.

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) ​​для всех активных задач, назначенных средству доставки.

Fleet Engine игнорирует это поле в UpdateDeliveryVehicleRequest , если поле currentRouteSegment пусто.

Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « 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

Значение атрибута с двойным типом.