Method: providers.trips.get

Nhận thông tin về một chuyến đi.

Yêu cầu HTTP

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/trips/{trip}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của dự án trên Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.

Tham số truy vấn

Thông số
header

object (RequestHeader)

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.

view

enum (TripView)

Tập hợp con của các trường Chuyến đi cần được trả về và phần diễn giải các trường đó.

currentRouteSegmentVersion

string (Timestamp format)

Cho biết dấu thời gian tối thiểu (riêng biệt) để truy xuất dữ liệu Trip.route hoặc Trip.current_route_segment. Nếu dữ liệu tuyến đường không thay đổi kể từ dấu thời gian này, thì trường tuyến đường sẽ không được đặt trong phản hồi. Nếu giá trị tối thiểu không được chỉ định, thì dữ liệu tuyến đường sẽ luôn được truy xuất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

remainingWaypointsVersion

string (Timestamp format)

Cho biết dấu thời gian tối thiểu (dành riêng) mà Trip.remaining_waypoints được truy xuất. Nếu các giá trị này không thay đổi kể từ dấu thời gian này, thì remainingWaypoints sẽ không được đặt trong phản hồi. Nếu bạn không chỉ định trường này, remainingWaypoints sẽ luôn được truy xuất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

routeFormatType

enum (PolylineFormatType)

Định dạng tuyến hiện tại được trả về, LAT_LNG_LIST_TYPE (trong Trip.route) hoặc ENCODED_POLYLINE_TYPE (trong Trip.current_route_segment). Định dạng mặc định là LAT_LNG_LIST_TYPE.

currentRouteSegmentTrafficVersion

string (Timestamp format)

Cho biết dấu thời gian tối thiểu (không bao gồm) mà Trip.current_route_segment_traffic được truy xuất. Nếu dữ liệu lưu lượng truy cập không thay đổi kể từ dấu thời gian này, thì trường currentRouteSegmentTraffic sẽ không được đặt trong phản hồi. Nếu không chỉ định mức tối thiểu, thì dữ liệu lưu lượng truy cập sẽ luôn được truy xuất. Xin lưu ý rằng lưu lượng truy cập chỉ dành cho khách hàng sử dụng Giải pháp gọi xe và giao hàng theo yêu cầu.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

remainingWaypointsRouteVersion

string (Timestamp format)

Cho biết dấu thời gian tối thiểu (không bao gồm) để truy xuất dữ liệu Trip.remaining_waypoints.traffic_to_waypointTrip.remaining_waypoints.path_to_waypoint. Nếu dữ liệu không thay đổi kể từ dấu thời gian này, thì các trường ở trên sẽ không được đặt trong phản hồi. Nếu không chỉ định remainingWaypointsRouteVersion, lưu lượng truy cập và đường dẫn sẽ luôn được truy xuất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Trip.

PolylineFormatType

Loại định dạng đa tuyến.

Enum
UNKNOWN_FORMAT_TYPE Định dạng không được chỉ định hoặc không xác định.
LAT_LNG_LIST_TYPE Danh sách google.type.LatLng.
ENCODED_POLYLINE_TYPE Một hình nhiều đường được mã hoá bằng thuật toán nén hình nhiều đường. Chưa hỗ trợ giải mã.