Package maps.fleetengine.v1

BatteryStatus

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

PowerSource

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

float

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

SpeedReadingInterval

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

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

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

string

Bắt buộc. Mã chuyến đi duy nhất. Phải tuân theo các quy định 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 hóa theo Biểu mẫu chuẩn hóa Unicode C.
• Không được chứa bất kỳ ký tự ASCII nào sau đây: '/', ':', '?', ',' hoặc '#'.

Trip

Bắt buộc. Mục 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 sẽ 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ó EXCLUSIVE chuyến đi mới hỗ trợ intermediate_destinations.

Khi vehicle_id được thiết lập 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 tham chiếu còn lại của xe, nếu không thứ tự điểm tham chiếu sẽ không được xác định.

Khi bạn chỉ định Trip.vehicle_waypoints, danh sách này phải chứa tất cả các điểm tham chiếu còn lại trong các chuyến đi của xe, không có điểm tham chiếu thừa. 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 khách 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 dùng và mọi trường TripWaypoint khác trong vehicle_waypoints sẽ bị bỏ qua.

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

string

Bắt buộc. Mã xe duy nhất. Phải tuân theo các quy định 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

Bắt buộc. Mục 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.

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.

bool

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

bool

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

BatteryInfo

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

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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.

TripView

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

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.

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.

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.

Timestamp

Cho biết dấu thời gian tối thiểu (dành riêng) 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 không được thiết lập trong phản hồi. Nếu không chỉ định mức tối thiểu, thì 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ỉ áp dụng cho những khách hàng sử dụng Giải pháp gọi xe và giao hàng theo yêu cầu.

Timestamp

Cho biết dấu thời gian tối thiểu (dành riêng) cho dữ liệu Trip.remaining_waypoints.traffic_to_waypoint và Trip.remaining_waypoints.path_to_waypoint được truy xuất. 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 bạn không chỉ định remaining_waypoints_route_version, thì hệ thống sẽ luôn truy xuất lưu lượng truy cập và đường dẫn.

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

Timestamp

Cho biết dấu thời gian tối thiểu (dành riêng) 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 không chỉ định giá trị tối thiểu, current_route_segment sẽ luôn được truy xuất.

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 tham chiếu không thay đổi kể từ dấu thời gian này, thì dữ liệu vehicle.waypoints sẽ không được thiết lập 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.

string

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

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"

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

int32

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

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 sẽ không được 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 đó tới ListVehicles.

Int32Value

Cho biết sức chứa tối thiểu bắt buộc của xe. Tất 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.

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.

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à cũ. Nếu có, phải là một khoảng thời gian dương hợp lệ.

Category

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

string

Phương thức gọi có thể tạo thành 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 tạo một danh sách gồm các danh sách. Khi được kết hợp, 2 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 thêm tối đa 50 thuộc tính bắt buộc. Giá trị này khớp với số lượng thuộc tính tối đa được phép trên một chiếc xe. Mỗi chuỗi lặp lại phải có định dạng "khoá:giá trị".

string

Hạn chế phản hồi cho những phương tiện 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à toán tử tách/OR bao gồm trong mỗi VehicleAttributeList và phép toán 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".

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 tạo một danh sách gồm nhiều danh sách, cho phép các biểu thức như danh sách này:

(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 cho các phương tiện khớp với tất cả thuộc tính trong VehicleAttributeList. Trong mỗi danh sách, một chiếc 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".

VehicleState

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

bool

Chỉ trả xe có(các) chuyến đi hiện tại.

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 giá trị không trống ở đây, thì các trường sau đây 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 cụm từ tìm kiếm duy nhất được hỗ trợ là về thuộc tính 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ả thuộc tính đều được lưu trữ dưới dạng chuỗi, do đó, phép so sánh duy nhất được hỗ trợ so 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

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.

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.

string

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

int64

Bắt buộc. Tổng số xe đáp ứng các tiêu chí của yêu cầu trên tất cả các trang.

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

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.

BillingPlatformIdentifier

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

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.

SolutionType

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

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 truy cập vào 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.

string

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

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.

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.

string

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

SdkType

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

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.

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

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

string

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

int32

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

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.

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

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

bool

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

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

string

Hãy thiết lập thành một giá trị được trả về trước đó trong SearchTripsResponse để tiếp tục từ các kết quả trước đó.

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

Trip

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

string

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

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

TerminalLocation

Bắt buộc. Điểm đón để tìm kiếm ở gần.

TerminalLocation

Vị trí trả xe dự kiến của khách hàng. Đây là trường bắt buộc nếu trip_types chứa TripType.SHARED.

int32

Bắt buộc. Xác định bán kính tìm kiếm xe xung quanh điểm đón. Chúng tôi chỉ trả lại những phương tiện trong phạm vi 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).

int32

Bắt buộc. Cho biết 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).

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.

TripType

Bắt buộc. Biểu thị loại chuyến đi được đề xuất. Phải bao gồm đú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 đó.

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à cũ. Nếu bạn không đặt trường này, thì máy chủ sẽ sử dụng năm phút làm giá trị mặc định.

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.

VehicleAttribute

Phương thức gọi có thể tạo thành 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 tạo một danh sách gồm các 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 thêm tối đa 50 thuộc tính bắt buộc. Giá trị này khớp với số lượng thuộc tính tối đa được phép trên một chiếc xe.

VehicleAttributeList

Giới hạn tìm kiếm chỉ cho 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.

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 tạo một danh sách gồm nhiều danh sách, cho phép các biểu thức như danh sách này:

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

Giới hạn tìm kiếm chỉ cho những 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à phép toán kết hợp/VÀ trong mỗi VehicleAttributeList và phép tách/HOẶC bao gồm trên tập hợp VehicleAttributeList.

VehicleMatchOrder

Bắt buộc. Chỉ định tiêu chí thứ tự mong muốn cho các kết quả.

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 bạn không chỉ định current_trips_present 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 và 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.

string

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

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.

string

Không bắt buộc. Cụm từ tìm kiếm để á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 cụm từ tìm kiếm duy nhất được hỗ trợ là về thuộc tính 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 giá trị boolean, các giá trị phải được trích dẫn rõ ràng để được xử lý dưới dạng chuỗi (ví dụ: attributes.<key> = "10" hoặc attributes.<key> = "true").

VehicleMatch

Danh sách xe đáp ứng tiêu chí SearchVehiclesRequest, được sắp xếp theo trường SearchVehiclesRequest.order_by.

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ẽ dường như không được điền.

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ẽ dường như không được điền.

Speed

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

LatLng

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

Timestamp

Cho biết thời điểm dừng.

Timestamp

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

LatLng

Bắt buộc. Biểu thị vị trí của một điểm tham chiếu chuyến đi.

TerminalPointId

Không dùng nữa: Thay vào đó, hãy chỉ định trường point.

string

Không dùng nữa: Thay vào đó, hãy chỉ định trường point.

string

Không dùng nữa.

WaypointType

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

string

Không dùng nữa.

string

Không dùng nữa.

string

Không dùng nữa.

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.

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.

TripStatus

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

TripType

Loại chuyến đi.

TerminalLocation

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

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.

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.

Timestamp

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.

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

Timestamp

Cho biết lần cuối cùng intermediate_destinations được sửa đổi. Để đảm bảo intermediate_destinations 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 intermediate_destination_index.

int32

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

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.

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.

TerminalLocation

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

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

Timestamp

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.

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.

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 UpdateTrip và CreateTrip, KHÔNG phải trên các lệnh gọi GetTrip.

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ạicòn lại_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.

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

Timestamp

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.

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

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.

TripWaypoint

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

Int32Value

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

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

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

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

Timestamp

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

int32

Bất biến. 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.

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.

bool

Chỉ có đầu ra. Cho biết liệu last_location của xe có thể bám theo đoạn đường current_route_segment 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 sẽ bị bỏ qua.

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

TerminalLocation

Vị trí của điểm tham chiếu này.

string

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

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.

LatLng

Đường đi từ điểm tham chiếu trước đó đến điểm tham chiếu 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 sẵn khi có yêu cầu.

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

ConsumableTrafficPolyline

Tình trạng giao thông dọc theo đường dẫn đến điểm tham chiếu 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.

Int32Value

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

Timestamp

Thời gian đến dự kiến tại điểm tham chiếu này. Không xác định cho điểm tham chiếu đầu tiên trong danh sách.

Duration

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

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

Bắt buộc. Chuyến đi được 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. Đừng cập nhật các địa điểm này bằng cách sử dụ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 tham chiếu còn lại, nếu không thứ tự sẽ không được 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. Điểm tham chiếu của 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 dùng và mọi trường TripWaypoint khác trong vehicle_waypoints sẽ bị bỏ qua.

Để tránh tình huố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 phù hợp với phiên bản của Fleet Engine. Nếu không, yêu cầu sẽ không thành công.

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.

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

VehicleAttribute

Bắt buộc. Các thuộc tính của xe cần cập nhật. Những thuộc tính không được đề cập sẽ không được thay đổi hay xoá bỏ.

VehicleAttribute

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

RequestHeader

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.

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

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 phải chứa tất cả điểm tham chiếu hiện có trên xe và không có điểm tham chiếu nào khác.

FieldMask

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

string

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

VehicleState

Trạng thái của xe.

TripType

Các loại chuyến đi được xe này hỗ trợ.

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.

VehicleLocation

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

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.

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.

VehicleType

Bắt buộc. Loại xe này. Có thể dùng để lọc phương tiện trong SearchVehicles kết quả. Ngoài ra còn ảnh hưởng đến việc tính toán tuyến đường và giờ đến dự kiến.

LicensePlate

Thông tin về biển số xe của xe.

TerminalLocation

Không dùng nữa: Thay vào đó, hãy sử dụng Vehicle.waypoints.

string

Hình nhiều đường chỉ định tuyến đường mà ứng dụng trình điều khiển định đi đến điểm tham chiếu tiếp theo. Danh sách này cũng được trả về trong Trip.current_route_segment cho tất 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 sử dụng. Chưa hỗ trợ giải mã.

TrafficPolylineData

Chỉ nhập. Fleet Engine 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.

Timestamp

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

TripWaypoint

Điểm trung gian nơi current_route_segment kết thúc. Người lái xe có thể cung cấp giá trị này trong các lệnh gọi UpdateVehicle dưới dạng điểm tham chiếu đầy đủ, điểm tham chiếu LatLng hoặc 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.

Int32Value

Quãng đường lái xe còn lại của current_route_segment. Giá trị này cũng được trả về bằng Trip.remaining_distance_meters cho tất cả chuyến đi đang hoạt động được chỉ định cho xe. Bạn không chỉ định giá trị này nếu trường current_route_segment trống.

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 một chiếc xe, remaining_time_seconds sẽ được ưu tiên hơn eta_to_first_waypoint trong cùng một yêu cầu.

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.

TripWaypoint

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

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.

bool

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

NavigationStatus

Trạng thái đi theo chỉ dẫn của xe.

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.

Category

Danh mục loại xe

string

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

string

Giá trị của thuộc tính.

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 mà sau này 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ì hai thuộc tính này phải giống hệt nhau, nếu không sẽ xảy ra lỗi. Cả hai trường đều được điền sẵn câu trả lời.

bool

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

double

Nhập giá trị thuộc tính hai lần.

VehicleAttribute

Danh sách các thuộc tính trong tập hợp này.

LatLng

Vị trí của xe. Khi được gửi đến Fleet Engine, 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.

DoubleValue

Không dùng nữa: Chuyển sang dùng latlng_accuracy.

DoubleValue

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

Int32Value

Hướng xe đang di chuyển theo độ. 0 thể hiện hướng Bắc. Phạm vi hợp lệ là [0,360).

DoubleValue

Không dùng nữa: Chuyển sang dùng heading_accuracy.

DoubleValue

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

DoubleValue

Cao độ tính bằng mét so với WGS84.

DoubleValue

Không dùng nữa: Thay vào đó, hãy sử dụng altitude_accuracy.

DoubleValue

Độ chính xác là altitude tính bằng mét.

Int32Value

Tốc độ của xe tính bằng km/giờ. Không dùng nữa: Chuyển sang dùng speed.

DoubleValue

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

DoubleValue

Độ chính xác là speed tính bằng mét/giây.

Timestamp

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

Timestamp

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

LocationSensor

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

BoolValue

Liệu location có bị bám theo đường hay không.

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.

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), thì giá trị này sẽ được đặt lại về 0.

Int32Value

Chỉ nhập. Không dùng nữa: 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.

LatLng

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

Timestamp

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

LocationSensor

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

DoubleValue

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

LatLng

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

Timestamp

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

LocationSensor

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

DoubleValue

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

bool

Không dùng nữa: Thay vào đó, hãy sử dụng is_road_snapped.

Vehicle

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

Timestamp

Thời gian đến dự kiến của xe đến điểm đón đượ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.

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 khi tính khoảng cách.

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.

Timestamp

Giờ đến dự kiến của toàn bộ xe đến điểm trả khách được chỉ định trong yêu cầu. Giờ đến dự kiến bao gồm việc dừng tại bất kỳ điểm tham chiếu nào trước dropoff_point được chỉ định trong yêu cầu. Giá trị sẽ chỉ được điền sẵn khi điểm trả khách được chỉ định trong yêu cầu. Giá trị trống cho biết có lỗi khi tính ETA.

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 này chỉ nằm 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à khách hàng phải ghé thăm trước khi xe ghé thăm điểm đón hoặc điểm trả xe. Giá trị sẽ chỉ được điền khi dropoff_point được chỉ định 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.

TripType

Bắt buộc. Loại chuyến đi trong yêu cầu được dùng để tính giờ đến dự kiến cho đến điểm đón.

Waypoint

Danh sách các điểm tham chiếu theo thứ tự dùng để tính toán thời gian đến dự kiến. Danh sách này bao gồm vị trí của xe, điểm đến lấy hàng của những chuyến đi đang hoạt động của 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 toán được ETA cho xe.

VehicleMatchType

Loại kiểu khớp xe.

VehicleMatchOrder

Thứ tự yêu cầu sắp xếp xe trùng khớp.

VehicleMatchOrder

Thứ tự thực tế được sử dụng cho xe này. Thông thường, phương thức này sẽ khớp với trường "order_by" trong yêu cầu. Tuy nhiên, trong một số trường hợp (chẳng hạn như lỗi máy chủ nội bộ), hệ thống có thể sử dụng một phương thức khác (chẳng hạn như PICKUP_POINT_STRAIGHT_DISTANCE).

RoadStretch

Không bắt buộc. Đoạn đường sẽ được hiển thị dọc theo hình nhiều đường. 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.

Trong trường hợp không có đường kéo dài để tạo kiểu, ứng dụng khách nên áp dụng giá trị mặc định cho tuyến đường.

Style

Bắt buộc. Kiểu nên áp dụng.

int32

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

int32

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

LatLng

Vị trí của điểm tham chiếu này.

Timestamp

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