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 همیشه بازیابی می شوند. برای کنترل زمان بازیابی اطلاعات 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" . |
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 و 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 Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
