REST Resource: providers.trips

{
  "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)
}

string

Только вывод. В формате "провайдеры/{провайдер}/поездки/{поездка}"

string

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

enum ( TripStatus )

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

enum ( TripType )

Тип поездки.

object ( TerminalLocation )

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

object ( StopLocation )

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

object ( StopLocation )

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

string ( Timestamp format)

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

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

object ( TerminalLocation )

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

string ( Timestamp format)

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

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

integer

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

object ( StopLocation )

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

object ( StopLocation )

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

object ( TerminalLocation )

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

object ( StopLocation )

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

string ( Timestamp format)

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

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

object ( TripWaypoint )

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

object ( TripWaypoint )

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

object ( LatLng )

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

string

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

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

string ( Timestamp format)

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

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

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

object ( ConsumableTrafficPolyline )

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

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

string ( Timestamp format)

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

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

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

object ( TripWaypoint )

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

integer

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

string ( Timestamp format)

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

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

string ( Duration format)

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

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

string ( Timestamp format)

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

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

string ( Timestamp format)

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

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

integer

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

object ( VehicleLocation )

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

boolean

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

enum ( TripView )

Подмножество заполняемых полей «Поездка» и их интерпретация.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object ( LatLng )

Необходимый. Обозначает фактическое местоположение.

string ( Timestamp format)

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

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

string ( Timestamp format)

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

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