TripLog

Nhật ký của tài nguyên Chuyến đi trong Công cụ quản lý đội xe.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "status": enum (TripStatusLog),
  "tripType": enum (TripTypeLog),
  "vehicleId": string,
  "lastLocation": {
    object (VehicleLocationLog)
  },
  "currentRouteSegmentEndPoint": {
    object (TripWaypointLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "actualPickupPoint": {
    object (StopLocationLog)
  },
  "actualPickupArrivalPoint": {
    object (StopLocationLog)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocationLog)
    }
  ],
  "intermediateDestinationIndex": integer,
  "intermediateDestinationsVersion": string,
  "actualIntermediateDestinations": [
    {
      object (StopLocationLog)
    }
  ],
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocationLog)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "actualDropoffPoint": {
    object (StopLocationLog)
  },
  "dropoffTime": string,
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "numberOfPassengers": integer,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolylineLog)
  },
  "attributes": [
    {
      object (TripAttributeLog)
    }
  ]
}
Trường
name

string

Tên tài nguyên chuyến đi ở định dạng providers/{providerId}/trips/{tripId}.

status

enum (TripStatusLog)

Trạng thái chuyến đi.

tripType

enum (TripTypeLog)

Loại chuyến đi.

vehicleId

string

Mã nhận dạng của xe được chỉ định cho chuyến đi.

lastLocation

object (VehicleLocationLog)

Vị trí được báo cáo gần đây nhất của xe dọc theo tuyến đường.

currentRouteSegmentEndPoint

object (TripWaypointLog)

Điểm trung gian nơi currentRouteSegment kết thúc.

pickupPoint

object (TerminalLocationLog)

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

actualPickupPoint

object (StopLocationLog)

Vị trí thực tế nơi khách hàng được đón.

actualPickupArrivalPoint

object (StopLocationLog)

Thời gian và vị trí thực tế mà tài xế đến điểm đón. Trường này cho phép nhà cung cấp đưa ra ý kiến phản hồi về thông tin đến thực tế tại điểm đón.

pickupTime

string (Timestamp format)

Thời gian khách hàng đến gửi xe. Có thể là trong tương lai hoặc quá khứ.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

intermediateDestinations[]

object (TerminalLocationLog)

Điểm dừng trung gian theo thứ tự yêu cầu (ngoài điểm đón và điểm trả khách).

intermediateDestinationIndex

integer

Khi TripStatusENROUTE_TO_INTERMEDIATE_DESTINATION, một số trong khoảng [0..N-1] cho biết đích đến trung gian tiếp theo mà xe sẽ đi qua. Khi TripStatusARRIVED_AT_INTERMEDIATE_DESTINATION, một số trong khoảng [0..N-1] cho biết đích đến trung gian nào là vị trí hiện tại của xe.

intermediateDestinationsVersion

string (Timestamp format)

Phiên bản của đích đến trung gian được cung cấp

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

actualIntermediateDestinations[]

object (StopLocationLog)

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

actualIntermediateDestinationArrivalPoints[]

object (StopLocationLog)

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

dropoffPoint

object (TerminalLocationLog)

Vị trí mà khách hàng cho biết họ sẽ được thả xuống.

actualDropoffPoint

object (StopLocationLog)

Vị trí thực tế mà khách hàng được đưa đến.

dropoffTime

string (Timestamp format)

Thời gian khách hàng sẽ được hoặc đã được đưa đến nơi.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

remainingDistanceMeters

integer

Quãng đường còn lại để lái xe trong đoạn đường hiện tại.

etaToFirstWaypoint

string (Timestamp format)

Thời gian đến điểm trung gian tiếp theo (mục đầu tiên trong trường Trip.remaining_waypoints).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

remainingTimeToFirstWaypoint

string (Duration format)

Thời gian còn lại đến điểm trung gian tiếp theo (mục đầu tiên trong trường Trip.remaining_waypoints).

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

numberOfPassengers

integer

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ó chỗ trống thì mới được trả về trong SearchVehicles.

currentRouteSegmentTraffic

object (ConsumableTrafficPolylineLog)

Tình trạng giao thông dọc theo currentRouteSegment (nếu có).

attributes[]

object (TripAttributeLog)

Danh sách các thuộc tính tuỳ chỉnh của chuyến đi.

StopLocationLog

Vị trí thực tế nơi diễn ra điểm dừng (nhận/trả khách).

Biểu diễn dưới dạng JSON
{
  "timestamp": string,
  "point": {
    object (LatLng)
  }
}
Trường
timestamp

string (Timestamp format)

Dấu thời gian khi vị trí được ghi lại.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

point

object (LatLng)

Cho biết vị trí thực tế của điểm dừng.

TripAttributeLog

Một thuộc tính được biểu thị dưới dạng cặp khoá-giá trị được liên kết với một Chuyến đi.

Biểu diễn dưới dạng JSON
{
  "key": string,

  // Union field trip_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field trip_attribute_value.
}
Trường
key

string

Khoá của thuộc tính.

Trường hợp hợp nhất trip_attribute_value. Giá trị của thuộc tính có thể ở dạng chuỗi, bool hoặc double. trip_attribute_value chỉ có thể là một trong những loại sau:
stringValue

string

Giá trị thuộc tính được nhập dưới dạng chuỗi.

boolValue

boolean

Giá trị thuộc tính được nhập Boolean.

numberValue

number

Giá trị thuộc tính được nhập hai lần.