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 .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eRetrieves detailed trip information for a specified provider and trip ID.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of the data returned using query parameters such as \u003ccode\u003eview\u003c/code\u003e, \u003ccode\u003erouteFormatType\u003c/code\u003e, and various version parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and a valid \u003ccode\u003ename\u003c/code\u003e path parameter in the format \u003ccode\u003eproviders/{provider}/trips/{trip}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the response includes a \u003ccode\u003eTrip\u003c/code\u003e object containing comprehensive trip details.\u003c/p\u003e\n"],["\u003cp\u003eOffers the flexibility to request routes in either \u003ccode\u003eLAT_LNG_LIST_TYPE\u003c/code\u003e or \u003ccode\u003eENCODED_POLYLINE_TYPE\u003c/code\u003e format.\u003c/p\u003e\n"]]],[],null,["# Method: providers.trips.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [PolylineFormatType](#PolylineFormatType)\n\nGet information about a single trip.\n\n### HTTP request\n\n`GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Must be in the format `providers/{provider}/trips/{trip}`. The provider must be the Project ID (for example, `sample-cloud-project`) of the Google Cloud Project of which the service account making this call is a member. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `header` | `object (`[RequestHeader](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/RequestHeader)`)` The standard Fleet Engine request header. |\n| `view` | `enum (`[TripView](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips#TripView)`)` The subset of Trip fields that should be returned and their interpretation. |\n| `currentRouteSegmentVersion` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Indicates the minimum timestamp (exclusive) for which `Trip.route` or `Trip.current_route_segment` data are retrieved. If route data are unchanged since this timestamp, the route field is not set in the response. If a minimum is unspecified, the route data are always retrieved. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `remainingWaypointsVersion` **(deprecated)** | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Deprecated: `Trip.remaining_waypoints` are always retrieved. Use `remainingWaypointsRouteVersion` to control when `Trip.remaining_waypoints.traffic_to_waypoint` and `Trip.remaining_waypoints.path_to_waypoint` data are retrieved. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `routeFormatType` | `enum (`[PolylineFormatType](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips/get#PolylineFormatType)`)` The returned current route format, `LAT_LNG_LIST_TYPE` (in `Trip.route`), or `ENCODED_POLYLINE_TYPE` (in `Trip.current_route_segment`). The default is `LAT_LNG_LIST_TYPE`. |\n| `currentRouteSegmentTrafficVersion` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Indicates the minimum timestamp (exclusive) for which `Trip.current_route_segment_traffic` is retrieved. If traffic data are unchanged since this timestamp, the `currentRouteSegmentTraffic` field is not set in the response. If a minimum is unspecified, the traffic data are always retrieved. Note that traffic is only available for On-Demand Rides and Deliveries Solution customers. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `remainingWaypointsRouteVersion` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Indicates the minimum timestamp (exclusive) for which `Trip.remaining_waypoints.traffic_to_waypoint` and `Trip.remaining_waypoints.path_to_waypoint` data are retrieved. If data are unchanged since this timestamp, the fields above are not set in the response. If `remainingWaypointsRouteVersion` is unspecified, traffic and path are always retrieved. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Trip](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips#Trip).\n\nPolylineFormatType\n------------------\n\nThe type of polyline format.\n\n| Enums ||\n|-------------------------|------------------------------------------------------------------------------------------|\n| `UNKNOWN_FORMAT_TYPE` | The format is unspecified or unknown. |\n| `LAT_LNG_LIST_TYPE` | A list of `google.type.LatLng`. |\n| `ENCODED_POLYLINE_TYPE` | A polyline encoded with a polyline compression algorithm. Decoding is not yet supported. |"]]
