Package maps.fleetengine.v1

BatteryStatus

Trạng thái của pin, cho dù đã sạc đầy hay đang sạc, v.v.

PowerSource

Trạng thái của nguồn điện từ pin.

float

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

SpeedReadingInterval

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

string

Đường đi mà người lái xe đang đi từ điểm tham chiếu trước đến điểm tham chiếu hiện tại. Đường dẫn này có các địa điểm nổi bật để ứng dụng có thể hiển thị các điểm đánh dấu giao thông dọc theo đường dẫn (xem speed_reading_interval). Chúng tôi chưa hỗ trợ việc giải mã.

RequestHeader

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

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.

string

Bắt buộc. Mã chuyến đi duy nhất. Tuân thủ 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 Unicode Normalization Form C.
• Không được chứa bất kỳ ký tự ASCII nào sau đây: "/", ":", "?", "," hoặc "#".

Trip

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

Khi tạo một 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 sẽ được 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 khác của Chuyến đi đều bị bỏ qua. Ví dụ: tất cả các chuyến đi đều bắt đầu bằng trip_status là NEW ngay cả khi bạn truyền trip_status là CANCELED trong yêu cầu tạo.

Chỉ những 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 tham chiếu còn lại cho xe, nếu không, thứ tự điểm tham chiếu 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 tham chiếu còn lại trong chuyến đi của xe, không có điểm tham chiếu nào khác. Bạn phải sắp xếp các điểm tham chiếu này sao cho đối với một chuyến đi nhất định, điểm đón phải đứng trước các điểm đến trung gian và tất cả các điểm đến trung gian phải đứng trước điểm trả khách. Các đ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à tất cả các trường TripWaypoint khác trong vehicle_waypoints đều bị bỏ qua.

RequestHeader

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

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.

string

Bắt buộc. Mã nhận dạng riêng biệt của xe. Tuân thủ 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 Unicode Normalization Form C.
• Không được chứa bất kỳ ký tự ASCII nào sau đây: "/", ":", "?", "," hoặc "#".

Vehicle

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

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Khi tạo một Xe, các trường sau 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 đều không bắt buộc và được dùng nếu bạn cung cấp.

RequestHeader

Không bắt buộc. Tiêu đề yêu cầu Fleet Engine tiêu chuẩn.

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.

RequestHeader

Không bắt buộc. Tiêu đề yêu cầu Fleet Engine tiêu chuẩn.

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.

LocationPowerSaveMode

Cách các tính năng vị trí được thiết lập để hoạt động trên thiết bị khi trình tiết kiệm pin đang bật.

bool

Thiết bị hiện có ở chế độ tiết kiệm pin hay không.

bool

Thiết bị có đang ở trạng thái tương tác hay không.

BatteryInfo

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

RequestHeader

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

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à cách diễn giải các trường đó.

Timestamp

Cho biết dấu thời gian tối thiểu (loại trừ) mà dữ liệu Trip.route hoặc Trip.current_route_segment được truy xuất. 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 giá trị tối thiểu, dữ liệu tuyến đường sẽ luôn được truy xuất.

Timestamp

Không dùng nữa: Trip.remaining_waypoints luôn được truy xuất. Sử dụng remaining_waypoints_route_version để kiểm soát thời điểm truy xuất dữ liệu Trip.remaining_waypoints.traffic_to_waypoint và Trip.remaining_waypoints.path_to_waypoint.

PolylineFormatType

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

Timestamp

Cho biết dấu thời gian tối thiểu (loại trừ) 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 thông tin về 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.

Timestamp

Cho biết dấu thời gian tối thiểu (loại trừ) mà 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, 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, lưu lượng truy cập và đường dẫn sẽ luôn được truy xuất.

RequestHeader

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

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.

Timestamp

Cho biết dấu thời gian tối thiểu (loại trừ) 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 thiết lập trong phản hồi. Nếu bạn không chỉ định giá trị tối thiểu, thì current_route_segment sẽ luôn được truy xuất.

Timestamp

Cho biết dấu thời gian tối thiểu (loại trừ) mà dữ liệu Vehicle.waypoints được truy xuất. 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 đặt trong phản hồi. Nếu bạn không chỉ định trường này, thì 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ố xe hoặc "-1" để biểu thị biển số xe không có giá trị bằng số.

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

RequestHeader

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

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.

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 một 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ị 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 của lệnh gọi trước đó đến ListVehicles.

Int32Value

Chỉ định sức chứa tối thiểu bắt buộc của xe. Tất cả các xe đượ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

Giới hạn phản hồi cho những xe hỗ trợ ít nhất một trong các loại chuyến đi được chỉ định.

Duration

Giới hạn phản hồi cho những xe đã gửi thông tin cập nhật vị trí đến Fleet Engine trong khoảng thời gian được chỉ định. Những xe đang đứng yên nhưng vẫn truyền vị trí sẽ không được coi là dữ liệu cũ. Nếu có, phải là một khoảng thời gian dương hợp lệ.

Category

Bắt buộc. Giới hạn phản hồi cho 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.

string

Người gọi có thể tạo các thao tác 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 một danh sách các danh sách. Khi kết hợp, hai trường này cho phép tạo biểu thức sau:

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

Giới hạn 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à một phép kết hợp/phép toán AND. Bạn chỉ được chỉ định tối đa 50 required_attributes. Số lượng này tương ứng 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

Giới hạn phản hồi 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 chiếc xe phải khớp với ít nhất một trong các thuộc tính. Trường này là một phép tách biệt bao hàm/phép OR trong mỗi VehicleAttributeList và một phép kết hợp/phép AND trên tập hợp VehicleAttributeList. Mỗi chuỗi lặp lại phải có định dạng "key1:value1|key2:value2|key3:value3".

string

required_one_of_attribute_sets cung cấp thêm chức năng.

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 một danh sách các 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
  ...)
)

Giới hạn phản hồi đối với những xe 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 phép kết hợp/phép AND trong mỗi VehicleAttributeList và phép phân ly bao hàm/phép OR trên tập hợp VehicleAttributeList. Mỗi chuỗi lặp lại phải có định dạng "key1:value1|key2:value2|key3:value3".

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ả về(các) xe đang có chuyến đi.

string

Không bắt buộc. Một truy vấn bộ lọc để áp dụng khi liệt kê 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 ở đâ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 điều kiện ràng buộc khác, chẳng hạn như vehicle_state hoặc on_trip_only.

Xin lưu ý rằng chỉ những truy vấn về thuộc tính của xe mới được hỗ trợ (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, các phép so sánh duy nhất được hỗ trợ đối với các thuộc tính là phép so sánh chuỗi. Để so sánh với các giá trị số hoặc boolean, bạn phải đặt các giá trị trong dấu ngoặc kép một cách 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. Một bộ lọc giới hạn số lượng xe được trả về ở những xe có vị trí đã biết gần đây nhất nằm trong khu vực hình chữ nhật do khung hiển thị xác định.

Vehicle

Các phương tiện đáp ứng tiêu chí trong yêu cầu. Số lượng xe tối đa được trả về do trường page_size trong yêu cầu xác định.

string

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

int64

Bắt buộc. Tổng số xe đáp ứng tiêu chí 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 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 mà yêu cầu được đưa ra.

string

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

SolutionType

Loại giải pháp sản phẩm của GMP (ví dụ: ON_DEMAND_RIDESHARING_AND_DELIVERIES) được 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 xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu không có ngôn ngữ nào được chỉ định, thì phản hồi có thể bằng bất kỳ ngôn ngữ nào, ư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 nơi yêu cầu bắt nguồn. 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 của hệ điều hành mà SDK gọi đang chạy. Ví dụ về giá trị của 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ị của 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 các SDK Android. Ví dụ về giá trị trường: 23.

string

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

RequestHeader

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

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.

string

Phương tiện liên kết với các chuyến đi trong yêu cầu. Nếu bạn 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 được đặt thành true, 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 giá trị này, máy chủ sẽ quyết định số lượng kết quả cần trả về.

string

Đặt giá trị này 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ề những 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 chiếc xe được yêu cầu.

string

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

RequestHeader

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

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.

TerminalLocation

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

TerminalLocation

Vị trí mà khách hàng dự định đến lấy hàng. Bạn bắt buộc phải điền trường này 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 lấy xe. 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).

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

int32

Bắt buộc. Chỉ định số lượng hành khách được xem xét cho một chuyến đi. Giá trị phải lớn hơn hoặc bằng 1. Giá trị dung lượng không bao gồm người lái xe.

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ỉ tìm kiếm những xe có thể hỗ trợ loại chuyến đi đó.

Duration

Giới hạn phạm vi tìm kiếm chỉ trong những xe đã gửi thông tin cập nhật vị trí đến Fleet Engine trong khoảng thời gian được chỉ định. Những xe đang đứng yên nhưng vẫn truyền vị trí sẽ không được coi là dữ liệu cũ. Nếu bạn không đặt trường này, thì máy chủ sẽ sử dụng giá trị mặc định là 5 phút.

VehicleType

Bắt buộc. Giới hạn phạm vi tìm kiếm đối với những xe có một trong các loại được chỉ định. Bạn phải chỉ định ít nhất một loại xe. Bạn không được phép sử dụng VehicleTypes có danh mục là UNKNOWN.

VehicleAttribute

Người gọi có thể tạo các thao tác 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 một danh sách các danh sách. Khi kết hợp, hai trường này cho phép tạo biểu thức sau:

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

Giới hạn phạm vi tìm kiếm chỉ ở những chiếc xe có các thuộc tính được chỉ định. Trường này là một phép kết hợp/phép toán AND. Bạn chỉ được chỉ định tối đa 50 required_attributes. Số lượng này tương ứng 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 phạm vi tìm kiếm chỉ ở 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 chiếc xe phải khớp với ít nhất một trong các thuộc tính. Trường này là một phép tách biệt bao hàm/phép OR trong mỗi VehicleAttributeList và một phép kết hợp/phép AND trên tập hợp VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets cung cấp thêm chức năng.

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 một danh sách các 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
  ...)
)

Giới hạn phạm vi tìm kiếm chỉ ở những chiếc xe có tất cả các thuộc tính trong một 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 phép kết hợp/phép AND trong mỗi VehicleAttributeList và phép phân ly bao hàm/phép OR trên tập hợp VehicleAttributeList.

VehicleMatchOrder

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

bool

Điều 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 bạn không chỉ định current_trips_present. Khi current_trips_present không được chỉ định và trường này là false, những xe 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 những xe có một chuyến đi đang hoạt động với trạng thái là ENROUTE_TO_DROPOFF. Khi bạn 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

Điều này cho biết liệu những chiếc xe đang có chuyến đi còn hiệu lực 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 giá trị khác CURRENT_TRIPS_PRESENT_UNSPECIFIED nếu trip_type bao gồm SHARED.

string

Không bắt buộc. Một cụm từ tìm kiếm 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 ở đâ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 điều kiện ràng buộc khác, chẳng hạn như minimum_capacity hoặc vehicle_types.

Xin lưu ý rằng chỉ những truy vấn về thuộc tính của xe mới được hỗ trợ (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, các phép so sánh duy nhất được hỗ trợ đối với các thuộc tính là phép so sánh chuỗi. Để so sánh với các giá trị số hoặc boolean, bạn phải đặt các giá trị trong dấu ngoặc kép một cách rõ ràng để được coi là chuỗi (ví dụ: attributes.<key> = "10" hoặc attributes.<key> = "true").

VehicleMatch

Danh sách các phương tiện khớp với 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 này sẽ xuất hiện dưới dạng chưa được điền sẵ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 này sẽ xuất hiện dưới dạng chưa được điền sẵn.

Speed

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

LatLng

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

Timestamp

Cho biết thời điểm xảy ra điểm dừng.

Timestamp

Chỉ có đầu vào. Không dùng nữa. Sử dụng trường dấu thời gian.

LatLng

Biểu thị LatLng chính xác của điểm tham chiếu. Bạn phải chỉ định point hoặc place làm dữ liệu đầu vào. Nếu bạn chỉ định cả hai, thì point sẽ được dùng để định tuyến và place sẽ được dùng cho siêu dữ liệu. Nếu chỉ có place được chỉ định làm đầu vào, thì point sẽ được tính từ place và được đưa vào đầu ra.

string

Tên tài nguyên của địa điểm đại diện cho vị trí này. Định dạng là places/{place_id}. Bạn phải chỉ định point hoặc place làm dữ liệu đầu vào. Nếu bạn chỉ định cả hai, thì point sẽ được dùng để định tuyến và place sẽ được dùng cho siêu dữ liệu. place chỉ được đưa vào đầu ra nếu được đưa vào đầu vào, tức là không có hoạt động tra cứu place nào từ LatLng được thực hiện.

Đây là tính năng thử nghiệm.

PointSource

Chỉ có đầu ra. Nguồn của trường point.

TerminalPointId

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

string

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

string

Không dùng nữa.

WaypointType

Không dùng nữa: 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 nhiều đoạn hiển thị tốc độ giao thông cho tất cả các khu vực dọc theo một đoạn đường mà khách hàng lái xe.

string

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

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ẽ đến lấy hàng.

StopLocation

Chỉ có đầu vào. Vị trí thực tế khi 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ế khi đến lấy.

StopLocation

Chỉ có đầu vào. Thời gian và vị trí thực tế mà người lái xe đến điểm đón. Trường này dành cho nhà cung cấp để đưa ra ý kiến phản hồi về thông tin thực tế khi đến điểm đón.

Timestamp

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

TerminalLocation

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

Timestamp

Cho biết thời điểm gần đây nhất intermediate_destinations được sửa đổ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ị đó trong UpdateTripRequest khi cập nhật intermediate_destination_index để đảm bảo intermediate_destinations không thay đổi.

int32

Khi TripStatus là ENROUTE_TO_INTERMEDIATE_DESTINATION, một số trong khoảng [0..N-1] cho biết đích đế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ỉ có đầu vào. Thời gian và vị trí thực tế mà người lái xe đến một điểm dừng châ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 các điểm đến trung gian.

StopLocation

Chỉ có đầu vào. Thời gian và địa điểm 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ế khi đón khách tại các điểm đến trung gian.

TerminalLocation

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

StopLocation

Chỉ có đầu vào. Thời gian và vị trí thực tế khi khách hàng được trả. 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ề việc trả khách.

Timestamp

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

TripWaypoint

Chỉ có đầu ra. Đường dẫn đầy đủ từ vị trí hiện tại đến điểm trả hàng, bao gồm cả điểm trả hàng. Đường đi này có thể bao gồm các điểm tham chiếu của những 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. Nó chứa tất cả các điểm tham chiếu còn lại cho xe được chỉ định, cũng như các điểm tham chiếu đó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, chứ KHÔNG phải trong 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 mục nhập đầu tiên trong remaining_waypoints. Xin lưu ý rằng điểm tham chiếu đầu tiên có thể thuộc về một chuyến đi khác.

string

Chỉ có đầu ra. Đường dẫn được mã hoá đến điểm tham chiếu tiếp theo.

Lưu ý: Trường này chỉ dành cho Driver SDK và Consumer SDK. Chưa hỗ trợ tính năng giải mã.

Timestamp

Chỉ có đầu ra. Cho biết lần gần đây nhất tuyến đường được sửa đổi.

Lưu ý: Trường này chỉ dành cho Driver SDK và Consumer SDK.

ConsumableTrafficPolyline

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

Lưu ý: Trường này chỉ dành cho Driver SDK và Consumer SDK.

Timestamp

Chỉ có đầu ra. Cho biết thời điểm gần đây nhất current_route_segment_traffic được sửa đổi.

Lưu ý: Trường này chỉ dành cho Driver SDK và Consumer SDK.

TripWaypoint

Chỉ có đầu ra. Điểm đánh dấu nơi current_route_segment kết thúc.

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 chiếc xe, hoặc chuyến đi đã hoàn tất hoặc bị huỷ.

Timestamp

Chỉ có đầu ra. Thời gian đến dự kiến cho điểm tham chiếu 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ỷ).

Duration

Chỉ có đầu ra. Khoảng thời gian từ khi dữ liệu Chuyến đi được trả về cho đế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ỷ).

Timestamp

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

Timestamp

Chỉ có đầu ra. Cho biết lần gần đây 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 nên lưu giá trị này vào bộ nhớ đệm và truyền giá trị đó trong GetTripRequest để đảm bảo chỉ trả về các đường dẫn và lưu lượng truy cập cho remaining_waypoints nếu được cập nhật.

int32

Không thể thay đổi. Cho biết số lượng hành khách trong chuyến đi này và không bao gồm người lái xe. Xe phải có chỗ trống để trả lại 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ể được gắn vào current_route_segment hay không. Sai nếu last_location hoặc current_route_segment không tồn tại. Dịch vụ này được Fleet Engine tính toán. Mọi nội dung cập nhật từ các ứng dụng đều sẽ bị bỏ qua.

TripView

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

TripAttribute

Danh sách các thuộc tính tuỳ chỉnh của Chuyến đi. Mỗi thuộc tính phải có một khoá riêng biệt.

string

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

string

Giá trị thuộc tính có dạng chuỗi văn bản.

bool

Giá trị thuộc tính có kiểu Boolean.

double

Giá trị thuộc tính có kiểu gấp đôi.

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 tham chiếu này.

WaypointType

Vai trò của điểm tham chiếu này trong chuyến đi, chẳng hạn như đón hoặc trả khách.

LatLng

Đường đi từ điểm tham chiếu trước đến điểm tham chiếu hiện tại. Nếu đây là điểm tham chiếu đầu tiên, thì đường dẫn sẽ là từ vị trí hiện tại của xe đến điểm tham chiếu. Trường này chỉ được điền khi có yêu cầu.

string

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

Lưu ý: Trường này chỉ dành cho Driver SDK và Consumer SDK. Chưa hỗ trợ tính năng giải mã.

ConsumableTrafficPolyline

Tình trạng giao thông dọc theo đường đến điểm dừng chân này. Xin lưu ý rằng thông tin về lưu lượng truy cập chỉ dành cho khách hàng sử dụng Giải pháp về Chuyến đi và Giao hàng của Google Maps Platform.

Int32Value

Khoảng cách đường đi từ điểm tham chiếu trước đến điểm tham chiếu hiện tại. Nếu đây là điểm tham chiếu đầu tiên, thì khoảng cách trên đường đi là từ vị trí hiện tại của xe đến điểm tham chiếu.

Timestamp

Thời gian đến dự kiến tại điểm tham chiếu này.

Duration

Thời gian di chuyển từ điểm tham chiếu trước đến điểm tham chiếu này. Nếu đây là điểm tham chiếu đầu tiên, thì thời gian di chuyển là từ vị trí hiện tại của xe đến điểm tham chiếu.

RequestHeader

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

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 liên quan đến thông tin cập nhật.

Fleet Engine duy trì các trường sau. Không cập nhật các đối tượng này 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 tham chiếu còn lại, nếu không, thứ tự 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 tham chiếu còn lại trong chuyến đi của xe, không có điểm tham chiếu nào khác. Bạn phải sắp xếp các điểm tham chiếu này sao cho đối với một chuyến đi nhất định, điểm đón phải đứng trước các điểm đến trung gian và tất cả các điểm đến trung gian phải đứng trước điểm trả khách. Các đ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à tất cả các trường TripWaypoint khác trong vehicle_waypoints đều bị bỏ qua.

Để tránh tình trạng xung đột dữ liệu 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 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ạ cho trường cho biết những trường nào 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 đề yêu cầu Fleet Engine tiêu chuẩn.

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.

VehicleAttribute

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

VehicleAttribute

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

RequestHeader

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

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. Các giá trị thực thể Vehicle cần áp dụng. Khi cập nhật một Vehicle, bạn có thể không cập nhật được các trường sau vì chúng 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ả cá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ả cá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 mặt nạ cho trường cho biết những trường nào của Vehicle cần cập nhật. 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 chiếc 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 mà xe này hỗ trợ.

string

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

VehicleLocation

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

VehicleLocation

Chỉ có đầu vào. Những vị trí mà xe này đã từng đến nhưng chưa được báo cáo cho Fleet Engine. Dịch vụ này được dùng trong UpdateVehicleRequest để ghi lại những vị trí mà trước đây không gửi được đến máy chủ. Điều này thường xảy ra khi xe không có kết nối Internet.

int32

Tổng số hành khách mà phương tiện này có thể chở. Giá trị này không bao gồm người lái xe. Giá trị này phải lớn hơn hoặc bằng 1.

VehicleAttribute

Danh sách thuộc tính của xe. Một chiếc 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 xe trong kết quả SearchVehicles. Đồng thời ảnh hưởng đến thời gian đến dự kiến và cách tính toán tuyến đường.

LicensePlate

Thông tin biển số xe.

TerminalLocation

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

string

Đường nhiều đoạn chỉ định tuyến đường mà ứng dụng dành cho tài xế dự đị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ả các chuyến đi đang hoạt động được chỉ định cho xe.

Lưu ý: Trường này chỉ dành cho Driver SDK. Chưa hỗ trợ tính năng giải mã.

TrafficPolylineData

Chỉ có đầu vào. 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 Driver SDK.

Timestamp

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

TripWaypoint

Điểm đánh dấu nơi current_route_segment kết thúc. Thông tin này có thể do người lái xe cung cấp trong các cuộc gọi UpdateVehicle dưới dạng một điểm tham chiếu đầy đủ của chuyến đi, một điểm tham chiếu LatLng hoặc là LatLng cuối cùng của current_route_segment. Sau đó, Fleet Engine sẽ cố gắng hết sức để suy đoán thành một điểm tham chiếu thực tế nếu điểm đó chưa được chỉ định đầy đủ. Trường này sẽ 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 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ị không được chỉ định nếu trường current_route_segment trống.

Timestamp

Thời gian dự kiến đến mục đầu tiên trong trường waypoints. Giá trị không được chỉ định nếu trường waypoints trống 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.

Int32Value

Chỉ có đầu vào. Thời gian lái xe còn lại cho current_route_segment. Giá trị không được chỉ định nếu trường waypoints trống 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 tham chiếu 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. Các ứng dụng nên lưu giá trị này vào bộ nhớ đệm và truyền giá trị đó vào GetVehicleRequest để đảm bảo trường waypoints chỉ được trả về nếu trường đó được cập nhật.

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 đang được chỉ định cho một chuyến đi. Giá trị mặc định là false.

NavigationStatus

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

DeviceSettings

Chỉ có đầu vào. Thông tin về các chế độ cài đặt trên 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ó dạng chuỗi văn bản.

Lưu ý: Trường này giống hệt với trường value và cuối cùng sẽ không được dùng nữa. Đối với 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 nên sử dụng string_value. Nếu bạn đặt cả string_value và value, thì chúng phải giống nhau, nếu không thì sẽ xảy ra lỗi. Cả hai trường đều được điền sẵn trong các phản hồi.

bool

Giá trị thuộc tính có kiểu Boolean.

double

Giá trị thuộc tính có kiểu gấp đôi.

VehicleAttribute

Danh sách các thuộc tính trong bộ sưu tậ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 vị trí 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 đoán khác. Nguồn được chỉ định trong location_sensor.

DoubleValue

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

DoubleValue

Độ chính xác của location tính bằng mét theo bán kính.

Int32Value

Hướng di chuyển của xe tính bằng độ. 0 biểu thị hướng Bắc. Phạm vi hợp lệ là [0,360).

DoubleValue

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

DoubleValue

Độ chính xác của heading tính bằng độ.

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 mét.

Int32Value

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

DoubleValue

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

DoubleValue

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

Timestamp

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

Timestamp

Chỉ có đầu ra. Thời gian 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

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

BoolValue

Chỉ có đầu vào. 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ỉ có đầu vào. Thời gian (tính bằng giây) kể từ khi vị trí này được gửi đến máy chủ lần đầu tiên. 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 thành 0.

Int32Value

Chỉ có đầu vào. Không dùng nữa: Giờ đây, các tín hiệu khác được dùng để xác định xem một vị trí có còn mới hay không.

LatLng

Vị trí thô của xe (chưa được xử lý bằng tính năng gắn vị trí vào đườ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í do Trình cung cấp vị trí kết hợp của Android cung cấp.

Timestamp

Dấu thời gian cập nhật của flp_location

DoubleValue

Độ chính xác của flp_location tính bằng mét theo bán kính.

Int32Value

Hướng di chuyển của xe theo độ, do Trình cung cấp vị trí kết hợp xác định. 0 biểu thị hướng Bắc. Phạm vi hợp lệ là [0,360).

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 dự kiến lái xe đến điểm đón được chỉ định trong yêu cầu. Giá trị trống cho biết không tính được thời gian dự kiến đến cho xe. Nếu SearchVehiclesRequest.include_back_to_back là true và xe này đang có một chuyến đi, thì vehicle_pickup_eta sẽ bao gồm thời gian cần thiết để hoàn tất chuyến đi 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 có. Khoảng cách này bao gồm khoảng cách lái xe (tuyến đường) đã tính, cộng với khoảng cách đường thẳng giữa điểm cuối của chỉ đường và điểm đón được yêu cầu. (Khoảng cách giữa điểm kết thúc chỉ dẫn và điểm đón theo yêu cầu thường không xa.) 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

Thời gian đến dự kiến (ETA) lái xe của toàn bộ 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 cả thời gian dừng tại mọi điểm tham chiếu trước dropoff_point được chỉ định trong yêu cầu. Giá trị này sẽ chỉ được điền sẵn khi bạn chỉ định một điểm dừng trong yêu cầu. Giá trị trống cho biết có lỗi khi tính toán thời gian dự kiến đến.

Int32Value

Quãng đường lái xe (tính bằng mét) của xe 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ỉ 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 sẵn khi bạn chỉ định một 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 lấy hàng đến điểm trả hàng được chỉ định trong yêu cầu.

TripType

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

Waypoint

Danh sách có thứ tự gồm các điểm tham chiếu dùng để tính thời gian dự kiến đến. Danh sách này bao gồm vị trí của xe, điểm đón của các chuyến đi đang hoạt động cho xe và điểm đón được cung cấp trong yêu cầu. Danh sách trống cho biết không tính được thời gian đến dự kiến của xe.

VehicleMatchType

Loại kết quả khớp của xe.

VehicleMatchOrder

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

VehicleMatchOrder

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

RoadStretch

Không bắt buộc. Đoạn đường cần được kết xuất dọc theo đường 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.

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

Style

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

int32

Bắt buộc. Kiểu này sẽ được áp dụng trong khoảng [offset_meters, offset_meters + length_meters).

int32

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

LatLng

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

Timestamp

Thời gian dự kiến xe sẽ đến điểm tham chiếu này.