Method: providers.trips.get

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

HTTP-запрос

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

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

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

Параметры
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 . Если данные маршрута не изменились с момента этой временной метки, поле маршрута не задается в ответе. Если минимум не указан, данные маршрута всегда извлекаются.

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

remainingWaypointsVersion
(deprecated)

string ( Timestamp format)

Устарело: Trip.remaining_waypoints всегда извлекаются. Используйте remainingWaypointsRouteVersion для управления тем, когда извлекаются данные Trip.remaining_waypoints.traffic_to_waypoint и Trip.remaining_waypoints.path_to_waypoint .

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

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 Deliveries 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" .

remainingWaypointsRouteVersion

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 Полилиния, закодированная с помощью алгоритма сжатия полилиний. Декодирование пока не поддерживается.