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 برای آن بازیابی می‌شوند. اگر داده‌های مسیر از این مهر زمانی تغییری نکرده باشند، فیلد مسیر در پاسخ تنظیم نمی‌شود. اگر حداقل مشخص نشده باشد، داده های مسیر همیشه بازیابی می شوند.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

remainingWaypointsVersion

string ( Timestamp format)

حداقل مهر زمانی (انحصاری) که Trip.remaining_waypoints برای آن بازیابی شده است را نشان می دهد. اگر از زمان این مُهر زمان تغییری نکرده باشند، remainingWaypoints در پاسخ تنظیم نمی شوند. اگر این فیلد مشخص نشده باشد، remainingWaypoints همیشه بازیابی می شود.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

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 در دسترس است.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

remainingWaypointsRouteVersion

string ( Timestamp format)

حداقل مهر زمانی (انحصاری) را نشان می‌دهد که داده‌های Trip.remaining_waypoints.traffic_to_waypoint و Trip.remaining_waypoints.path_to_waypoint برای آن بازیابی شده‌اند. اگر داده‌ها از این مهر زمانی تغییر نکرده باشند، فیلدهای بالا در پاسخ تنظیم نمی‌شوند. اگر remainingWaypointsRouteVersion مشخص نشده باشد، ترافیک و مسیر همیشه بازیابی می شوند.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Trip است.

PolylineFormatType

نوع قالب چند خطی.

Enums
UNKNOWN_FORMAT_TYPE قالب نامشخص یا ناشناخته است.
LAT_LNG_LIST_TYPE فهرستی از google.type.LatLng .
ENCODED_POLYLINE_TYPE یک چند خط کدگذاری شده با یک الگوریتم فشرده سازی چند خطی. رمزگشایی هنوز پشتیبانی نمی شود.