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

Các tham 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 Google Cloud có tài khoản dịch vụ thực hiện lệnh gọi này.

Tham số truy vấn

Các tham số
header

object (RequestHeader)

Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn.
view

enum (TripView)

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

string (Timestamp format)

Cho biết dấu thời gian tối thiểu (không bao gồm) mà dữ liệu Trip.route hoặc Trip.current_route_segment được truy xuất. Nếu dữ liệu tuyến đường không thay đổi kể từ dấu thời gian này, trường tuyến đường sẽ không được đặt trong phản hồi. Nếu không chỉ định giá trị nhỏ nhất, dữ liệu tuyến đường 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" và "2014-10-02T15:01:23.045123456Z".
remainingWaypointsVersion

string (Timestamp format)

Cho biết dấu thời gian tối thiểu (không bao gồm) 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 chưa 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, 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" và "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, dữ liệu lưu lượng truy cập luôn được truy xuất. Xin lưu ý rằng lưu lượng truy cập chỉ áp dụng 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, 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" và "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) mà dữ liệu Trip.remaining_waypoints.traffic_to_waypoint và Trip.remaining_waypoints.path_to_waypoint được truy xuất. 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 chưa chỉ định remainingWaypointsRouteVersion, giao thông 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" và "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 nhiều đường.

Enum
UNKNOWN_FORMAT_TYPE Định dạng chưa đượ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 nhiều đường. Tính năng giải mã chưa được hỗ trợ.