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 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ác trường Chuyến đi cần được trả về và cách diễn giải 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) để 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 không chỉ định số lượng tối thiểu, dữ liệu tuyến đường sẽ luôn được truy xuất.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
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 bạn không chỉ định trường này, remainingWaypoints sẽ luôn được truy xuất.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
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 bạn 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 hỗ trợ các chuyến xe và giao hàng theo yêu cầu.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
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_waypoint và Trip.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.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

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ã.