REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

Только вывод. Уникальное имя для этого автомобиля. Формат: providers/{provider}/vehicles/{vehicle} .

enum ( VehicleState )

Состояние автомобиля.

enum ( TripType )

Типы поездок, поддерживаемые этим автомобилем.

string

Только вывод. Список tripId для поездок, назначенных в данный момент этому транспортному средству.

object ( VehicleLocation )

Последнее сообщенное местонахождение автомобиля.

integer

Общее количество пассажиров, которое может перевозить этот автомобиль. Драйвер не учитывается в этом значении. Это значение должно быть больше или равно единице.

object ( VehicleAttribute )

Список характеристик автомобиля. Транспортное средство может иметь не более 100 атрибутов, и каждый атрибут должен иметь уникальный ключ.

object ( VehicleType )

Необходимый. Тип этого автомобиля. Может использоваться для фильтрации транспортных средств в результатах vehicles.search . Также влияет на расчет расчетного времени прибытия и маршрута.

object ( LicensePlate )

Информация о номерном знаке автомобиля.

object ( TerminalLocation )

Устарело: вместо этого используйте Vehicle.waypoints .

string

Полилиния, определяющая маршрут, по которому приложение водителя намерено пройти до следующей путевой точки. Этот список также возвращается в Trip.current_route_segment для всех активных поездок, назначенных транспортному средству.

Примечание. Это поле предназначено только для использования Driver SDK. Декодирование пока не поддерживается.

object ( TrafficPolylineData )

Только ввод. Fleet Engine использует эту информацию для улучшения обмена информацией о поездках. Примечание. Это поле предназначено только для использования Driver SDK.

string ( Timestamp format)

Только вывод. Время установки currentRouteSegment . Он может храниться клиентом и передаваться в будущих запросах vehicles.get , чтобы предотвратить возвращение маршрутов, которые не изменились.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

object ( TripWaypoint )

Путевая точка, где заканчивается currentRouteSegment . Водители могут предоставить его при вызове vehicles.update либо как полную точку маршрута, либо как точку LatLng , либо как последнюю LatLng из currentRouteSegment . Затем Fleet Engine сделает все возможное, чтобы интерполировать фактическую путевую точку, если она не указана полностью. Это поле игнорируется в вызовах vehicles.update , если не указан также currentRouteSegment .

integer

Оставшееся расстояние поездки для currentRouteSegment . Это значение также возвращается в Trip.remaining_distance_meters для всех активных поездок, назначенных транспортному средству. Значение не указано, если поле currentRouteSegment пусто.

string ( Timestamp format)

Расчетное время прибытия до первой записи в поле waypoints . Значение не указано, если поле waypoints пусто или поле Vehicle.current_route_segment пусто.

При обновлении транспортного средства remainingTimeSeconds имеет приоритет над etaToFirstWaypoint в том же запросе.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

integer

Только ввод. Оставшееся время в пути для currentRouteSegment . Значение не указано, если поле waypoints пусто или поле Vehicle.current_route_segment пусто. Это значение должно соответствовать etaToFirstWaypoint — current_time если все стороны используют одни и те же часы.

При обновлении транспортного средства remainingTimeSeconds имеет приоритет над etaToFirstWaypoint в том же запросе.

object ( TripWaypoint )

Остальные путевые точки назначены этому Транспортному средству.

string ( Timestamp format)

Только вывод. Последний раз поле waypoints обновлялось. Клиенты должны кэшировать это значение и передавать его в GetVehicleRequest , чтобы гарантировать, что поле waypoints возвращается только в случае его обновления.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

boolean

Указывает, согласен ли водитель на двусторонние поездки. Если true , vehicles.search может включать транспортное средство, даже если оно в настоящее время назначено для поездки. Значение по умолчанию — false .

enum ( NavigationStatus )

Статус навигации автомобиля.

object ( DeviceSettings )

Только ввод. Информация о настройках мобильного устройства, используемого водителем.

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

  // Union field 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 vehicle_attribute_value.
}

string

Ключ атрибута. Ключи не могут содержать символ двоеточия (:).

string

Значение атрибута.

string

Значение атрибута строкового типа.

Примечание. Это идентично полю value , которое со временем станет устаревшим. Для методов создания или обновления можно использовать любое поле, но настоятельно рекомендуется использовать stringValue . Если установлены и stringValue , и value , они должны быть идентичными, иначе будет выдана ошибка. Оба поля заполняются в ответах.

boolean

Значение атрибута логического типа.

number

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

{
  "category": enum (Category)
}

enum ( Category )

Категория типа транспортного средства

{
  "countryCode": string,
  "lastCharacter": string
}

string

Необходимый. Код страны/региона CLDR. Например, US для США или IN для Индии.

string

Последняя цифра номерного знака или «-1», обозначающая отсутствие числового значения, присутствует в номерном знаке.

• «АВС 1234» -> «4»
• «АБ 123 CD» -> «3»
• «ABCDEF» -> «-1»

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object ( VisualTrafficReportPolylineRendering )

Полилинейное отображение скорости движения во всех регионах на одном участке поездки клиента.

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object ( RoadStretch )

Необязательный. Участки дороги, которые необходимо отрисовать вдоль полилинии. Участки гарантированно не перекрываются и не обязательно охватывают весь маршрут.

При отсутствии изменения стиля дороги клиент должен применить к маршруту значение по умолчанию.

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum ( Style )

Необходимый. Стиль, который нужно применить.

integer

Необходимый. Стиль следует применять между [offsetMeters, offsetMeters + lengthMeters) .

integer

Необходимый. Длина пути, к которому применяется стиль.

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum ( LocationPowerSaveMode )

Как функции определения местоположения настроены на работу на устройстве при включенной функции экономии заряда батареи.

boolean

Находится ли устройство в настоящее время в режиме энергосбережения.

boolean

Находится ли устройство в интерактивном состоянии.

object ( BatteryInfo )

Информация о состоянии батареи.

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum ( BatteryStatus )

Состояние аккумулятора: полный или заряжающийся и т. д.

enum ( PowerSource )

Состояние источника питания аккумулятора.

number

Текущий процент заряда батареи [0-100].