Ресурс: Поездка
Метаданные поездки.
JSON-представление |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Поля | |
---|---|
name | Только вывод. В формате "провайдеры/{провайдер}/поездки/{поездка}" |
vehicleId | Идентификатор транспортного средства, совершающего эту поездку. |
tripStatus | Текущий статус поездки. |
tripType | Тип поездки. |
pickupPoint | Место, где клиент укажет, что его заберут. |
actualPickupPoint | Только ввод. Фактическое место, когда и где забрали клиента. Это поле предназначено для того, чтобы поставщик предоставил отзыв о фактической информации о получении. |
actualPickupArrivalPoint | Только ввод. Фактическое время и место прибытия водителя в пункт выдачи. Это поле предназначено для предоставления поставщиком информации о фактическом прибытии в пункт выдачи. |
pickupTime | Только вывод. Либо предполагаемое время в будущем, когда гонщика(ов) заберут, либо фактическое время, когда их заберут. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
intermediateDestinations[] | Промежуточные остановки в соответствии с запросами на поездку (помимо посадки и высадки). Первоначально эта функция не будет поддерживаться для совместных поездок. |
intermediateDestinationsVersion | Указывает, когда в последний раз было изменено Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
intermediateDestinationIndex | Когда |
actualIntermediateDestinationArrivalPoints[] | Только ввод. Фактическое время и место прибытия водителя в промежуточный пункт назначения. Это поле предназначено для предоставления поставщиком информации о фактическом прибытии в промежуточные пункты назначения. |
actualIntermediateDestinations[] | Только ввод. Фактическое время и место, когда и где клиента забрали из промежуточного пункта назначения. Это поле предназначено для предоставления поставщиком обратной связи о фактической информации о получении в промежуточных пунктах назначения. |
dropoffPoint | Место, где клиент указывает, что его высадят. |
actualDropoffPoint | Только ввод. Фактическое время и место, когда и где высадили клиента. Это поле предназначено для предоставления поставщиком обратной связи по фактической информации о возврате. |
dropoffTime | Только вывод. Либо предполагаемое будущее время, когда пассажиры будут высажены в конечном пункте назначения, либо фактическое время, когда они были высажены. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
remainingWaypoints[] | Только вывод. Полный путь от текущего местоположения до точки высадки включительно. Этот путь может включать путевые точки из других поездок. |
vehicleWaypoints[] | Это поле поддерживает ручной заказ путевых точек для поездки. Он содержит все оставшиеся путевые точки для назначенного транспортного средства, а также путевые точки посадки и высадки для этой поездки. Если поездка не назначена транспортному средству, Fleet Engine игнорирует это поле. По соображениям конфиденциальности это поле заполняется сервером только при вызовах |
route[] | Только вывод. Предполагаемый маршрут этой поездки до первой записи в оставшихся точках маршрута. Обратите внимание, что первая путевая точка может принадлежать другому рейсу. |
currentRouteSegment | Только вывод. Закодированный путь к следующей путевой точке. Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. Декодирование пока не поддерживается. |
currentRouteSegmentVersion | Только вывод. Указывает последний раз, когда маршрут был изменен. Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
currentRouteSegmentTraffic | Только вывод. Указывает условия трафика в Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. |
currentRouteSegmentTrafficVersion | Только вывод. Указывает, когда в последний раз был изменен Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
currentRouteSegmentEndPoint | Только вывод. Путевая точка, где заканчивается |
remainingDistanceMeters | Только вывод. Оставшееся расстояние поездки в поле |
etaToFirstWaypoint | Только вывод. Расчетное время прибытия до следующей путевой точки (первая запись в поле Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
remainingTimeToFirstWaypoint | Только вывод. Продолжительность с момента возврата данных Trip до времени в Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
remainingWaypointsVersion | Только вывод. Указывает, когда в последний раз были изменены Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
remainingWaypointsRouteVersion | Только вывод. Указывает, когда в последний раз были изменены Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
numberOfPassengers | Неизменяемый. Указывает количество пассажиров в поездке, не включая водителя. Транспортное средство должно иметь доступную мощность, чтобы его можно было вернуть в ответе |
lastLocation | Только вывод. Указывает последнее зарегистрированное местоположение транспортного средства на маршруте. |
lastLocationSnappable | Только вывод. Указывает, можно ли привязать |
view | Подмножество заполняемых полей «Поездка» и их интерпретация. |
Статус поездки
Статус поездки с указанием ее хода.
Перечисления | |
---|---|
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 ( |
Поля | |
---|---|
point | Необходимый. Обозначает фактическое местоположение. |
timestamp | Указывает, когда произошла остановка. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
stopTime | Только ввод. Устарело. Используйте поле метки времени. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
TripView
Селектор для различных наборов полей «Поездка» в ответе trips.get
. Контекст см. в AIP-157 . Вероятно, будут добавлены дополнительные представления.
Перечисления | |
---|---|
TRIP_VIEW_UNSPECIFIED | Значение по умолчанию. Для обеспечения обратной совместимости API по умолчанию использует представление SDK. Чтобы обеспечить стабильность и поддержку, клиентам рекомендуется выбирать TripView отличный от SDK . |
SDK | Включает поля, которые невозможно интерпретировать или поддерживать с помощью общедоступных библиотек. |
JOURNEY_SHARING_V1S | Поля поездки заполняются для варианта использования «Совместное путешествие». Это представление предназначено для связи между серверами. |
Методы | |
---|---|
| Создает поездку в Fleet Engine и возвращает новую поездку. |
| Получите информацию об одной поездке. |
| Получите все поездки для конкретного автомобиля. |
| Обновляет данные о поездке. |