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