REST Resource: providers.trips

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 (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}
Các trường
name

string

Chỉ có đầu ra. Ở định dạng "providers/{provider}/trips/{trip}"
vehicleId

string

Mã của chiếc xe thực hiện chuyến đi này.
tripStatus

enum (TripStatus)

Trạng thái hiện tại của chuyến đi.
tripType

enum (TripType)

Loại chuyến đi.
pickupPoint

object (TerminalLocation)

Vị trí mà khách hàng cho biết họ sẽ đến lấy hàng.
actualPickupPoint

object (StopLocation)

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

object (StopLocation)

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

string (Timestamp format)

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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
intermediateDestinations[]

object (TerminalLocation)

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

string (Timestamp format)

Cho biết lần gần đây nhất intermediateDestinations được sửa đổi. Máy chủ của bạn phải lưu giá trị này vào bộ nhớ đệm và truyền giá trị này vào UpdateTripRequest khi cập nhật intermediateDestinationIndex để đảm bảo intermediateDestinations không thay đổi.

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".
intermediateDestinationIndex

integer

Khi TripStatus ở trạng thái ENROUTE_TO_INTERMEDIATE_DESTINATION, một số nằm trong khoảng [0..N-1] cho biết xe sẽ qua điểm đến trung gian nào tiếp theo. Khi TripStatus là ARRIVED_AT_INTERMEDIATE_DESTINATION, một số nằm trong khoảng [0..N-1] cho biết xe đang ở điểm đến trung gian nào. Nhà cung cấp sẽ đặt giá trị này. Nếu không có intermediateDestinations, trường này sẽ bị bỏ qua.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

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[]

object (StopLocation)

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

object (TerminalLocation)

Vị trí mà khách hàng cho biết họ sẽ bỏ ngang.
actualDropoffPoint

object (StopLocation)

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

string (Timestamp format)

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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
remainingWaypoints[]

object (TripWaypoint)

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[]

object (TripWaypoint)

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 trips.update và trips.create, KHÔNG điền vào các lệnh gọi trips.get.
route[]

object (LatLng)

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

string

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

string (Timestamp format)

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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

Chỉ có đầu ra. Cho biết tình trạng giao thông dọc theo currentRouteSegment khi có sẵn.

Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Chỉ có đầu ra. Cho biết lần gần đây nhất currentRouteSegmentTraffic đượ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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentEndPoint

object (TripWaypoint)

Chỉ có đầu ra. Điểm tham chiếu nơi currentRouteSegment kết thúc.
remainingDistanceMeters

integer

Chỉ có đầu ra. Quãng đường lái xe còn lại trong trường currentRouteSegment. Giá trị sẽ không được chỉ định nếu chuyến đi không được chỉ định cho phương tiện, hoặc chuyến đi đã hoàn tất/bị huỷ.
etaToFirstWaypoint

string (Timestamp format)

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 remainingWaypoints). Nếu chuyến đi không được chỉ định cho phương tiện, hoặc chuyến đi không hoạt động (đã hoàn tất hoặc bị huỷ).

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".
remainingTimeToFirstWaypoint

string (Duration format)

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 Trip.eta_to_first_waypoint. Nếu chuyến đi không được chỉ định cho phương tiện, hoặc chuyến đi không hoạt động (đã hoàn tất hoặc bị huỷ).

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 's'. Ví dụ: "3.5s".
remainingWaypointsVersion

string (Timestamp format)

Chỉ có đầu ra. Cho biết lần cuối cùng remainingWaypoints được thay đổi (một điểm tham chiếu đã được thêm, xoá hoặc thay đổi).

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)

Chỉ có đầu ra. Cho biết lần gần đây nhất remainingWaypoints.path_to_waypoint và remainingWaypoints.traffic_to_waypoint được sửa đổi. Ứng dụng khách của bạn phải lưu giá trị này vào bộ nhớ đệm và truyền giá trị này vào GetTripRequest để đảm bảo các đường dẫn và lưu lượng truy cập cho remainingWaypoints chỉ được trả về nếu được cập 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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
numberOfPassengers

integer

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 vehicles.search.
lastLocation

object (VehicleLocation)

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

boolean

Chỉ có đầu ra. Cho biết liệu lastLocation của xe có thể được gắn với currentRouteSegment hay không. Sai nếu lastLocation hoặc currentRouteSegment không tồn tại. Giá trị này được tính toán bằng Fleet Engine. Mọi nội dung cập nhật của ứng dụng sẽ bị bỏ qua.
view

enum (TripView)

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 (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Các trường
point

object (LatLng)

Bắt buộc. Mô tả vị trí thực tế.
timestamp

string (Timestamp format)

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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
stopTime
(deprecated)

string (Timestamp format)

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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

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

create

 Tạo một chuyến đi trong Fleet Engine và trả về chuyến đi mới.

get

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

update

 Cập nhật dữ liệu chuyến đi.