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

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

string (Timestamp format)

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ụ: "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 bảo intermediateDestinations không thay đổi, máy chủ của bạn nên 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.

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ụ: "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 sẽ đặ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ế 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.

object (StopLocation)

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.

object (TerminalLocation)

Vị trí mà khách hàng cho biết họ sẽ xuống xe.

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

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

object (TripWaypoint)

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 điểm tham chiếu từ 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ì 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 trips.update và trips.create, KHÔNG phải trên 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 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.

string

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

string (Timestamp format)

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ụ: "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 SDK trình điều khiển và SDK người tiêu dùng sử dụng.

string (Timestamp format)

Chỉ có đầu ra. Cho biết lần cuối cùng 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 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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

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

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 xe, hoặc chuyến đi đã hoàn tất hay 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 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ụ: "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ề thời gian tại 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 xe, hoặc chuyến đi không hoạt động (đã hoàn thành hoặc bị huỷ).

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

string (Timestamp format)

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

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ụ: "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 nên lưu giá trị này vào bộ nhớ đệm và truyền giá trị này vào GetTripRequest để đảm bảo đường dẫn và lưu lượng truy cập của remainingWaypoints chỉ được trả về nếu được cập 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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

integer

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 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 do Fleet Engine tính toán. 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ủ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 đó.

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

object (LatLng)

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

string (Timestamp format)

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