Method: providers.trips.get
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mendapatkan informasi tentang satu perjalanan.
Permintaan HTTP
GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
name |
string
Wajib. Harus dalam format providers/{provider}/trips/{trip}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini adalah anggotanya.
|
Parameter kueri
| Parameter |
header |
object (RequestHeader)
Header permintaan Fleet Engine standar.
|
view |
enum (TripView)
Subkumpulan kolom Perjalanan yang harus ditampilkan dan interpretasinya.
|
currentRouteSegmentVersion |
string (Timestamp format)
Menunjukkan stempel waktu minimum (eksklusif) untuk data Trip.route atau Trip.current_route_segment yang diambil. Jika data rute tidak berubah sejak stempel waktu ini, kolom rute tidak ditetapkan dalam respons. Jika minimum tidak ditentukan, data rute akan selalu diambil. Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
|
remainingWaypointsVersion
(deprecated) |
string (Timestamp format)
Tidak digunakan lagi: Trip.remaining_waypoints selalu diambil. Gunakan remainingWaypointsRouteVersion untuk mengontrol kapan data Trip.remaining_waypoints.traffic_to_waypoint dan Trip.remaining_waypoints.path_to_waypoint diambil. Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
|
routeFormatType |
enum (PolylineFormatType)
Format rute saat ini yang ditampilkan, LAT_LNG_LIST_TYPE (di Trip.route), atau ENCODED_POLYLINE_TYPE (di Trip.current_route_segment). Default-nya adalah LAT_LNG_LIST_TYPE.
|
currentRouteSegmentTrafficVersion |
string (Timestamp format)
Menunjukkan stempel waktu minimum (eksklusif) yang diambil Trip.current_route_segment_traffic. Jika data traffic tidak berubah sejak stempel waktu ini, kolom currentRouteSegmentTraffic tidak ditetapkan dalam respons. Jika minimum tidak ditentukan, data traffic akan selalu diambil. Perhatikan bahwa traffic hanya tersedia untuk pelanggan Solusi Perjalanan dan Pengiriman On-Demand. Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
|
remainingWaypointsRouteVersion |
string (Timestamp format)
Menunjukkan stempel waktu minimum (eksklusif) yang data Trip.remaining_waypoints.traffic_to_waypoint dan Trip.remaining_waypoints.path_to_waypoint-nya diambil. Jika data tidak berubah sejak stempel waktu ini, kolom di atas tidak ditetapkan dalam respons. Jika remainingWaypointsRouteVersion tidak ditentukan, traffic dan jalur akan selalu diambil. Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat instance Trip.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-31 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
