REST Resource: providers.trips

Ресурс: Поездка

Метаданные поездки.

JSON-представление 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView),
  "attributes": [
    {
      object (TripAttribute)
    }
  ]
}
Поля
name

string

Только вывод. В формате "providers/{provider}/trips/{trip}"

vehicleId

string

Идентификатор транспортного средства, совершающего эту поездку.

tripStatus

enum ( TripStatus )

Текущий статус поездки.

tripType

enum ( TripType )

Тип поездки.

pickupPoint

object ( TerminalLocation )

Место, где клиент укажет, что его заберут.

actualPickupPoint

object ( StopLocation )

Только ввод. Фактическое место, где и когда был забран клиент. Это поле предназначено для поставщика, чтобы предоставить отзыв о фактической информации о забранном.

actualPickupArrivalPoint

object ( StopLocation )

Только ввод. Фактическое время и место прибытия водителя в пункт выдачи. Это поле предназначено для предоставления поставщиком обратной связи по фактической информации о прибытии в пункт выдачи.

pickupTime

string ( Timestamp format)

Только вывод. Либо предполагаемое будущее время, когда пассажир(ы) будут забраны, либо фактическое время, когда они были забраны.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

intermediateDestinations[]

object ( TerminalLocation )

Промежуточные остановки в порядке, который запрашивает поездка (в дополнение к посадке и высадке). Первоначально это не будет поддерживаться для совместных поездок.

intermediateDestinationsVersion

string ( Timestamp format)

Указывает последний раз, когда был изменен intermediateDestinations . Ваш сервер должен кэшировать это значение и передавать его в UpdateTripRequest при обновлении intermediateDestinationIndex , чтобы гарантировать, что intermediateDestinations не будет изменен.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

intermediateDestinationIndex

integer

Когда TripStatus равен ENROUTE_TO_INTERMEDIATE_DESTINATION , число в диапазоне [0..N-1], указывающее, какой промежуточный пункт назначения пересечет транспортное средство следующим. Когда TripStatus равен ARRIVED_AT_INTERMEDIATE_DESTINATION , число в диапазоне [0..N-1], указывающее, в каком промежуточном пункте назначения находится транспортное средство. Это значение устанавливает поставщик. Если intermediateDestinations нет, это поле игнорируется.

actualIntermediateDestinationArrivalPoints[]

object ( StopLocation )

Только ввод. Фактическое время и место прибытия водителя в промежуточный пункт назначения. Это поле предназначено для предоставления поставщиком обратной связи по фактической информации о прибытии в промежуточные пункты назначения.

actualIntermediateDestinations[]

object ( StopLocation )

Только ввод. Фактическое время и место, когда и где клиент был забран из промежуточного пункта назначения. Это поле предназначено для поставщика, чтобы предоставить обратную связь по фактической информации о забранных автомобилях в промежуточных пунктах назначения.

dropoffPoint

object ( TerminalLocation )

Место, где клиент укажет, что его высадят.

actualDropoffPoint

object ( StopLocation )

Только ввод. Фактическое время и место, где и когда был высажен клиент. Это поле предназначено для поставщика, чтобы предоставить отзыв о фактической информации о высадке.

dropoffTime

string ( Timestamp format)

Только вывод. Либо предполагаемое будущее время высадки пассажира(ов) в конечном пункте назначения, либо фактическое время высадки.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

remainingWaypoints[]

object ( TripWaypoint )

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

vehicleWaypoints[]

object ( TripWaypoint )

Это поле поддерживает ручное упорядочивание точек маршрута для поездки. Оно содержит все оставшиеся точки маршрута для назначенного транспортного средства, а также точки посадки и высадки для этой поездки. Если поездка не была назначена транспортному средству, то Fleet Engine игнорирует это поле. В целях конфиденциальности это поле заполняется сервером только при вызовах trips.update и trips.create , НО НЕ при вызовах trips.get .

route[]

object ( LatLng )

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

currentRouteSegment

string

Только вывод. Закодированный путь к следующей точке маршрута.

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

currentRouteSegmentVersion

string ( Timestamp format)

Только вывод. Указывает время последнего изменения маршрута.

Примечание: это поле предназначено только для использования Driver SDK и Consumer SDK.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

currentRouteSegmentTraffic

object ( ConsumableTrafficPolyline )

Только вывод. Указывает условия движения по currentRouteSegment , когда они доступны.

Примечание: это поле предназначено только для использования Driver SDK и Consumer SDK.

currentRouteSegmentTrafficVersion

string ( Timestamp format)

Только вывод. Указывает последний раз, когда currentRouteSegmentTraffic был изменен.

Примечание: это поле предназначено только для использования Driver SDK и Consumer SDK.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

currentRouteSegmentEndPoint

object ( TripWaypoint )

Только вывод. Точка маршрута, где заканчивается currentRouteSegment .

remainingDistanceMeters

integer

Только вывод. Оставшееся расстояние в поле currentRouteSegment . Значение не указано, если поездка не назначена на транспортное средство или поездка завершена или отменена.

etaToFirstWaypoint

string ( Timestamp format)

Только вывод. ETA до следующей точки маршрута (первая запись в поле remainingWaypoints ). Значение не указано, если поездка не назначена на транспортное средство или поездка неактивна (завершена или отменена).

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

remainingTimeToFirstWaypoint

string ( Duration format)

Только вывод. Длительность с момента возврата данных о поездке до времени в Trip.eta_to_first_waypoint . Значение не указано, если поездка не назначена транспортному средству или поездка неактивна (завершена или отменена).

Длительность в секундах с дробной частью до девяти цифр, заканчивающаяся на ' s '. Пример: "3.5s" .

remainingWaypointsVersion

string ( Timestamp format)

Только вывод. Указывает последний раз, когда remainingWaypoints был изменен (путевая точка была добавлена, удалена или изменена).

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

remainingWaypointsRouteVersion

string ( Timestamp format)

Только вывод. Указывает последний раз, когда remainingWaypoints.path_to_waypoint и remainingWaypoints.traffic_to_waypoint были изменены. Ваше клиентское приложение должно кэшировать это значение и передавать его в GetTripRequest , чтобы гарантировать, что пути и трафик для remainingWaypoints возвращаются только в случае обновления.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

numberOfPassengers

integer

Неизменяемый. Указывает количество пассажиров в этой поездке и не включает водителя. Транспортное средство должно иметь доступную вместимость для возврата в ответе vehicles.search .

lastLocation

object ( VehicleLocation )

Только вывод. Указывает последнее сообщенное местоположение транспортного средства на маршруте.

lastLocationSnappable

boolean

Только вывод. Указывает, можно ли привязать lastLocation транспортного средства к currentRouteSegment. False, если lastLocation или currentRouteSegment не существует. Вычисляется Fleet Engine. Любые обновления от клиентов будут игнорироваться.

view

enum ( TripView )

Подмножество полей Trip, которые заполняются, и способ их интерпретации.

attributes[]

object ( TripAttribute )

Список пользовательских атрибутов Trip. Каждый атрибут должен иметь уникальный ключ.

TripStatus

Статус поездки, указывающий на ее ход.

Перечисления
UNKNOWN_TRIP_STATUS По умолчанию используется для неуказанного или нераспознанного статуса поездки.
NEW Недавно созданная поездка.
ENROUTE_TO_PICKUP Водитель едет к месту посадки.
ARRIVED_AT_PICKUP Водитель прибыл в пункт посадки.
ARRIVED_AT_INTERMEDIATE_DESTINATION Водитель прибыл в промежуточный пункт назначения и ждет пассажира.
ENROUTE_TO_INTERMEDIATE_DESTINATION Водитель направляется в промежуточный пункт назначения (не в пункт высадки).
ENROUTE_TO_DROPOFF Водитель подобрал пассажира и едет в следующий пункт назначения.
COMPLETE Пассажир высажен, поездка завершена.
CANCELED Поездка была отменена до момента посадки водителем, пассажиром или поставщиком услуг совместных поездок.

ОстановкаМестоположение

Фактическое место остановки (посадки/высадки).

JSON-представление 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Поля
point

object ( LatLng )

Обязательно. Обозначает фактическое местоположение.

timestamp

string ( Timestamp format)

Указывает, когда произошла остановка.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

stopTime
(deprecated)

string ( Timestamp format)

Только ввод. Устарело. Используйте поле метки времени.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

TripView

Селектор для различных наборов полей Trip в ответе trips.get . См. AIP-157 для контекста. Вероятно, будут добавлены дополнительные представления.

Перечисления
TRIP_VIEW_UNSPECIFIED Значение по умолчанию. Для обратной совместимости API по умолчанию будет использовать вид SDK. Для обеспечения стабильности и поддержки клиентам рекомендуется выбирать TripView , отличный от SDK .
SDK Включает поля, которые могут быть неинтерпретируемыми или неподдерживаемыми с использованием общедоступных библиотек.
JOURNEY_SHARING_V1S Поля Trip заполняются для варианта использования Journey Sharing. Это представление предназначено для связи сервер-сервер.

Атрибут поездки

Описывает атрибут поездки как пару ключ-значение. Длина строки "ключ:значение" не может превышать 256 символов.

JSON-представление 
{
  "key": string,

  // Union field trip_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field trip_attribute_value.
}
Поля
key

string

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

Поле объединения trip_attribute_value . Значение атрибута может быть строковым, логическим или двойным. trip_attribute_value может быть только одним из следующих:
stringValue

string

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

boolValue

boolean

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

numberValue

number

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

Методы

create

 Создает рейс в Fleet Engine и возвращает новый рейс.

delete

 Удаляет одну поездку.

get

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

update

 Обновляет данные о поездке.
,

Ресурс: Поездка

Метаданные поездки.

JSON-представление 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView),
  "attributes": [
    {
      object (TripAttribute)
    }
  ]
}
Поля
name

string

Только вывод. В формате "providers/{provider}/trips/{trip}"

vehicleId

string

Идентификатор транспортного средства, совершающего эту поездку.

tripStatus

enum ( TripStatus )

Текущий статус поездки.

tripType

enum ( TripType )

Тип поездки.

pickupPoint

object ( TerminalLocation )

Место, где клиент укажет, что его заберут.

actualPickupPoint

object ( StopLocation )

Только ввод. Фактическое место, где и когда был забран клиент. Это поле предназначено для поставщика, чтобы предоставить отзыв о фактической информации о забранном.

actualPickupArrivalPoint

object ( StopLocation )

Только ввод. Фактическое время и место прибытия водителя в пункт выдачи. Это поле предназначено для предоставления поставщиком обратной связи по фактической информации о прибытии в пункт выдачи.

pickupTime

string ( Timestamp format)

Только вывод. Либо предполагаемое будущее время, когда пассажир(ы) будут забраны, либо фактическое время, когда они были забраны.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

intermediateDestinations[]

object ( TerminalLocation )

Промежуточные остановки в порядке, который запрашивает поездка (в дополнение к посадке и высадке). Первоначально это не будет поддерживаться для совместных поездок.

intermediateDestinationsVersion

string ( Timestamp format)

Указывает последний раз, когда был изменен intermediateDestinations . Ваш сервер должен кэшировать это значение и передавать его в UpdateTripRequest при обновлении intermediateDestinationIndex , чтобы гарантировать, что intermediateDestinations не будет изменен.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

intermediateDestinationIndex

integer

Когда TripStatus равен ENROUTE_TO_INTERMEDIATE_DESTINATION , число в диапазоне [0..N-1], указывающее, какой промежуточный пункт назначения пересечет транспортное средство следующим. Когда TripStatus равен ARRIVED_AT_INTERMEDIATE_DESTINATION , число в диапазоне [0..N-1], указывающее, в каком промежуточном пункте назначения находится транспортное средство. Это значение устанавливает поставщик. Если intermediateDestinations нет, это поле игнорируется.

actualIntermediateDestinationArrivalPoints[]

object ( StopLocation )

Только ввод. Фактическое время и место прибытия водителя в промежуточный пункт назначения. Это поле предназначено для предоставления поставщиком обратной связи по фактической информации о прибытии в промежуточные пункты назначения.

actualIntermediateDestinations[]

object ( StopLocation )

Только ввод. Фактическое время и место, когда и где клиент был забран из промежуточного пункта назначения. Это поле предназначено для поставщика, чтобы предоставить обратную связь по фактической информации о забранных автомобилях в промежуточных пунктах назначения.

dropoffPoint

object ( TerminalLocation )

Место, где клиент укажет, что его высадят.

actualDropoffPoint

object ( StopLocation )

Только ввод. Фактическое время и место, где и когда был высажен клиент. Это поле предназначено для поставщика, чтобы предоставить отзыв о фактической информации о высадке.

dropoffTime

string ( Timestamp format)

Только вывод. Либо предполагаемое будущее время высадки пассажира(ов) в конечном пункте назначения, либо фактическое время высадки.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

remainingWaypoints[]

object ( TripWaypoint )

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

vehicleWaypoints[]

object ( TripWaypoint )

Это поле поддерживает ручное упорядочивание точек маршрута для поездки. Оно содержит все оставшиеся точки маршрута для назначенного транспортного средства, а также точки посадки и высадки для этой поездки. Если поездка не была назначена транспортному средству, то Fleet Engine игнорирует это поле. В целях конфиденциальности это поле заполняется сервером только при вызовах trips.update и trips.create , НО НЕ при вызовах trips.get .

route[]

object ( LatLng )

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

currentRouteSegment

string

Только вывод. Закодированный путь к следующей точке маршрута.

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

currentRouteSegmentVersion

string ( Timestamp format)

Только вывод. Указывает время последнего изменения маршрута.

Примечание: это поле предназначено только для использования Driver SDK и Consumer SDK.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

currentRouteSegmentTraffic

object ( ConsumableTrafficPolyline )

Только вывод. Указывает условия движения по currentRouteSegment , когда они доступны.

Примечание: это поле предназначено только для использования Driver SDK и Consumer SDK.

currentRouteSegmentTrafficVersion

string ( Timestamp format)

Только вывод. Указывает последний раз, когда currentRouteSegmentTraffic был изменен.

Примечание: это поле предназначено только для использования Driver SDK и Consumer SDK.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

currentRouteSegmentEndPoint

object ( TripWaypoint )

Только вывод. Точка маршрута, где заканчивается currentRouteSegment .

remainingDistanceMeters

integer

Только вывод. Оставшееся расстояние в поле currentRouteSegment . Значение не указано, если поездка не назначена на транспортное средство или поездка завершена или отменена.

etaToFirstWaypoint

string ( Timestamp format)

Только вывод. ETA до следующей точки маршрута (первая запись в поле remainingWaypoints ). Значение не указано, если поездка не назначена на транспортное средство или поездка неактивна (завершена или отменена).

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

remainingTimeToFirstWaypoint

string ( Duration format)

Только вывод. Длительность с момента возврата данных о поездке до времени в Trip.eta_to_first_waypoint . Значение не указано, если поездка не назначена транспортному средству или поездка неактивна (завершена или отменена).

Длительность в секундах с дробной частью до девяти цифр, заканчивающаяся на ' s '. Пример: "3.5s" .

remainingWaypointsVersion

string ( Timestamp format)

Только вывод. Указывает последний раз, когда remainingWaypoints был изменен (путевая точка была добавлена, удалена или изменена).

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

remainingWaypointsRouteVersion

string ( Timestamp format)

Только вывод. Указывает последний раз, когда remainingWaypoints.path_to_waypoint и remainingWaypoints.traffic_to_waypoint были изменены. Ваше клиентское приложение должно кэшировать это значение и передавать его в GetTripRequest , чтобы гарантировать, что пути и трафик для remainingWaypoints возвращаются только в случае обновления.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

numberOfPassengers

integer

Неизменяемый. Указывает количество пассажиров в этой поездке и не включает водителя. Транспортное средство должно иметь доступную вместимость для возврата в ответе vehicles.search .

lastLocation

object ( VehicleLocation )

Только вывод. Указывает последнее сообщенное местоположение транспортного средства на маршруте.

lastLocationSnappable

boolean

Только вывод. Указывает, можно ли привязать lastLocation транспортного средства к currentRouteSegment. False, если lastLocation или currentRouteSegment не существует. Вычисляется Fleet Engine. Любые обновления от клиентов будут игнорироваться.

view

enum ( TripView )

Подмножество полей Trip, которые заполняются, и способ их интерпретации.

attributes[]

object ( TripAttribute )

Список пользовательских атрибутов Trip. Каждый атрибут должен иметь уникальный ключ.

TripStatus

Статус поездки, указывающий на ее ход.

Перечисления
UNKNOWN_TRIP_STATUS По умолчанию используется для неуказанного или нераспознанного статуса поездки.
NEW Недавно созданная поездка.
ENROUTE_TO_PICKUP Водитель едет к месту посадки.
ARRIVED_AT_PICKUP Водитель прибыл в пункт посадки.
ARRIVED_AT_INTERMEDIATE_DESTINATION Водитель прибыл в промежуточный пункт назначения и ждет пассажира.
ENROUTE_TO_INTERMEDIATE_DESTINATION Водитель направляется в промежуточный пункт назначения (не в пункт высадки).
ENROUTE_TO_DROPOFF Водитель подобрал пассажира и едет в следующий пункт назначения.
COMPLETE Пассажир высажен, поездка завершена.
CANCELED Поездка была отменена до момента посадки водителем, пассажиром или поставщиком услуг совместных поездок.

ОстановкаМестоположение

Фактическое место остановки (посадки/высадки).

JSON-представление 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Поля
point

object ( LatLng )

Обязательно. Обозначает фактическое местоположение.

timestamp

string ( Timestamp format)

Указывает, когда произошла остановка.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

stopTime
(deprecated)

string ( Timestamp format)

Только ввод. Устарело. Используйте поле метки времени.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

TripView

Селектор для различных наборов полей Trip в ответе trips.get . См. AIP-157 для контекста. Вероятно, будут добавлены дополнительные представления.

Перечисления
TRIP_VIEW_UNSPECIFIED Значение по умолчанию. Для обратной совместимости API по умолчанию будет использовать вид SDK. Для обеспечения стабильности и поддержки клиентам рекомендуется выбирать TripView , отличный от SDK .
SDK Включает поля, которые могут быть неинтерпретируемыми или неподдерживаемыми с использованием общедоступных библиотек.
JOURNEY_SHARING_V1S Поля Trip заполняются для варианта использования Journey Sharing. Это представление предназначено для связи сервер-сервер.

Атрибут поездки

Описывает атрибут поездки как пару ключ-значение. Длина строки "ключ:значение" не может превышать 256 символов.

JSON-представление 
{
  "key": string,

  // Union field trip_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field trip_attribute_value.
}
Поля
key

string

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

Поле объединения trip_attribute_value . Значение атрибута может быть строковым, логическим или двойным. trip_attribute_value может быть только одним из следующих:
stringValue

string

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

boolValue

boolean

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

numberValue

number

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

Методы

create

 Создает рейс в Fleet Engine и возвращает новый рейс.

delete

 Удаляет одну поездку.

get

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

update

 Обновляет данные о поездке.