Tài nguyên: Chuyến đi
Siêu dữ liệu về chuyến đi.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Các trường | |
---|---|
name |
Chỉ có đầu ra. Ở định dạng "providers/{provider}/trips/{trip}" |
vehicleId |
Mã của chiếc xe thực hiện chuyến đi này. |
tripStatus |
Trạng thái hiện tại của chuyến đi. |
tripType |
Loại chuyến đi. |
pickupPoint |
Vị trí mà khách hàng cho biết họ sẽ đến lấy hàng. |
actualPickupPoint |
Chỉ nhập. Địa điểm thực tế, tại thời điểm và nơi khách hàng đã được đón tiếp. Trường này dùng để nhà cung cấp cung cấp ý kiến phản hồi về thông tin thực tế đến lấy hàng. |
actualPickupArrivalPoint |
Chỉ nhập. Thời gian thực tế và vị trí mà tài xế đến điểm đón. Trường này là để nhà cung cấp cung cấp ý kiến phản hồi về thông tin thực tế sẽ đến tại điểm lấy hàng. |
pickupTime |
Chỉ có đầu ra. Thời gian ước tính trong tương lai khi(những) người lái xe sẽ được đón khách hoặc thời gian thực tế mà họ được đón. 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ụ: |
intermediateDestinations[] |
Các điểm dừng trung gian theo thứ tự yêu cầu của chuyến đi (ngoài đón khách và trả xe). Ban đầu, tính năng này sẽ không được hỗ trợ cho các chuyến đi được chia sẻ. |
intermediateDestinationsVersion |
Cho biết lần gần đây nhấ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ụ: |
intermediateDestinationIndex |
Khi |
actualIntermediateDestinationArrivalPoints[] |
Chỉ nhập. Thời gian và vị trí thực tế mà tài xế đến điểm đến trung gian. Trường này dành cho nhà cung cấp để cung cấp ý kiến phản hồi về thông tin hàng đến thực tế tại các điểm đến trung gian. |
actualIntermediateDestinations[] |
Chỉ nhập. Thời gian và vị trí thực tế thời điểm và địa điểm mà khách hàng được đón từ điểm đến trung gian. Trường này dùng để nhà cung cấp cung cấp ý kiến phản hồi về thông tin thực tế đến lấy hàng tại các điểm đến trung gian. |
dropoffPoint |
Vị trí mà khách hàng cho biết họ sẽ bỏ ngang. |
actualDropoffPoint |
Chỉ nhập. Thời gian và vị trí thực tế thời điểm và địa điểm khách hàng bỏ ngang. Trường này là để nhà cung cấp cung cấp ý kiến phản hồi về thông tin thực tế bỏ ngang. |
dropoffTime |
Chỉ có đầu ra. Thời gian dự kiến trong tương lai khi(các) người lái xe sẽ trả khách tại điểm đến cuối cùng hoặc thời gian thực tế khi họ dừng xe. 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ụ: |
remainingWaypoints[] |
Chỉ có đầu ra. Đường dẫn đầy đủ từ vị trí hiện tại đến điểm bỏ ngang. Đường dẫn này có thể bao gồm cả điểm tham chiếu từ các chuyến đi khác. |
vehicleWaypoints[] |
Trường này hỗ trợ thứ tự các điểm tham chiếu theo cách thủ công cho chuyến đi. Nó chứa tất cả các điểm tham chiếu còn lại cho xe được chỉ định, cũng như điểm đón và trả xe cho chuyến đi này. Nếu chuyến đi chưa được chỉ định cho xe, thì Fleet Engine sẽ bỏ qua trường này. Vì các lý do liên quan đến quyền riêng tư, trường này chỉ được máy chủ điền sẵn trong các lệnh gọi |
route[] |
Chỉ có đầu ra. Tuyến đường dự kiến cho chuyến đi này đến mục nhập đầu tiên trong còn Waypoints. Xin lưu ý rằng điểm tham chiếu đầu tiên có thể thuộc một chuyến đi khác. |
currentRouteSegment |
Chỉ có đầu ra. Đường dẫn đã mã hoá đến điểm tham chiếu tiếp theo. Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. Tính năng giải mã chưa được hỗ trợ. |
currentRouteSegmentVersion |
Chỉ có đầu ra. Cho biết lần gần đây nhất tuyến đường được sửa đổi. Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. 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ụ: |
currentRouteSegmentTraffic |
Chỉ có đầu ra. Cho biết tình trạng giao thông dọc theo Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. |
currentRouteSegmentTrafficVersion |
Chỉ có đầu ra. Cho biết lần gần đây nhất Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. 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ụ: |
currentRouteSegmentEndPoint |
Chỉ có đầu ra. Điểm tham chiếu nơi |
remainingDistanceMeters |
Chỉ có đầu ra. Quãng đường lái xe còn lại trong trường |
etaToFirstWaypoint |
Chỉ có đầu ra. Thời gian dự kiến đến điểm tham chiếu tiếp theo (mục nhập đầu tiên trong trường 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ụ: |
remainingTimeToFirstWaypoint |
Chỉ có đầu ra. Khoảng thời gian từ khi dữ liệu Chuyến đi được trả về thời điểm trong Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng ' |
remainingWaypointsVersion |
Chỉ có đầu ra. Cho biết lần cuối cùng 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ụ: |
remainingWaypointsRouteVersion |
Chỉ có đầu ra. Cho biết lần gần đây nhấ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ụ: |
numberOfPassengers |
Không thể thay đổi. Cho biết số lượng hành khách trong chuyến đi này và không bao gồm tài xế. Xe phải còn đủ dung lượng để được trả lại trong phản hồi |
lastLocation |
Chỉ có đầu ra. Cho biết vị trí được báo cáo gần đây nhất của xe dọc theo tuyến đường. |
lastLocationSnappable |
Chỉ có đầu ra. Cho biết liệu |
view |
Tập hợp con các trường Chuyến đi được điền sẵn và cách diễn giải các trường đó. |
TripStatus
Trạng thái của chuyến đi cho biết tiến trình của chuyến đi.
Enum | |
---|---|
UNKNOWN_TRIP_STATUS |
Mặc định, dùng cho trạng thái chuyến đi không xác định hoặc không xác định. |
NEW |
Chuyến đi mới tạo. |
ENROUTE_TO_PICKUP |
Tài xế đang trên đường đến điểm đón khách. |
ARRIVED_AT_PICKUP |
Tài xế đã đến điểm đón. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
Người lái xe đã đến điểm đến trung gian và đang chờ người lái. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Người lái xe đang trên đường đến một điểm đến trung gian (không phải điểm trả xe). |
ENROUTE_TO_DROPOFF |
Người lái xe đã đón người lái xe và đang trên đường đến điểm đến tiếp theo. |
COMPLETE |
Người lái xe đã được thả xuống và chuyến đi kết thúc. |
CANCELED |
Chuyến đi bị huỷ trước khi người lái xe, người lái xe hoặc nhà cung cấp dịch vụ đi chung xe đến lấy. |
StopLocation
Vị trí thực tế nơi xảy ra điểm dừng (đến lấy hàng/trả xe).
Biểu diễn dưới dạng JSON |
---|
{
"point": {
object ( |
Các trường | |
---|---|
point |
Bắt buộc. Mô tả vị trí thực tế. |
timestamp |
Cho biết thời điểm dừng xảy ra. 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ụ: |
stopTime |
Chỉ nhập. Không dùng nữa. Sử dụng trường dấu thời gian. 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ụ: |
TripView
Bộ chọn cho các nhóm trường Chuyến đi khác nhau trong phản hồi trips.get
. Hãy xem AIP-157 để biết thêm thông tin. Bạn có thể sẽ được thêm các chế độ xem khác.
Enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Giá trị mặc định. Để có khả năng tương thích ngược, theo mặc định, API sẽ ở chế độ xem SDK. Để đảm bảo độ ổn định và khả năng hỗ trợ, khách hàng nên chọn TripView thay vì SDK . |
SDK |
Bao gồm các trường có thể không diễn giải được hoặc không hỗ trợ được khi dùng các thư viện công khai. |
JOURNEY_SHARING_V1S |
Hệ thống điền sẵn các trường chuyến đi cho trường hợp sử dụng của tính năng Chia sẻ hành trình. Chế độ xem này dành cho hoạt động giao tiếp từ máy chủ đến máy chủ. |
Phương thức |
|
---|---|
|
Tạo một chuyến đi trong Fleet Engine và trả về chuyến đi mới. |
|
Nhận thông tin về một chuyến đi. |
|
Xem tất cả các chuyến đi của một loại xe cụ thể. |
|
Cập nhật dữ liệu chuyến đi. |