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 đề tiêu chuẩn của yêu cầu Fleet Engine.
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 (dành riêng) cho 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, thì trường tuyến đường không được thiết lập 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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 (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 thiết lập 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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). Giá trị mặc định là LAT_LNG_LIST_TYPE.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Cho biết dấu thời gian tối thiểu (dành riêng) 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 không được thiết lập trong phản hồi. Nếu không chỉ định mức tối thiểu, thì hệ thống sẽ luôn truy xuất dữ liệu lưu lượng truy cập. Xin lưu ý rằng lưu lượng truy cập chỉ áp dụng cho những 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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 (dành riêng) cho 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 thiết lập trong phản hồi. Nếu bạn không chỉ định remainingWaypointsRouteVersion, thì hệ thống sẽ luôn truy xuất lưu lượng truy cập và đường dẫn.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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 hình nhiều đường.

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