Package maps.fleetengine.v1

Chỉ mục

TripService

Dịch vụ quản lý chuyến đi.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Tạo một chuyến đi trong Công cụ quản lý đội xe và trả về chuyến đi mới.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Nhận thông tin về một chuyến đi.
ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Báo cáo mức sử dụng chuyến đi có thể tính phí.
SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Nhận tất cả các chuyến đi cho một xe cụ thể.
UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

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

VehicleService

Dịch vụ quản lý xe.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Tạo bản sao cho một xe mới liên kết với một nhà cung cấp dịch vụ đi chung xe hoặc giao hàng theo yêu cầu. Mỗi Vehicle phải có một mã nhận dạng xe duy nhất.

Các trường Vehicle sau đây là bắt buộc khi tạo Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Các trường Vehicle sau đây sẽ bị bỏ qua khi tạo Vehicle:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

Tất cả các trường khác là không bắt buộc và được sử dụng nếu được cung cấp.
GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Trả về một xe từ Công cụ quản lý đội xe.
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Trả về danh sách xe được phân trang liên kết với một nhà cung cấp phù hợp với các lựa chọn yêu cầu.
SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Trả về danh sách các xe phù hợp với các tuỳ chọn yêu cầu.
UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Ghi dữ liệu xe đã cập nhật vào Công cụ quản lý đội xe.

Khi cập nhật Vehicle, bạn không thể cập nhật các trường sau đây vì các trường này do máy chủ quản lý:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

Bạn cũng không thể cập nhật name của xe.

Nếu trường attributes được cập nhật, tất cả thuộc tính của xe sẽ được thay thế bằng các thuộc tính được cung cấp trong yêu cầu. Nếu bạn chỉ muốn cập nhật một số thuộc tính, hãy xem phương thức UpdateVehicleAttributes. Tương tự, bạn có thể cập nhật trường waypoints, nhưng trường này phải chứa tất cả các điểm trung gian hiện có trên xe và không có điểm trung gian nào khác.
UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Cập nhật một phần các thuộc tính của xe. Chỉ những thuộc tính được đề cập trong yêu cầu mới được cập nhật, các thuộc tính khác KHÔNG bị thay đổi. Lưu ý: điều này khác với UpdateVehicle, trong đó toàn bộ trường attributes sẽ được thay thế bằng trường trong UpdateVehicleRequest, các thuộc tính không có trong yêu cầu sẽ bị xoá.

BatteryInfo

Thông tin về pin của thiết bị.

Trường
battery_status

BatteryStatus

Trạng thái của pin, liệu pin đã đầy hay đang sạc, v.v.
power_source

PowerSource

Trạng thái của nguồn pin.
battery_percentage

float

Phần trăm pin hiện tại [0-100].

BatteryStatus

Trạng thái của pin, liệu pin đã đầy hay đang sạc, v.v.

Enum
UNKNOWN_BATTERY_STATUS Trạng thái pin không xác định.
BATTERY_STATUS_CHARGING Pin đang sạc.
BATTERY_STATUS_DISCHARGING Pin đang xả.
BATTERY_STATUS_FULL Pin đã đầy.
BATTERY_STATUS_NOT_CHARGING Pin không sạc.
BATTERY_STATUS_POWER_LOW Pin yếu.

BillingPlatformIdentifier

Một tập hợp các giá trị cho biết yêu cầu được đưa ra trên nền tảng nào.

Enum
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Mặc định. Dùng cho các nền tảng không xác định.
SERVER Nền tảng này là một máy chủ ứng dụng.
WEB Nền tảng này là một trình duyệt web.
ANDROID Nền tảng là một thiết bị di động Android.
IOS Nền tảng là một thiết bị di động iOS.
OTHERS Các nền tảng khác không có trong danh sách liệt kê này.

ConsumableTrafficPolyline

Mật độ giao thông dọc theo lộ trình của Xe.

Trường
speed_reading_interval[]

SpeedReadingInterval

Tốc độ giao thông dọc theo đường dẫn từ điểm trung gian trước đó đến điểm trung gian hiện tại.
encoded_path_to_waypoint

string

Đường dẫn mà trình điều khiển đang đi từ điểm trung gian trước đó đến điểm trung gian hiện tại. Đường dẫn này có các điểm đánh dấu để ứng dụng có thể hiển thị điểm đánh dấu lưu lượng truy cập dọc theo đường dẫn (xem speed_reading_interval). Tính năng giải mã chưa được hỗ trợ.

CreateTripRequest

Thông báo yêu cầu CreateTrip.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
trip_id

string

Bắt buộc. Mã chuyến đi duy nhất. Chịu các hạn chế sau:

  • Phải là một chuỗi Unicode hợp lệ.
  • Giới hạn độ dài tối đa là 64 ký tự.
  • Được chuẩn hoá theo Dạng chuẩn hoá Unicode C.
  • Không được chứa bất kỳ ký tự ASCII nào sau đây: '/', ':', '?', ',' hoặc '#'.
trip

Trip

Bắt buộc. Thực thể chuyến đi cần tạo.

Khi tạo chuyến đi, bạn phải điền vào các trường sau:

  • trip_type
  • pickup_point

Các trường sau đây sẽ được sử dụng nếu bạn cung cấp:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Tất cả các trường Chuyến đi khác đều bị bỏ qua. Ví dụ: tất cả các chuyến đi đều bắt đầu bằng trip_status của NEW ngay cả khi bạn truyền vào trip_status của CANCELED trong yêu cầu tạo.

Chỉ các chuyến đi EXCLUSIVE mới hỗ trợ intermediate_destinations.

Khi đặt vehicle_id cho một chuyến đi chung, bạn phải cung cấp danh sách Trip.vehicle_waypoints để chỉ định thứ tự của các điểm trung gian còn lại cho xe, nếu không, thứ tự điểm trung gian sẽ không xác định được.

Khi bạn chỉ định Trip.vehicle_waypoints, danh sách phải chứa tất cả các điểm trung gian còn lại của chuyến đi của xe, không có điểm trung gian nào khác. Bạn phải sắp xếp các điểm trung gian này sao cho đối với một chuyến đi nhất định, điểm đón xe nằm trước các điểm đến trung gian và tất cả các điểm đến trung gian nằm trước điểm trả khách. Các điểm trung gian của một chuyến đi EXCLUSIVE không được xen kẽ với bất kỳ chuyến đi nào khác.

Các trường trip_id, waypoint_type và location được sử dụng và tất cả các trường TripWaypoint khác trong vehicle_waypoints sẽ bị bỏ qua.

CreateVehicleRequest

Tin nhắn yêu cầu CreateVehicle.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
vehicle_id

string

Bắt buộc. Mã nhận dạng xe duy nhất. Chịu các hạn chế sau:

  • Phải là một chuỗi Unicode hợp lệ.
  • Giới hạn độ dài tối đa là 64 ký tự.
  • Được chuẩn hoá theo Dạng chuẩn hoá Unicode C.
  • Không được chứa bất kỳ ký tự ASCII nào sau đây: '/', ':', '?', ',' hoặc '#'.
vehicle

Vehicle

Bắt buộc. Thực thể Xe cần tạo. Khi tạo Xe, bạn phải điền vào các trường sau:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Khi tạo Xe, các trường sau đây sẽ bị bỏ qua:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

Tất cả các trường khác là không bắt buộc và được sử dụng nếu được cung cấp.

DeviceSettings

Thông tin về nhiều chế độ cài đặt trên thiết bị di động.

Trường
location_power_save_mode

LocationPowerSaveMode

Cách thiết lập các tính năng vị trí trên thiết bị khi bật trình tiết kiệm pin.
is_power_save_mode

bool

Liệu thiết bị có đang ở chế độ tiết kiệm pin hay không.
is_interactive

bool

Liệu thiết bị có ở trạng thái tương tác hay không.
battery_info

BatteryInfo

Thông tin về trạng thái pin.

GetTripRequest

Thông báo yêu cầu GetTrip.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/trips/{trip}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
view

TripView

Tập hợp con các trường Chuyến đi cần được trả về và cách diễn giải các trường đó.
current_route_segment_version

Timestamp

Cho biết dấu thời gian tối thiểu (riêng biệt) để truy xuất dữ liệu Trip.route hoặc Trip.current_route_segment. Nếu dữ liệu tuyến đường không thay đổi kể từ dấu thời gian này, thì trường tuyến đường sẽ không được đặt trong phản hồi. Nếu không chỉ định số lượng tối thiểu, dữ liệu tuyến đường sẽ luôn được truy xuất.
remaining_waypoints_version

Timestamp

Cho biết dấu thời gian tối thiểu (không bao gồm) mà Trip.remaining_waypoints được truy xuất. Nếu các giá trị này không thay đổi kể từ dấu thời gian này, thì remaining_waypoints sẽ không được đặt trong phản hồi. Nếu bạn không chỉ định trường này, remaining_waypoints sẽ luôn được truy xuất.
route_format_type

PolylineFormatType

Định dạng tuyến hiện tại được trả về, LAT_LNG_LIST_TYPE (trong Trip.route) hoặc ENCODED_POLYLINE_TYPE (trong Trip.current_route_segment). Định dạng mặc định là LAT_LNG_LIST_TYPE.
current_route_segment_traffic_version

Timestamp

Cho biết dấu thời gian tối thiểu (không bao gồm) mà Trip.current_route_segment_traffic được truy xuất. Nếu dữ liệu lưu lượng truy cập không thay đổi kể từ dấu thời gian này, thì trường current_route_segment_traffic sẽ không được đặt trong phản hồi. Nếu bạn không chỉ định mức tối thiểu, dữ liệu lưu lượng truy cập sẽ luôn được truy xuất. Xin lưu ý rằng lưu lượng truy cập chỉ dành cho khách hàng sử dụng Giải pháp gọi xe và giao hàng theo yêu cầu.
remaining_waypoints_route_version

Timestamp

Cho biết dấu thời gian tối thiểu (không bao gồm) để truy xuất dữ liệu Trip.remaining_waypoints.traffic_to_waypoint và Trip.remaining_waypoints.path_to_waypoint. Nếu dữ liệu không thay đổi kể từ dấu thời gian này, thì các trường ở trên sẽ không được đặt trong phản hồi. Nếu không chỉ định remaining_waypoints_route_version, lưu lượng truy cập và đường dẫn sẽ luôn được truy xuất.

GetVehicleRequest

Tin nhắn yêu cầu GetVehicle.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/vehicles/{vehicle}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
current_route_segment_version

Timestamp

Cho biết dấu thời gian tối thiểu (không bao gồm) mà Vehicle.current_route_segment được truy xuất. Nếu tuyến đường không thay đổi kể từ dấu thời gian này, thì trường current_route_segment sẽ không được đặt trong phản hồi. Nếu bạn không chỉ định giá trị tối thiểu, current_route_segment sẽ luôn được truy xuất.
waypoints_version

Timestamp

Cho biết dấu thời gian tối thiểu (không bao gồm) để truy xuất dữ liệu Vehicle.waypoints. Nếu các điểm trung gian không thay đổi kể từ dấu thời gian này, thì dữ liệu vehicle.waypoints sẽ không được đặt trong phản hồi. Nếu bạn không chỉ định trường này, vehicle.waypoints sẽ luôn được truy xuất.

LicensePlate

Thông tin biển số xe. Để tránh lưu trữ thông tin nhận dạng cá nhân, chỉ thông tin tối thiểu về biển số xe mới được lưu trữ trong thực thể.

Trường
country_code

string

Bắt buộc. Mã quốc gia/khu vực CLDR. Ví dụ: US cho Hoa Kỳ hoặc IN cho Ấn Độ.
last_character

string

Chữ số cuối cùng của biển số hoặc "-1" để biểu thị không có giá trị số trong biển số.

  • "ABC 1234" -> "4"
  • "AB 123 CD" -> "3"
  • "ABCDEF" -> "-1"

ListVehiclesRequest

Tin nhắn yêu cầu ListVehicles.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
page_size

int32

Số lượng xe tối đa cần trả về. Giá trị mặc định: 100.
page_token

string

Giá trị của next_page_token do lệnh gọi trước đó đến ListVehicles cung cấp để bạn có thể phân trang qua các nhóm xe. Giá trị này không xác định nếu tiêu chí lọc của yêu cầu không giống với tiêu chí lọc cho lệnh gọi trước đó đến ListVehicles.
minimum_capacity

Int32Value

Chỉ định sức chứa tối thiểu bắt buộc của xe. Tất cả các phương tiện được trả về sẽ có maximum_capacity lớn hơn hoặc bằng giá trị này. Nếu được đặt, phải lớn hơn hoặc bằng 0.
trip_types[]

TripType

Hạn chế phản hồi ở những phương tiện hỗ trợ ít nhất một trong các loại chuyến đi đã chỉ định.
maximum_staleness

Duration

Hạn chế phản hồi đối với những xe đã gửi thông tin cập nhật vị trí đến Động cơ của đội xe trong khoảng thời gian được chỉ định. Xe đang đỗ vẫn truyền vị trí của chúng không được coi là lỗi thời. Nếu có, phải là một khoảng thời gian dương hợp lệ.
vehicle_type_categories[]

Category

Bắt buộc. Hạn chế phản hồi đối với những xe thuộc một trong các danh mục loại được chỉ định. UNKNOWN là không được phép.
required_attributes[]

string

Phương thức gọi có thể tạo các phép toán logic phức tạp bằng cách sử dụng bất kỳ tổ hợp nào của các trường required_attributes, required_one_of_attributes và required_one_of_attribute_sets.

required_attributes là một danh sách; required_one_of_attributes sử dụng một thông báo cho phép danh sách danh sách. Khi kết hợp, hai trường này cho phép thành phần của biểu thức này:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Hạn chế phản hồi đối với những chiếc xe có các thuộc tính được chỉ định. Trường này là toán tử kết hợp/AND. Bạn chỉ được chỉ định tối đa 50 required_attributes. Số lượng này khớp với số lượng thuộc tính tối đa được phép trên một xe. Mỗi chuỗi lặp lại phải có định dạng "khoá:giá trị".
required_one_of_attributes[]

string

Hạn chế phản hồi đối với những xe có ít nhất một trong các thuộc tính được chỉ định trong mỗi VehicleAttributeList. Trong mỗi danh sách, một xe phải khớp với ít nhất một thuộc tính. Trường này là một toán tử loại trừ/OR bao gồm trong mỗi VehicleAttributeList và một toán tử kết hợp/AND trên tập hợp VehicleAttributeList. Mỗi chuỗi lặp lại phải có định dạng "khoá1:giá trị1|khoá2:giá trị2|khoá3:giá trị3".
required_one_of_attribute_sets[]

string

required_one_of_attribute_sets cung cấp chức năng bổ sung.

Tương tự như required_one_of_attributes, required_one_of_attribute_sets sử dụng một thông báo cho phép danh sách danh sách, cho phép các biểu thức như sau:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Hạn chế phản hồi đối với những chiếc xe khớp với tất cả các thuộc tính trong VehicleAttributeList. Trong mỗi danh sách, một xe phải khớp với tất cả các thuộc tính. Trường này là một toán tử kết hợp/AND trong mỗi VehicleAttributeList và toán tử loại trừ bao hàm/OR trên tập hợp VehicleAttributeList. Mỗi chuỗi lặp lại phải có định dạng "khoá1:giá trị1|khoá2:giá trị2|khoá3:giá trị3".
vehicle_state

VehicleState

Hạn chế phản hồi đối với những xe có trạng thái xe này.
on_trip_only

bool

Chỉ trả về những xe có(các) chuyến đi hiện tại.
filter

string

Không bắt buộc. Truy vấn bộ lọc để áp dụng khi đăng xe. Hãy xem http://aip.dev/160 để biết ví dụ về cú pháp bộ lọc.

Trường này được thiết kế để thay thế các trường required_attributes, required_one_of_attributes và required_one_of_attributes_sets. Nếu bạn chỉ định một giá trị không trống tại đây, thì các trường sau phải để trống: required_attributes, required_one_of_attributes và required_one_of_attributes_sets.

Bộ lọc này hoạt động như một mệnh đề AND với các quy tắc ràng buộc khác, chẳng hạn như vehicle_state hoặc on_trip_only.

Xin lưu ý rằng các truy vấn duy nhất được hỗ trợ là về các thuộc tính của xe (ví dụ: attributes.<key> = <value> hoặc attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Số lượng hạn chế tối đa được phép trong một truy vấn bộ lọc là 50.

Ngoài ra, tất cả các thuộc tính đều được lưu trữ dưới dạng chuỗi, vì vậy, việc so sánh duy nhất được hỗ trợ đối với các thuộc tính là so sánh chuỗi. Để so sánh với giá trị số hoặc boolean, các giá trị đó phải được đặt trong dấu ngoặc kép rõ ràng để được coi là chuỗi (ví dụ: attributes.<key> = "10" hoặc attributes.<key> = "true").
viewport

Viewport

Không bắt buộc. Bộ lọc giới hạn các xe được trả về ở những vị trí đã biết gần đây nhất nằm trong khu vực hình chữ nhật do khung nhìn xác định.

ListVehiclesResponse

Tin nhắn phản hồi ListVehicles.

Trường
vehicles[]

Vehicle

Những xe phù hợp với tiêu chí trong yêu cầu. Số lượng xe tối đa được trả về được xác định bởi trường page_size trong yêu cầu.
next_page_token

string

Mã thông báo để truy xuất trang tiếp theo về xe hoặc để trống nếu không còn xe nào đáp ứng tiêu chí yêu cầu.
total_size

int64

Bắt buộc. Tổng số xe phù hợp với tiêu chí yêu cầu trên tất cả các trang.

LocationPowerSaveMode

Cách định cấu hình các tính năng vị trí để hoạt động trên thiết bị di động khi tính năng "tiết kiệm pin" của thiết bị đang bật. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enum
UNKNOWN_LOCATION_POWER_SAVE_MODE LocationPowerSaveMode không xác định
LOCATION_MODE_NO_CHANGE Trình tiết kiệm pin không được ảnh hưởng đến nhà cung cấp vị trí hoặc trình tiết kiệm pin đang tắt.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Bạn nên tắt nhà cung cấp vị trí dựa trên GPS khi chế độ tiết kiệm pin đang bật và thiết bị không tương tác.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Tất cả nhà cung cấp vị trí phải bị tắt khi chế độ tiết kiệm pin đang bật và thiết bị không tương tác.
LOCATION_MODE_FOREGROUND_ONLY Tất cả các nhà cung cấp vị trí sẽ vẫn hoạt động, nhưng chỉ các ứng dụng trên nền trước mới được cung cấp bản sửa lỗi vị trí.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Dịch vụ vị trí sẽ không bị tắt, nhưng LocationManager sẽ điều tiết tất cả các yêu cầu đến các nhà cung cấp khi thiết bị không tương tác.

LocationSensor

Cảm biến hoặc phương pháp dùng để xác định vị trí.

Enum
UNKNOWN_SENSOR Cảm biến không được chỉ định hoặc không xác định.
GPS GPS hoặc GPS được hỗ trợ.
NETWORK GPS hỗ trợ, mã trạm phát sóng hoặc điểm truy cập Wi-Fi.
PASSIVE Mã tháp phát sóng di động hoặc điểm truy cập Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Vị trí do thiết bị di động xác định là vị trí đường có nhiều khả năng nhất.
CUSTOMER_SUPPLIED_LOCATION Vị trí do khách hàng cung cấp từ một nguồn độc lập. Thông thường, giá trị này được dùng cho vị trí được cung cấp từ các nguồn khác ngoài thiết bị di động chạy SDK Trình điều khiển. Nếu nguồn ban đầu được mô tả bằng một trong các giá trị enum khác, hãy sử dụng giá trị đó. Các vị trí được đánh dấu là CUSTOMER_SUPPLIED_LOCATION thường được cung cấp thông qua last_location.supplemental_location_sensor của Xe.
FLEET_ENGINE_LOCATION Vị trí do Công cụ theo dõi xe tính toán dựa trên các tín hiệu có sẵn. Chỉ có đầu ra. Giá trị này sẽ bị từ chối nếu được nhận trong một yêu cầu.
FUSED_LOCATION_PROVIDER Trình cung cấp vị trí kết hợp của Android.
CORE_LOCATION Trình cung cấp vị trí trên các hệ điều hành của Apple.

Trạng thái điều hướng của xe.

Enum
UNKNOWN_NAVIGATION_STATUS Trạng thái điều hướng không xác định.
NO_GUIDANCE Thành phần điều hướng của ứng dụng Driver (Trình điều khiển) ở chế độ FREE_NAV.
ENROUTE_TO_DESTINATION Bạn có thể sử dụng tính năng chỉ đường từng chặng và tính năng chỉ đường trong ứng dụng Trình điều khiển đã chuyển sang chế độ GUIDED_NAV.
OFF_ROUTE Xe đã đi ra khỏi tuyến đường được đề xuất.
ARRIVED_AT_DESTINATION Xe cách điểm đến khoảng 50 m.

PolylineFormatType

Loại định dạng đa tuyến.

Enum
UNKNOWN_FORMAT_TYPE Định dạng không được chỉ định hoặc không xác định.
LAT_LNG_LIST_TYPE Danh sách google.type.LatLng.
ENCODED_POLYLINE_TYPE Một hình nhiều đường được mã hoá bằng thuật toán nén hình nhiều đường. Chưa hỗ trợ giải mã.

PowerSource

Loại bộ sạc đang dùng để sạc pin.

Enum
UNKNOWN_POWER_SOURCE Không xác định nguồn điện.
POWER_SOURCE_AC Nguồn điện là bộ sạc AC.
POWER_SOURCE_USB Nguồn điện là cổng USB.
POWER_SOURCE_WIRELESS Nguồn điện là không dây.
POWER_SOURCE_UNPLUGGED Pin đã rút phích cắm.

ReportBillableTripRequest

Thông báo yêu cầu ReportBillableTrip.

Trường
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/billableTrips/{billable_trip}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
country_code

string

Bắt buộc. Mã quốc gia gồm hai chữ cái của quốc gia nơi diễn ra chuyến đi. Giá được xác định theo mã quốc gia.
platform

BillingPlatformIdentifier

Nền tảng phát hành yêu cầu.
related_ids[]

string

Giá trị nhận dạng liên quan trực tiếp đến chuyến đi đang được báo cáo. Đây thường là mã nhận dạng (ví dụ: mã phiên) của các thao tác đặt trước được thực hiện trước khi có mã chuyến đi. Số lượng related_ids bị giới hạn ở mức 50.
solution_type

SolutionType

Loại giải pháp sản phẩm GMP (ví dụ: ON_DEMAND_RIDESHARING_AND_DELIVERIES) được dùng cho chuyến đi được báo cáo.

SolutionType

Bộ chọn cho các loại giải pháp khác nhau của một chuyến đi được báo cáo.

Enum
SOLUTION_TYPE_UNSPECIFIED Giá trị mặc định. Để tương thích ngược, theo mặc định, API sẽ sử dụng ON_DEMAND_RIDESHARING_AND_DELIVERIES, đây là loại giải pháp được hỗ trợ đầu tiên.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Giải pháp này là một chuyến đi chia sẻ xe và giao hàng theo yêu cầu.

RequestHeader

RequestHeader chứa các trường phổ biến cho tất cả các yêu cầu RPC của Công cụ của đội xe.

Trường
language_code

string

Mã ngôn ngữ BCP-47, chẳng hạn như en-US hoặc sr-Latn. Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu không có tên nào được chỉ định, câu trả lời có thể bằng ngôn ngữ bất kỳ, ưu tiên tiếng Anh nếu có tên như vậy. Ví dụ về giá trị trường: en-US.
region_code

string

Bắt buộc. Mã vùng CLDR của khu vực nơi yêu cầu bắt nguồn. Ví dụ về giá trị trường: US.
sdk_version

string

Phiên bản của SDK gọi, nếu có. Định dạng phiên bản là "major.minor.patch", ví dụ: 1.1.2.
os_version

string

Phiên bản hệ điều hành mà SDK gọi đang chạy. Ví dụ về giá trị trường: 4.4.1, 12.1.
device_model

string

Mẫu thiết bị mà SDK gọi đang chạy. Ví dụ về giá trị trường: iPhone12,1, SM-G920F.
sdk_type

SdkType

Loại SDK gửi yêu cầu.
maps_sdk_version

string

Phiên bản MapSDK mà SDK gọi phụ thuộc vào, nếu có. Định dạng phiên bản là "major.minor.patch", ví dụ: 5.2.1.
nav_sdk_version

string

Phiên bản NavSDK mà SDK gọi phụ thuộc vào, nếu có. Định dạng phiên bản là "major.minor.patch", ví dụ: 2.1.0.
platform

Platform

Nền tảng của SDK gọi.
manufacturer

string

Nhà sản xuất thiết bị Android từ SDK gọi, chỉ áp dụng cho SDK Android. Ví dụ về giá trị trường: Samsung.
android_api_level

int32

Cấp độ API Android của SDK gọi, chỉ áp dụng cho các SDK Android. Ví dụ về giá trị trường: 23.
trace_id

string

Mã nhận dạng không bắt buộc có thể được cung cấp cho mục đích ghi nhật ký để xác định yêu cầu.

Nền tảng

Nền tảng của SDK gọi.

Enum
PLATFORM_UNSPECIFIED Giá trị mặc định. Giá trị này được dùng nếu bạn bỏ qua nền tảng.
ANDROID Yêu cầu đến từ Android.
IOS Yêu cầu đến từ iOS.
WEB Yêu cầu đến từ web.

SdkType

Các loại SDK có thể có.

Enum
SDK_TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này được sử dụng nếu bạn bỏ qua sdk_type.
CONSUMER SDK gọi là Consumer.
DRIVER SDK gọi là Trình điều khiển.
JAVASCRIPT SDK gọi là JavaScript.

SearchTripsRequest

Thông báo yêu cầu SearchTrips.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
vehicle_id

string

Xe được liên kết với các chuyến đi trong yêu cầu. Nếu không chỉ định, các chuyến đi được trả về sẽ không chứa:

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

Nếu bạn đặt giá trị này thành true, thì phản hồi sẽ bao gồm các Chuyến đi ảnh hưởng đến tuyến đường của người lái xe.
page_size

int32

Nếu bạn không đặt, máy chủ sẽ quyết định số lượng kết quả cần trả về.
page_token

string

Đặt giá trị này thành giá trị đã trả về trước đó trong SearchTripsResponse để tiếp tục từ các kết quả trước đó.
minimum_staleness

Duration

Nếu được chỉ định, sẽ trả về các chuyến đi chưa được cập nhật sau thời gian (current - minimum_staleness).

SearchTripsResponse

Thông báo phản hồi của SearchTrips.

Trường
trips[]

Trip

Danh sách chuyến đi cho xe được yêu cầu.
next_page_token

string

Truyền mã thông báo này trong SearchTripsRequest để phân trang qua kết quả danh sách. API trả về một danh sách chuyến đi trong mỗi lệnh gọi và khi không còn kết quả nào, danh sách chuyến đi sẽ trống.

SearchVehiclesRequest

Tin nhắn yêu cầu SearchVehicles.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
pickup_point

TerminalLocation

Bắt buộc. Điểm đến lấy hàng để tìm kiếm ở gần.
dropoff_point

TerminalLocation

Địa điểm giao hàng mà khách hàng dự định. Trường này là bắt buộc nếu trip_types chứa TripType.SHARED.
pickup_radius_meters

int32

Bắt buộc. Xác định bán kính tìm kiếm xe xung quanh điểm đón. Hệ thống sẽ chỉ trả về những chiếc xe nằm trong bán kính tìm kiếm. Giá trị phải nằm trong khoảng từ 400 đến 10.000 mét (bao gồm).
count

int32

Bắt buộc. Chỉ định số lượng xe tối đa cần trả về. Giá trị phải nằm trong khoảng từ 1 đến 50 (bao gồm).
minimum_capacity

int32

Bắt buộc. Chỉ định số lượng hành khách đang được xem xét cho một chuyến đi. Giá trị phải lớn hơn hoặc bằng 1. Người lái xe không được tính trong giá trị sức chứa.
trip_types[]

TripType

Bắt buộc. Biểu thị loại chuyến đi được đề xuất. Phải có đúng một loại. UNKNOWN_TRIP_TYPE là không được phép. Chỉ cho phép tìm kiếm những loại xe có thể hỗ trợ loại chuyến đi đó.
maximum_staleness

Duration

Chỉ cho phép tìm kiếm những xe đã gửi thông tin cập nhật vị trí đến Công cụ quản lý đội xe trong khoảng thời gian đã chỉ định. Xe đang đỗ vẫn truyền vị trí của chúng không được coi là lỗi thời. Nếu bạn không đặt trường này, máy chủ sẽ sử dụng 5 phút làm giá trị mặc định.
vehicle_types[]

VehicleType

Bắt buộc. Hạn chế kết quả tìm kiếm ở những loại xe thuộc một trong các loại đã chỉ định. Bạn phải chỉ định ít nhất một loại xe. Không được phép sử dụng VehicleTypes có danh mục là UNKNOWN.
required_attributes[]

VehicleAttribute

Phương thức gọi có thể tạo các phép toán logic phức tạp bằng cách sử dụng bất kỳ tổ hợp nào của các trường required_attributes, required_one_of_attributes và required_one_of_attribute_sets.

required_attributes là một danh sách; required_one_of_attributes sử dụng một thông báo cho phép danh sách danh sách. Khi kết hợp, hai trường này cho phép thành phần của biểu thức này:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Chỉ cho phép tìm kiếm những chiếc xe có các thuộc tính được chỉ định. Trường này là toán tử kết hợp/AND. Bạn chỉ được chỉ định tối đa 50 required_attributes. Số lượng này khớp với số lượng thuộc tính tối đa được phép trên một xe.
required_one_of_attributes[]

VehicleAttributeList

Chỉ cho phép tìm kiếm những chiếc xe có ít nhất một trong các thuộc tính được chỉ định trong mỗi VehicleAttributeList. Trong mỗi danh sách, một xe phải khớp với ít nhất một thuộc tính. Trường này là một toán tử loại trừ/OR bao gồm trong mỗi VehicleAttributeList và một toán tử kết hợp/AND trên tập hợp VehicleAttributeList.
required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets cung cấp chức năng bổ sung.

Tương tự như required_one_of_attributes, required_one_of_attribute_sets sử dụng một thông báo cho phép danh sách danh sách, cho phép các biểu thức như sau:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Chỉ cho phép tìm kiếm những chiếc xe có tất cả các thuộc tính trong VehicleAttributeList. Trong mỗi danh sách, một xe phải khớp với tất cả các thuộc tính. Trường này là một toán tử kết hợp/AND trong mỗi VehicleAttributeList và toán tử loại trừ bao hàm/OR trên tập hợp VehicleAttributeList.
order_by

VehicleMatchOrder

Bắt buộc. Chỉ định tiêu chí sắp xếp mong muốn cho kết quả.
include_back_to_back

bool

Giá trị này cho biết liệu những chiếc xe có một chuyến đi đang hoạt động có đủ điều kiện cho lượt tìm kiếm này hay không. Trường này chỉ được dùng khi current_trips_present không được chỉ định. Khi current_trips_present không được chỉ định và trường này là false, các phương tiện có chuyến đi được chỉ định sẽ bị loại trừ khỏi kết quả tìm kiếm. Khi current_trips_present không được chỉ định và trường này là true, kết quả tìm kiếm có thể bao gồm các xe có một chuyến đi đang hoạt động có trạng thái là ENROUTE_TO_DROPOFF. Khi chỉ định current_trips_present, bạn không thể đặt trường này thành true.

Giá trị mặc định là false.
trip_id

string

Cho biết chuyến đi được liên kết với SearchVehicleRequest này.
current_trips_present

CurrentTripsPresent

Giá trị này cho biết liệu những xe có chuyến đi đang hoạt động có đủ điều kiện cho lượt tìm kiếm này hay không. Bạn phải đặt giá trị này thành một giá trị khác CURRENT_TRIPS_PRESENT_UNSPECIFIED nếu trip_type bao gồm SHARED.
filter

string

Không bắt buộc. Truy vấn bộ lọc để áp dụng khi tìm kiếm xe. Hãy xem http://aip.dev/160 để biết ví dụ về cú pháp bộ lọc.

Trường này được thiết kế để thay thế các trường required_attributes, required_one_of_attributes và required_one_of_attributes_sets. Nếu bạn chỉ định một giá trị không trống tại đây, thì các trường sau phải để trống: required_attributes, required_one_of_attributes và required_one_of_attributes_sets.

Bộ lọc này hoạt động như một mệnh đề AND với các quy tắc ràng buộc khác, chẳng hạn như minimum_capacity hoặc vehicle_types.

Xin lưu ý rằng các truy vấn duy nhất được hỗ trợ là về các thuộc tính của xe (ví dụ: attributes.<key> = <value> hoặc attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Số lượng hạn chế tối đa được phép trong một truy vấn bộ lọc là 50.

Ngoài ra, tất cả các thuộc tính đều được lưu trữ dưới dạng chuỗi, vì vậy, việc so sánh duy nhất được hỗ trợ đối với các thuộc tính là so sánh chuỗi. Để so sánh với giá trị số hoặc boolean, các giá trị đó phải được đặt trong dấu ngoặc kép rõ ràng để được coi là chuỗi (ví dụ: attributes.<key> = "10" hoặc attributes.<key> = "true").

CurrentTripsPresent

Chỉ định các loại quy định hạn chế đối với các chuyến đi hiện tại của một xe.

Enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED Tình trạng còn xe của những xe có chuyến đi được điều chỉnh theo trường include_back_to_back.
NONE Xe không có chuyến đi có thể xuất hiện trong kết quả tìm kiếm. Khi sử dụng giá trị này, include_back_to_back không được là true.
ANY Những xe có tối đa 5 chuyến đi hiện tại và 10 điểm trung gian sẽ xuất hiện trong kết quả tìm kiếm. Khi sử dụng giá trị này, include_back_to_back không được là true.

VehicleMatchOrder

Chỉ định thứ tự của các kết quả trùng khớp về xe trong phản hồi.

Enum
UNKNOWN_VEHICLE_MATCH_ORDER Mặc định, dùng cho đơn đặt hàng khớp với xe không được chỉ định hoặc không được nhận dạng.
PICKUP_POINT_ETA Sắp xếp theo thứ tự tăng dần theo thời gian lái xe đến điểm đến lấy hàng.
PICKUP_POINT_DISTANCE Sắp xếp theo thứ tự tăng dần theo quãng đường lái xe đến điểm đến lấy hàng.
DROPOFF_POINT_ETA Sắp xếp theo thứ tự tăng dần theo thời gian lái xe đến điểm trả khách. Bạn chỉ có thể sử dụng đơn đặt hàng này nếu điểm trả hàng được chỉ định trong yêu cầu.
PICKUP_POINT_STRAIGHT_DISTANCE Sắp xếp tăng dần theo khoảng cách theo đường thẳng từ vị trí được báo cáo gần đây nhất của xe đến điểm đón.
COST Thứ tự tăng dần theo chi phí khớp đã định cấu hình. Chi phí khớp được xác định là kết quả tính toán theo trọng số giữa khoảng cách theo đường thẳng và ETA. Hệ số được đặt bằng các giá trị mặc định và có thể được sửa đổi theo từng khách hàng. Vui lòng liên hệ với nhóm hỗ trợ Google nếu bạn cần sửa đổi các trọng số này cho dự án của mình.

SearchVehiclesResponse

Tin nhắn phản hồi SearchVehicles.

Trường
matches[]

VehicleMatch

Danh sách xe phù hợp với tiêu chí SearchVehiclesRequest, được sắp xếp theo trường SearchVehiclesRequest.order_by.

SpeedReadingInterval

Chỉ báo mật độ giao thông trên một đoạn liên tục của một đường dẫn. Với một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên 0), SpeedReadingInterval xác định một khoảng thời gian và mô tả lưu lượng truy cập của khoảng thời gian đó bằng các danh mục sau.

Trường
start_polyline_point_index

int32

Chỉ mục bắt đầu của khoảng thời gian này trong đường dẫn. Trong JSON, khi chỉ mục là 0, trường sẽ có vẻ như không được điền sẵn.
end_polyline_point_index

int32

Chỉ mục kết thúc của khoảng thời gian này trong đường dẫn. Trong JSON, khi chỉ mục là 0, trường sẽ có vẻ như không được điền sẵn.
speed

Speed

Tốc độ giao thông trong khoảng thời gian này.

Tốc độ

Phân loại tốc độ của đường đa tuyến dựa trên dữ liệu giao thông.

Enum
SPEED_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
NORMAL Tốc độ bình thường, không phát hiện thấy hiện tượng chậm.
SLOW Phát hiện tình trạng chậm lại nhưng không có nút thắt cổ chai nào hình thành.
TRAFFIC_JAM Đã phát hiện ách tắc giao thông.

StopLocation

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

Trường
point

LatLng

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

Timestamp

Cho biết thời điểm dừng.
stop_time
(deprecated)

Timestamp

Chỉ nhập. Không dùng nữa. Sử dụng trường dấu thời gian.

TerminalLocation

Mô tả vị trí của một điểm trung gian.

Trường
point

LatLng

Bắt buộc. Cho biết vị trí của điểm trung gian trong chuyến đi.
terminal_point_id
(deprecated)

TerminalPointId

Ngừng sử dụng: Thay vào đó, hãy chỉ định trường point.
access_point_id
(deprecated)

string

Ngừng sử dụng: Thay vào đó, hãy chỉ định trường point.
trip_id
(deprecated)

string

Không dùng nữa.
terminal_location_type
(deprecated)

WaypointType

Ngừng sử dụng: Vehicle.waypoint sẽ có dữ liệu này.

TerminalPointId

Không dùng nữa: TerminalPoints không còn được hỗ trợ trong Fleet Engine. Thay vào đó, hãy sử dụng TerminalLocation.point.

Trường
value
(deprecated)

string

Không dùng nữa.
Trường hợp hợp nhất Id. Không dùng nữa. Id chỉ có thể là một trong những loại sau:
place_id
(deprecated)

string

Không dùng nữa.
generated_id
(deprecated)

string

Không dùng nữa.

TrafficPolylineData

Tình trạng giao thông dọc theo tuyến đường dự kiến của xe.

Trường
traffic_rendering

VisualTrafficReportPolylineRendering

Một đường đa tuyến thể hiện tốc độ giao thông của tất cả các khu vực dọc theo một đoạn đường mà khách hàng đi qua.

Chuyến đi

Siêu dữ liệu về chuyến đi.

Trường
name

string

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

string

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

TripStatus

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

TripType

Loại chuyến đi.
pickup_point

TerminalLocation

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

StopLocation

Chỉ nhập. Vị trí thực tế khi khách hàng được đón và nơi khách hàng được đó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 thực tế về điểm đến lấy hàng.
actual_pickup_arrival_point

StopLocation

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

Timestamp

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

TerminalLocation

Điểm dừng trung gian theo yêu cầu của chuyến đi (ngoài điểm đón và điểm trả khách). Ban đầu, tính năng này sẽ không được hỗ trợ cho các chuyến đi được chia sẻ.
intermediate_destinations_version

Timestamp

Cho biết lần sửa đổi gần nhất của intermediate_destinations. 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 intermediate_destination_index để đảm bảo intermediate_destinations không bị thay đổi.
intermediate_destination_index

int32

Khi TripStatus là ENROUTE_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 TripStatus là ARRIVED_AT_INTERMEDIATE_DESTINATION, một số 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ó intermediate_destinations, trường này sẽ bị bỏ qua.
actual_intermediate_destination_arrival_points[]

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à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 các điểm đến trung gian.
actual_intermediate_destinations[]

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à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 tại các điểm đến trung gian.
dropoff_point

TerminalLocation

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

StopLocation

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

Timestamp

Chỉ có đầu ra. Thời gian ước tính trong tương lai khi(các) người đi xe sẽ được thả tại điểm đến cuối cùng hoặc thời gian thực tế khi họ được thả.
remaining_waypoints[]

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

TripWaypoint

Trường này hỗ trợ việc sắp xếp các điểm trung gian theo cách thủ công cho chuyến đi. Tệp này chứa tất cả các điểm trung gian còn lại cho xe được chỉ định, cũng như điểm đón và điểm 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 bảo mật, máy chủ chỉ điền trường này vào các lệnh gọi UpdateTrip và CreateTrip, KHÔNG điền vào các lệnh gọi GetTrip.
route[]

LatLng

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

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 Trình điều khiển SDK và Trình dùng SDK. Chưa hỗ trợ giải mã.
current_route_segment_version

Timestamp

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

ConsumableTrafficPolyline

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

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

Timestamp

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

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

TripWaypoint

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

Int32Value

Chỉ có đầu ra. Quãng đường còn lại để lái xe trong trường current_route_segment. 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ỷ.
eta_to_first_waypoint

Timestamp

Chỉ có đầu ra. Thời gian đến điểm trung gian tiếp theo (mục đầu tiên trong trường remaining_waypoints). 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ỷ).
remaining_time_to_first_waypoint

Duration

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ỷ).
remaining_waypoints_version

Timestamp

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

Timestamp

Chỉ có đầu ra. Cho biết lần gần nhất remaining_waypoints.path_to_waypoint và remaining_waypoints.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 remaining_waypoints chỉ được trả về nếu được cập nhật.
number_of_passengers

int32

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ó chỗ trống để được trả về trong phản hồi SearchVehicles.
last_location

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

bool

Chỉ có đầu ra. Cho biết liệu có thể chụp nhanh last_location của xe vào current_route_segment hay không. Sai nếu last_location hoặc current_route_segment 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 khách sẽ bị bỏ qua.
view

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 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 được nhận dạng.
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 Người lái xe đã đế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 đi xe.
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 đi và đang trên đường đến điểm đến tiếp theo.
COMPLETE Người đi xe đã được đưa đến nơi và chuyến đi đã hoàn tất.
CANCELED Người lái xe, người đi xe hoặc nhà cung cấp dịch vụ đi chung xe đã huỷ chuyến đi trước khi đón khách.

TripType

Loại chuyến đi.

Enum
UNKNOWN_TRIP_TYPE Mặc định, dùng cho các loại chuyến đi không xác định hoặc không được nhận dạng.
SHARED Chuyến đi này có thể dùng chung xe với các chuyến đi khác.
EXCLUSIVE Chuyến đi chỉ dành cho một xe.

TripView

Bộ chọn cho các nhóm trường Chuyến đi khác nhau trong phản hồi GetTrip. Hãy xem AIP-157 để biết thông tin chi tiết. Có thể sẽ có thêm các chế độ xem khác.

Enum
TRIP_VIEW_UNSPECIFIED Giá trị mặc định. Để tương thích ngược, API sẽ mặc định là chế độ xem SDK. Để đảm bảo tính ổn định và khả năng hỗ trợ, khách hàng nên chọn TripView khác với SDK.
SDK Bao gồm các trường có thể không thể diễn giải hoặc hỗ trợ bằng cách sử dụng các thư viện có sẵ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 giữa máy chủ với máy chủ.

TripWaypoint

Mô tả điểm dừng trên tuyến đường của xe hoặc điểm kết thúc trên chuyến đi của xe.

Trường
location

TerminalLocation

Vị trí của điểm trung gian này.
trip_id

string

Chuyến đi được liên kết với điểm trung gian này.
waypoint_type

WaypointType

Vai trò của điểm trung gian này trong chuyến đi này, chẳng hạn như điểm đón hoặc điểm trả khách.
path_to_waypoint[]

LatLng

Đường dẫn từ điểm trung gian trước đó đến điểm trung gian hiện tại. Chưa xác định cho điểm trung gian đầu tiên trong danh sách. Trường này chỉ được điền khi có yêu cầu.
encoded_path_to_waypoint

string

Đường dẫn được mã hoá từ điểm trung gian trước đó đến điểm trung gian hiện tại.

Lưu ý: Trường này chỉ dành cho Trình điều khiển SDK và Trình dùng SDK. Chưa hỗ trợ giải mã.
traffic_to_waypoint

ConsumableTrafficPolyline

Tình trạng giao thông dọc theo đường dẫn đến điểm trung gian này. Xin lưu ý rằng lưu lượng truy cập chỉ dành cho khách hàng sử dụng Giải pháp cho dịch vụ Đi xe và Giao hàng trên Nền tảng Google Maps.
distance_meters

Int32Value

Khoảng cách đường dẫn từ điểm trung gian trước đó đến điểm trung gian hiện tại. Chưa xác định cho điểm trung gian đầu tiên trong danh sách.
eta

Timestamp

Thời gian đến dự kiến tại điểm trung gian này. Chưa xác định cho điểm trung gian đầu tiên trong danh sách.
duration

Duration

Thời gian di chuyển từ điểm trung gian trước đó đến điểm này. Chưa xác định cho điểm trung gian đầu tiên trong danh sách.

UpdateTripRequest

Thông báo yêu cầu UpdateTrip.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/trips/{trip}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-consumer-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
trip

Trip

Bắt buộc. Chuyến đi liên kết với nội dung cập nhật.

Công cụ của đội xe duy trì các trường sau. Không cập nhật các chuyến đi đó bằng Trip.update.

  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_traffic
  • current_route_segment_traffic_version
  • current_route_segment_version
  • dropoff_time
  • eta_to_next_waypoint
  • intermediate_destinations_version
  • last_location
  • name
  • number_of_passengers
  • pickup_time
  • remaining_distance_meters
  • remaining_time_to_first_waypoint
  • remaining_waypoints
  • remaining_waypoints_version
  • route

Khi cập nhật Trip.vehicle_id cho một chuyến đi chung, bạn phải cung cấp danh sách Trip.vehicle_waypoints để chỉ định thứ tự của các điểm trung gian còn lại, nếu không, thứ tự sẽ không xác định.

Khi bạn chỉ định Trip.vehicle_waypoints, danh sách phải chứa tất cả các điểm trung gian còn lại của chuyến đi của xe, không có điểm trung gian nào khác. Bạn phải sắp xếp các điểm trung gian này sao cho đối với một chuyến đi nhất định, điểm đón xe nằm trước các điểm đến trung gian và tất cả các điểm đến trung gian nằm trước điểm trả khách. Các điểm trung gian của một chuyến đi EXCLUSIVE không được xen kẽ với bất kỳ chuyến đi nào khác. Các trường trip_id, waypoint_type và location được sử dụng, còn tất cả các trường TripWaypoint khác trong vehicle_waypoints sẽ bị bỏ qua.

Để tránh tình trạng tương tranh cho các chuyến đi có nhiều điểm đến, bạn nên cung cấp Trip.intermediate_destinations_version khi cập nhật trạng thái chuyến đi thành ENROUTE_TO_INTERMEDIATE_DESTINATION. Trip.intermediate_destinations_version được truyền phải nhất quán với phiên bản của Công cụ của đội xe. Nếu không, yêu cầu sẽ không thành công.
update_mask

FieldMask

Bắt buộc. Mặt nạ trường cho biết những trường trong chuyến đi cần cập nhật. update_mask phải chứa ít nhất một trường.

UpdateVehicleAttributesRequest

Tin nhắn yêu cầu UpdateVehicleAttributes.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/vehicles/{vehicle}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
attributes[]

VehicleAttribute

Bắt buộc. Các thuộc tính xe cần cập nhật. Các thuộc tính không được đề cập sẽ không bị thay đổi hoặc xoá.

UpdateVehicleAttributesResponse

Thông báo phản hồi UpdateVehicleAttributes.

Trường
attributes[]

VehicleAttribute

Bắt buộc. Danh sách đầy đủ các thuộc tính xe đã cập nhật, bao gồm cả các thuộc tính mới, đã thay đổi và chưa thay đổi.

UpdateVehicleRequest

"Thông báo yêu cầu UpdateVehicle.

Trường
header

RequestHeader

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/vehicles/{vehicle}. {provider} phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
vehicle

Vehicle

Bắt buộc. Giá trị thực thể Vehicle cần áp dụng. Khi cập nhật Vehicle, các trường sau đây có thể không được cập nhật vì các trường này do máy chủ quản lý.

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

Nếu trường attributes được cập nhật, tất cả thuộc tính của xe sẽ được thay thế bằng các thuộc tính được cung cấp trong yêu cầu. Nếu bạn chỉ muốn cập nhật một số thuộc tính, hãy xem phương thức UpdateVehicleAttributes.

Tương tự, bạn có thể cập nhật trường waypoints, nhưng trường này phải chứa tất cả các điểm trung gian hiện có trên xe và không có điểm trung gian nào khác.
update_mask

FieldMask

Bắt buộc. Mặt nạ trường cho biết cần cập nhật những trường nào của Vehicle. Bạn phải cung cấp ít nhất một tên trường.

Loại xe

Siêu dữ liệu của xe.

Trường
name

string

Chỉ có đầu ra. Tên riêng của xe này. Định dạng là providers/{provider}/vehicles/{vehicle}.
vehicle_state

VehicleState

Trạng thái của xe.
supported_trip_types[]

TripType

Các loại chuyến đi mà xe này hỗ trợ.
current_trips[]

string

Chỉ có đầu ra. Danh sách trip_id cho các chuyến đi hiện được chỉ định cho xe này.
last_location

VehicleLocation

Vị trí gần đây nhất được báo cáo của xe.
maximum_capacity

int32

Tổng số người đi xe mà phương tiện này có thể chở. Giá trị này không tính đến trình điều khiển. Giá trị này phải lớn hơn hoặc bằng 1.
attributes[]

VehicleAttribute

Danh sách thuộc tính xe. Một xe có thể có tối đa 100 thuộc tính và mỗi thuộc tính phải có một khoá riêng biệt.
vehicle_type

VehicleType

Bắt buộc. Loại xe này. Có thể dùng để lọc xe trong kết quả SearchVehicles. Đồng thời cũng ảnh hưởng đến thời gian đến dự kiến và cách tính tuyến đường.
license_plate

LicensePlate

Thông tin biển số xe.
route[]
(deprecated)

TerminalLocation

Không dùng nữa: Hãy sử dụng Vehicle.waypoints.
current_route_segment

string

Đường đa tuyến chỉ định tuyến đường mà ứng dụng trình điều khiển dự định đi đến điểm trung gian tiếp theo. Danh sách này cũng được trả về trong Trip.current_route_segment cho tất cả các chuyến đi đang hoạt động được chỉ định cho xe.

Lưu ý: Trường này chỉ dành cho SDK Trình điều khiển. Chưa hỗ trợ giải mã.
current_route_segment_traffic

TrafficPolylineData

Chỉ nhập. Công cụ quản lý đội xe sử dụng thông tin này để cải thiện tính năng chia sẻ hành trình. Lưu ý: Trường này chỉ dành cho SDK Trình điều khiển.
current_route_segment_version

Timestamp

Chỉ có đầu ra. Thời gian đặt current_route_segment. Ứng dụng có thể lưu trữ và truyền mã này trong các yêu cầu GetVehicle trong tương lai để tránh trả về các tuyến chưa thay đổi.
current_route_segment_end_point

TripWaypoint

Điểm trung gian nơi current_route_segment kết thúc. Trình điều khiển có thể cung cấp thông tin này trên các lệnh gọi UpdateVehicle dưới dạng điểm trung gian của toàn bộ chuyến đi, điểm trung gian LatLng hoặc dưới dạng LatLng cuối cùng của current_route_segment. Sau đó, Công cụ của đội xe sẽ cố gắng nội suy đến một điểm trung gian thực tế nếu điểm trung gian đó chưa được chỉ định đầy đủ. Trường này bị bỏ qua trong các lệnh gọi UpdateVehicle trừ phi bạn cũng chỉ định current_route_segment.
remaining_distance_meters

Int32Value

Khoảng cách lái xe còn lại cho current_route_segment. Giá trị này cũng được trả về trong Trip.remaining_distance_meters cho tất cả các chuyến đi đang hoạt động được chỉ định cho xe. Giá trị này không được chỉ định nếu trường current_route_segment trống.
eta_to_first_waypoint

Timestamp

Thời gian đến dự kiến của mục đầu tiên trong trường waypoints. Giá trị này không được chỉ định nếu trường waypoints hoặc trường Vehicle.current_route_segment trống.

Khi cập nhật xe, remaining_time_seconds sẽ được ưu tiên hơn eta_to_first_waypoint trong cùng một yêu cầu.
remaining_time_seconds

Int32Value

Chỉ nhập. Thời gian lái xe còn lại cho current_route_segment. Giá trị này không được chỉ định nếu trường waypoints hoặc trường Vehicle.current_route_segment trống. Giá trị này phải khớp với eta_to_first_waypoint – current_time nếu tất cả các bên đều sử dụng cùng một đồng hồ.

Khi cập nhật xe, remaining_time_seconds sẽ được ưu tiên hơn eta_to_first_waypoint trong cùng một yêu cầu.
waypoints[]

TripWaypoint

Các điểm trung gian còn lại được chỉ định cho Xe này.
waypoints_version

Timestamp

Chỉ có đầu ra. Lần gần đây nhất trường waypoints được cập nhật. Ứng dụng phải lưu giá trị này vào bộ nhớ đệm và truyền giá trị đó trong GetVehicleRequest để đảm bảo trường waypoints chỉ được trả về nếu được cập nhật.
back_to_back_enabled

bool

Cho biết liệu tài xế có chấp nhận các chuyến đi liên tiếp hay không. Nếu true, SearchVehicles có thể bao gồm cả xe đó ngay cả khi xe đó hiện được chỉ định cho một chuyến đi. Giá trị mặc định là false.
navigation_status

NavigationStatus

Trạng thái điều hướng của xe.
device_settings

DeviceSettings

Chỉ nhập. Thông tin về chế độ cài đặt trong thiết bị di động mà người lái xe đang sử dụng.

VehicleType

Loại xe.

Trường
category

Category

Danh mục loại xe

Danh mục

Danh mục loại xe

Enum
UNKNOWN Mặc định, dùng cho các danh mục xe không xác định hoặc không được nhận dạng.
AUTO Một chiếc ô tô.
TAXI Mọi loại xe hoạt động như xe taxi (thường được cấp phép hoặc quản lý).
TRUCK Thường là xe có dung lượng lưu trữ lớn.
TWO_WHEELER Xe mô tô, xe máy hoặc phương tiện hai bánh khác
BICYCLE Phương tiện vận tải do con người vận hành.
PEDESTRIAN Phương tiện vận chuyển con người, thường là đi bộ hoặc chạy dọc theo đường đi bộ.

VehicleAttribute

Mô tả một thuộc tính của xe dưới dạng một cặp khoá-giá trị. Chiều dài chuỗi "khoá:giá trị" không được vượt quá 256 ký tự.

Trường
key

string

Khoá của thuộc tính. Khoá không được chứa ký tự dấu hai chấm (:).
value

string

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

string

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

Lưu ý: Trường này giống với trường value (sẽ không được dùng nữa). Đối với các phương thức tạo hoặc cập nhật, bạn có thể sử dụng một trong hai trường này, nhưng bạn nên sử dụng string_value. Nếu bạn đặt cả string_value và value, thì các giá trị này phải giống nhau, nếu không sẽ xảy ra lỗi. Cả hai trường đều được điền sẵn trong phản hồi.
bool_value

bool

Giá trị thuộc tính được nhập bằng boolean.
number_value

double

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

VehicleAttributeList

Loại dữ liệu danh sách-danh sách cho các thuộc tính của xe.

Trường
attributes[]

VehicleAttribute

Danh sách các thuộc tính trong bộ sưu tập này.

VehicleLocation

Vị trí, tốc độ và hướng của một xe tại một thời điểm.

Trường
location

LatLng

Vị trí của xe. Khi được gửi đến Công cụ quản lý đội xe, vị trí của xe là vị trí GPS. Khi bạn nhận được thông tin này trong một phản hồi, vị trí của xe có thể là vị trí GPS, vị trí bổ sung hoặc một số vị trí ước tính khác. Nguồn được chỉ định trong location_sensor.
horizontal_accuracy
(deprecated)

DoubleValue

Không dùng nữa: Hãy sử dụng latlng_accuracy.
latlng_accuracy

DoubleValue

Độ chính xác của location tính theo mét dưới dạng bán kính.
heading

Int32Value

Hướng xe đang di chuyển tính bằng độ. 0 thể hiện hướng Bắc. Phạm vi hợp lệ là [0,360).
bearing_accuracy
(deprecated)

DoubleValue

Không dùng nữa: Hãy sử dụng heading_accuracy.
heading_accuracy

DoubleValue

Độ chính xác của heading theo độ.
altitude

DoubleValue

Độ cao tính bằng mét so với WGS84.
vertical_accuracy
(deprecated)

DoubleValue

Không dùng nữa: Hãy sử dụng altitude_accuracy.
altitude_accuracy

DoubleValue

Độ chính xác là altitude mét.
speed_kmph
(deprecated)

Int32Value

Tốc độ của xe tính bằng km/giờ. Không dùng nữa: Hãy sử dụng speed.
speed

DoubleValue

Tốc độ của xe tính bằng mét/giây
speed_accuracy

DoubleValue

Độ chính xác của speed tính theo mét/giây.
update_time

Timestamp

Thời gian mà cảm biến báo cáo location theo đồng hồ của cảm biến.
server_time

Timestamp

Chỉ có đầu ra. Thời điểm máy chủ nhận được thông tin vị trí.
location_sensor

LocationSensor

Nhà cung cấp dữ liệu vị trí (ví dụ: GPS).
is_road_snapped

BoolValue

Liệu location có được gắn vào một con đường hay không.
is_gps_sensor_enabled

BoolValue

Chỉ nhập. Cho biết liệu cảm biến GPS có được bật trên thiết bị di động hay không.
time_since_update

Int32Value

Chỉ nhập. Thời gian (tính bằng giây) kể từ lần đầu tiên vị trí này được gửi đến máy chủ. Giá trị này sẽ bằng 0 cho lần cập nhật đầu tiên. Nếu không xác định được thời gian (ví dụ: khi ứng dụng khởi động lại), giá trị này sẽ đặt lại về 0.
num_stale_updates
(deprecated)

Int32Value

Chỉ nhập. Ngừng sử dụng: Các tín hiệu khác hiện được dùng để xác định xem một vị trí có lỗi thời hay không.
raw_location

LatLng

Vị trí thô của xe (chưa được xử lý bằng công cụ chụp đường).
raw_location_time

Timestamp

Dấu thời gian liên kết với vị trí thô.
raw_location_sensor

LocationSensor

Nguồn của vị trí thô. Giá trị mặc định là GPS.
raw_location_accuracy

DoubleValue

Độ chính xác của raw_location dưới dạng bán kính, tính bằng mét.
supplemental_location

LatLng

Vị trí bổ sung do ứng dụng tích hợp cung cấp.
supplemental_location_time

Timestamp

Dấu thời gian liên kết với vị trí bổ sung.
supplemental_location_sensor

LocationSensor

Nguồn của vị trí bổ sung. Giá trị mặc định là CUSTOMER_SUPPLIED_LOCATION.
supplemental_location_accuracy

DoubleValue

Độ chính xác của supplemental_location dưới dạng bán kính, tính bằng mét.
road_snapped
(deprecated)

bool

Không dùng nữa: Hãy sử dụng is_road_snapped.

VehicleMatch

Chứa xe và số liệu ước tính liên quan cho một xe khớp với các điểm của chuyến đi đang hoạt động cho xe SearchVehiclesRequest.

Trường
vehicle

Vehicle

Bắt buộc. Một chiếc xe phù hợp với yêu cầu.
vehicle_pickup_eta

Timestamp

Thời gian dự kiến đến điểm đón của xe theo đường bộ được chỉ định trong yêu cầu. Giá trị trống cho biết không tính toán được ETA cho xe. Nếu SearchVehiclesRequest.include_back_to_back là true và xe này có một chuyến đi đang hoạt động, thì vehicle_pickup_eta sẽ bao gồm thời gian cần thiết để hoàn tất chuyến đi đang hoạt động hiện tại.
vehicle_pickup_distance_meters

Int32Value

Khoảng cách từ vị trí hiện tại của Xe đến điểm đón được chỉ định trong yêu cầu, bao gồm mọi điểm đón hoặc trả khách trung gian cho các chuyến đi hiện tại. Khoảng cách này bao gồm khoảng cách lái xe (tuyến đường) được tính toán, cộng với khoảng cách theo đường thẳng giữa điểm cuối của hành trình và điểm đón được yêu cầu. (Khoảng cách giữa điểm kết thúc chỉ đường và điểm đến lấy hàng thường nhỏ.) Giá trị trống cho biết có lỗi trong quá trình tính toán khoảng cách.
vehicle_pickup_straight_line_distance_meters

Int32Value

Bắt buộc. Khoảng cách theo đường thẳng giữa xe và điểm đón được chỉ định trong yêu cầu.
vehicle_dropoff_eta

Timestamp

Thời gian dự kiến hoàn tất hành trình của xe đến điểm trả khách được chỉ định trong yêu cầu. Thời gian đến dự kiến bao gồm thời gian dừng tại bất kỳ điểm trung gian nào trước dropoff_point được chỉ định trong yêu cầu. Giá trị này sẽ chỉ được điền khi điểm trả xe được chỉ định trong yêu cầu. Giá trị trống cho biết có lỗi khi tính ETA.
vehicle_pickup_to_dropoff_distance_meters

Int32Value

Quãng đường lái xe của xe (tính bằng mét) từ điểm đón đến điểm trả khách được chỉ định trong yêu cầu. Khoảng cách chỉ tính giữa hai điểm và không bao gồm vị trí của xe hoặc bất kỳ điểm nào khác mà xe phải ghé thăm trước khi đến điểm đón hoặc điểm trả khách. Giá trị này sẽ chỉ được điền khi bạn chỉ định dropoff_point trong yêu cầu. Giá trị trống cho biết không tính được khoảng cách từ điểm đón đến điểm trả khách được chỉ định trong yêu cầu.
trip_type

TripType

Bắt buộc. Loại chuyến đi của yêu cầu được dùng để tính thời gian đến điểm đón.
vehicle_trips_waypoints[]

Waypoint

Danh sách điểm trung gian được sắp xếp dùng để tính toán ETA. Danh sách này bao gồm vị trí của xe, điểm đến lấy hàng của các chuyến đi đang hoạt động cho xe và điểm đến lấy hàng được cung cấp trong yêu cầu. Danh sách trống cho biết không tính được ETA cho xe.
vehicle_match_type

VehicleMatchType

Loại kiểu khớp xe.
requested_ordered_by

VehicleMatchOrder

Thứ tự yêu cầu để sắp xếp các kết quả trùng khớp về xe. Tương đương với ordered_by.
ordered_by

VehicleMatchOrder

Thứ tự được yêu cầu để sắp xếp các kết quả trùng khớp về xe. Tương đương với requested_ordered_by.

VehicleMatchType

Loại đối sánh xe.

Enum
UNKNOWN Loại kết quả so khớp xe không xác định
EXCLUSIVE Xe hiện không có chuyến đi nào được chỉ định và có thể tiếp tục đến điểm đón.
BACK_TO_BACK Xe hiện được chỉ định cho một chuyến đi, nhưng có thể tiếp tục đến điểm đón sau khi hoàn tất chuyến đi đang diễn ra. Tính toán khoảng cách và thời gian đến dự kiến sẽ tính đến chuyến đi hiện tại.
CARPOOL Xe có đủ chỗ cho một chuyến đi chung.
CARPOOL_BACK_TO_BACK Xe sẽ hoàn tất chuyến đi đang hoạt động trước khi đến điểm đón. Tính toán khoảng cách và thời gian đến dự kiến sẽ tính đến chuyến đi hiện tại.

VehicleState

Trạng thái của Vehicle.

Enum
UNKNOWN_VEHICLE_STATE Mặc định, dùng cho các trạng thái xe không xác định hoặc không được nhận dạng.
OFFLINE Xe không nhận chuyến đi mới. Lưu ý: xe có thể tiếp tục hoạt động ở trạng thái này trong khi hoàn tất chuyến đi được chỉ định.
ONLINE Xe đang nhận các chuyến đi mới.

VisualTrafficReportPolylineRendering

Mô tả cách ứng dụng tô màu một phần của đường đa tuyến dọc theo tuyến đường.

Trường
road_stretch[]

RoadStretch

Không bắt buộc. Các đoạn đường cần kết xuất dọc theo đường đa giác. Các đoạn đường được đảm bảo không trùng lặp và không nhất thiết phải trải dài toàn bộ tuyến đường.

Nếu không có đoạn đường để tạo kiểu, ứng dụng khách phải áp dụng kiểu mặc định cho tuyến đường.

RoadStretch

Một đoạn đường cần kết xuất.

Trường
style

Style

Bắt buộc. Kiểu sẽ áp dụng.
offset_meters

int32

Bắt buộc. Kiểu này phải được áp dụng giữa [offset_meters, offset_meters + length_meters).
length_meters

int32

Bắt buộc. Chiều dài của đường dẫn để áp dụng kiểu.

Phong cách

Kiểu giao thông, cho biết tốc độ giao thông.

Enum
STYLE_UNSPECIFIED Chưa chọn kiểu nào.
SLOWER_TRAFFIC Lưu lượng truy cập đang chậm lại.
TRAFFIC_JAM Có ách tắc giao thông.

Waypoint

Mô tả các điểm trung gian dọc theo tuyến đường cho VehicleMatch trong SearchVehiclesResponse. Khái niệm này được biểu thị dưới dạng TripWaypoint trong tất cả các điểm cuối khác.

Trường
lat_lng

LatLng

Vị trí của điểm trung gian này.
eta

Timestamp

Thời gian ước tính mà xe sẽ đến điểm trung gian này.

WaypointType

Loại điểm trung gian.

Enum
UNKNOWN_WAYPOINT_TYPE Loại điểm trung gian không xác định hoặc chưa được chỉ định.
PICKUP_WAYPOINT_TYPE Điểm trung gian để đón khách hoặc lấy hàng.
DROP_OFF_WAYPOINT_TYPE Điểm trung gian để trả khách hoặc hàng hoá.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Điểm trung gian cho các điểm đến trung gian trong một chuyến đi có nhiều điểm đến.