REST Resource: providers.trips

{
  "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)
}

string

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

string

Mã nhận dạng của xe thực hiện chuyến đi này.

enum (TripStatus)

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

enum (TripType)

Loại chuyến đi.

object (TerminalLocation)

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

object (StopLocation)

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 dành cho nhà cung cấp để cung cấp ý kiến phản hồi về thông tin thực tế về điểm đến lấy hàng.

object (StopLocation)

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ành cho nhà cung cấp để cung cấp ý kiến phản hồi về thông tin đến thực tế tại điểm đón.

string (Timestamp format)

Chỉ có đầu ra. Thời gian ước tính trong tương lai khi (các) người đi xe sẽ được đón hoặc thời gian thực tế khi họ được đón.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (TerminalLocation)

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.

string (Timestamp format)

Cho biết lần cuối cùng 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ị đó trong UpdateTripRequest khi cập nhật intermediateDestinationIndex để đảm bảo intermediateDestinations không bị 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".

integer

Khi TripStatus là ENROUTE_TO_INTERMEDIATE_DESTINATION, một số nằm trong khoảng [0..N-1] cho biết điểm đến trung gian mà xe sẽ đi qua 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 đặt giá trị này. Nếu không có intermediateDestinations, trường này sẽ bị bỏ qua.

object (StopLocation)

Chỉ nhập. Thời gian và vị trí thực tế mà 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.

object (StopLocation)

Chỉ nhập. Thời gian và vị trí thực tế khi khách hàng được đón tại 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.

object (TerminalLocation)

Vị trí mà khách hàng cho biết họ sẽ được đưa đến.

object (StopLocation)

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 đã trả xe. Trường này dành cho nhà cung cấp để cung cấp ý kiến phản hồi về thông tin trả khách thực tế.

string (Timestamp format)

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 ở đị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".

object (TripWaypoint)

Chỉ có đầu ra. Đường dẫn đầy đủ từ vị trí hiện tại đến điểm trả khách, bao gồm cả điểm trả khách. Đường dẫn này có thể bao gồm các điểm trung gian của các chuyến đi khác.

object (TripWaypoint)

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ì Công cụ quản lý đội xe sẽ bỏ qua trường này. Vì lý do liên quan đến quyền riêng tư, máy chủ chỉ điền trường này vào 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.

object (LatLng)

Chỉ có đầu ra. Tuyến đường dự kiến cho chuyến đi này đến mục đầu tiên trong remainingWaypoints. Lưu ý rằng điểm tham chiếu đầu tiên có thể thuộc về một chuyến đi khác.

string

Chỉ có đầu ra. Đường dẫn được mã hoá đến điểm trung gian 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ợ.

string (Timestamp format)

Chỉ có đầu ra. Cho biết lần gần 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 tiêu dùng sử dụng.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

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 Trình điều khiển SDK và Trình dùng SDK.

string (Timestamp format)

Chỉ có đầu ra. Cho biết lần sửa đổi gần nhất của currentRouteSegmentTraffic.

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

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

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

integer

Chỉ có đầu ra. Quãng đường lái xe còn lại trong trường currentRouteSegment. Giá trị này không được chỉ định nếu chuyến đi không được chỉ định cho một xe, hoặc chuyến đi đã hoàn tất hoặc bị huỷ.

string (Timestamp format)

Chỉ có đầu ra. ETA đến điểm tham chiếu tiếp theo (mục nhập đầu tiên trong trường remainingWaypoints). Giá trị này không được chỉ định nếu chuyến đi không được chỉ định cho xe, hoặc chuyến đi không hoạt động (đã hoàn thành 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".

string (Duration format)

Chỉ có đầu ra. Khoảng thời gian từ khi dữ liệu Chuyến đi được trả về đến thời gian trong Trip.eta_to_first_waypoint. Giá trị này không được chỉ định nếu chuyến đi không được chỉ định cho một xe 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ố thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

string (Timestamp format)

Chỉ có đầu ra. Cho biết lần gần đây nhất remainingWaypoints được thay đổi (thêm, xoá hoặc thay đổi một điểm trung 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".

string (Timestamp format)

Chỉ có đầu ra. Cho biết lần cuối cùng 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ị đó trong GetTripRequest để đảm bảo rằng 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".

integer

Không thể thay đổi. Cho biết số lượng hành khách trên chuyến đi này và không bao gồm người lái xe. Xe phải còn trống chỗ để được trả lại trong phản hồi vehicles.search.

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.

boolean

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

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 đó.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

Bắt buộc. Cho biết vị trí thực tế.

string (Timestamp format)

Cho biết thời điểm 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".

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, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".