Method: providers.trips.get

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

HTTP-запрос

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Необходимый. Должно быть в формате providers/{provider}/trips/{trip} . Поставщиком должен быть идентификатор проекта (например, sample-cloud-project ) проекта Google Cloud, участником которого является сервисный аккаунт, выполняющий этот вызов.

Параметры запроса

Параметры
header

object ( RequestHeader )

Стандартный заголовок запроса Fleet Engine.

view

enum ( TripView )

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

current Route Segment Version

string ( Timestamp format)

Указывает минимальную временную метку (эксклюзивную), для которой извлекаются данные Trip.route или Trip.current_route_segment . Если данные маршрута не изменились с момента этой временной метки, поле маршрута не задается в ответе. Если минимум не указан, данные маршрута извлекаются всегда.

Использует 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" .

remaining Waypoints Version

string ( Timestamp format)

Указывает минимальную временную метку (эксклюзивную), для которой извлекаются Trip.remaining_waypoints . Если они не изменились с момента этой временной метки, remainingWaypoints не задаются в ответе. Если это поле не указано, всегда извлекаются 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" .

route Format Type

enum ( PolylineFormatType )

Возвращаемый формат текущего маршрута: LAT_LNG_LIST_TYPE (в Trip.route ) или ENCODED_POLYLINE_TYPE (в Trip.current_route_segment ). По умолчанию используется LAT_LNG_LIST_TYPE .

current Route Segment Traffic Version

string ( Timestamp format)

Указывает минимальную временную метку (эксклюзивную), для которой извлекается Trip.current_route_segment_traffic . Если данные о трафике не изменились с момента этой временной метки, поле currentRouteSegmentTraffic не задается в ответе. Если минимум не указан, данные о трафике извлекаются всегда. Обратите внимание, что трафик доступен только для клиентов On-Demand Rides and Delivery Solution.

Использует 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" .

remaining Waypoints Route Version

string ( Timestamp format)

Указывает минимальную временную метку (эксклюзивную), для которой извлекаются данные Trip.remaining_waypoints.traffic_to_waypoint и Trip.remaining_waypoints.path_to_waypoint . Если данные не изменились с момента этой временной метки, приведенные выше поля не задаются в ответе. Если remainingWaypointsRouteVersion не указан, трафик и путь извлекаются всегда.

Использует 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" .

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит экземпляр Trip .

ПолилинияФорматТип

Тип формата полилинии.

Перечисления
UNKNOWN_FORMAT_TYPE Формат не указан или неизвестен.
LAT_LNG_LIST_TYPE Список google.type.LatLng .
ENCODED_POLYLINE_TYPE Полилиния, закодированная с помощью алгоритма сжатия полилиний. Декодирование пока не поддерживается.