Method: providers.trips.get
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Tek bir gezi hakkında bilgi edinme.
HTTP isteği
GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
name |
string
Zorunlu. providers/{provider}/trips/{trip} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud projesinin proje kimliği (örneğin, sample-cloud-project) olmalıdır.
|
Sorgu parametreleri
| Parametreler |
header |
object (RequestHeader)
Standart Fleet Engine istek başlığı.
|
view |
enum (TripView)
Döndürülmesi gereken Gezi alanlarının alt kümesi ve bunların yorumu.
|
currentRouteSegmentVersion |
string (Timestamp format)
Trip.route veya Trip.current_route_segment verilerinin alındığı minimum zaman damgasını (hariç) belirtir. Rota verileri bu zaman damgasından beri değişmediyse rota alanı yanıtta ayarlanmaz. Minimum değer belirtilmezse rota verileri her zaman alınır.
Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
|
remainingWaypointsVersion
(deprecated) |
string (Timestamp format)
Desteği sonlandırıldı: Trip.remaining_waypoints her zaman alınır. Trip.remaining_waypoints.traffic_to_waypoint ve Trip.remaining_waypoints.path_to_waypoint verilerinin ne zaman alınacağını kontrol etmek için remainingWaypointsRouteVersion öğesini kullanın. Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
|
routeFormatType |
enum (PolylineFormatType)
Döndürülen mevcut rota biçimi (Trip.route içinde LAT_LNG_LIST_TYPE veya Trip.current_route_segment içinde ENCODED_POLYLINE_TYPE). Varsayılan değer LAT_LNG_LIST_TYPE'tür.
|
currentRouteSegmentTrafficVersion |
string (Timestamp format)
Trip.current_route_segment_traffic değerinin alındığı minimum zaman damgasını (hariç) belirtir. Trafik verileri bu zaman damgasından beri değişmediyse yanıtta currentRouteSegmentTraffic alanı ayarlanmaz. Minimum değer belirtilmezse trafik verileri her zaman alınır. Trafiğin yalnızca On-demand Rides & Deliveries Solution müşterileri tarafından kullanılabileceğini unutmayın.
Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
|
remainingWaypointsRouteVersion |
string (Timestamp format)
Trip.remaining_waypoints.traffic_to_waypoint ve Trip.remaining_waypoints.path_to_waypoint verilerinin alındığı minimum zaman damgasını (hariç) gösterir. Veriler bu zaman damgasından beri değişmediyse yukarıdaki alanlar yanıtta ayarlanmaz. remainingWaypointsRouteVersion belirtilmezse trafik ve yol her zaman alınır.
Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, Trip öğesinin bir örneğini içerir.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 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. |"]]
