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, которые должны быть возвращены, и их интерпретация.

currentRouteSegmentVersion

string ( Timestamp format)

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

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

remainingWaypointsVersion

string ( Timestamp format)

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

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

routeFormatType

enum ( PolylineFormatType )

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

currentRouteSegmentTrafficVersion

string ( Timestamp format)

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

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

remainingWaypointsRouteVersion

string ( Timestamp format)

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

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

Тело запроса

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

Тело ответа

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

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

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

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