- Biểu diễn dưới dạng JSON
- SearchVehiclesRequestLog
- VehicleAttributeListLog
- SearchVehiclesResponseLog
- VehicleMatchLog
Thông tin chi tiết về yêu cầu và phản hồi SearchVehicles.
Lưu ý: Nhật ký này có thể bị phân tách theo trường kết quả trùng khớp nếu tổng kích thước nhật ký vượt quá 256 KB. Hãy xem phần Nhật ký phân tách để biết thêm thông tin chi tiết.
| Biểu diễn dưới dạng JSON |
|---|
{ "request": { object ( |
| Trường | |
|---|---|
request |
Yêu cầu được gửi đến Công cụ quản lý đội xe. |
response |
Phản hồi được trả về cho ứng dụng khách. Nếu lệnh gọi RPC dẫn đến lỗi, thì phản hồi sẽ không được đặt. |
errorResponse |
Phản hồi lỗi được trả về cho ứng dụng khách. Giá trị này sẽ bị huỷ thiết lập nếu lệnh gọi RPC thành công. |
SearchVehiclesRequestLog
Thông tin chi tiết về yêu cầu SearchVehicles.
| Biểu diễn dưới dạng JSON |
|---|
{ "header": { object ( |
| Trường | |
|---|---|
header |
Tiêu đề yêu cầu. |
pickupPoint |
Điểm đến lấy hàng để tìm kiếm ở gần. |
dropoffPoint |
Địa điểm giao hàng mà khách hàng dự định. |
pickupRadiusMeters |
Chỉ định bán kính tìm kiếm xe xung quanh điểm đón. |
count |
Chỉ định số lượng xe tối đa cần trả về. |
minimumCapacity |
Chỉ định sức chứa tối thiểu bắt buộc của xe. |
searchTripTypes[] |
Chỉ cho phép tìm kiếm những xe hỗ trợ ít nhất một trong các loại chuyến đi đã chỉ định. |
maximumStaleness |
Chỉ cho phép tìm kiếm những xe đã cập nhật vị trí của chúng trong khoảng thời gian được chỉ định tính từ thời điểm hiện tại. Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng " |
vehicleTypes[] |
Loại xe bạn đang tìm kiếm. |
requiredAttributes[] |
Chỉ cho phép tìm kiếm những chiếc xe có các thuộc tính được chỉ định. |
requiredOneOfAttributes[] |
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 áp dụng cho mỗi VehicleAttributeList. |
requiredOneOfAttributeSets[] |
Chỉ cho phép tìm kiếm những chiếc xe có ít nhất một nhóm thuộc tính được chỉ định trong VehicleAttributeList. |
matchOrderBy |
Thứ tự sắp xếp của kết quả tìm kiếm. |
includeBackToBack |
Cho biết liệu một xe có chuyến đi đang hoạt động có đủ điều kiện để so khớp với một chuyến đi khác hay không. |
tripId |
Mã của chuyến đi được liên kết với searchVehiclesRequest. |
filter |
Truy vấn AIP-160 giới hạn các xe được trả về dựa trên các thuộc tính của xe. |
VehicleAttributeListLog
Loại dữ liệu danh sách-danh sách cho VehicleAttributeLog.
| Biểu diễn dưới dạng JSON |
|---|
{
"attributes": [
{
object ( |
| Trường | |
|---|---|
attributes[] |
Danh sách các thuộc tính trong bộ sưu tập này. |
SearchVehiclesResponseLog
Thông tin chi tiết về phản hồi SearchVehicles.
| Biểu diễn dưới dạng JSON |
|---|
{
"matchIds": [
string
],
"matches": [
{
object ( |
| Trường | |
|---|---|
matchIds[] |
Đã ngừng sử dụng: Danh sách mã nhận dạng xe cho các xe được trả về. Vui lòng sử dụng matches.vehicle.name để lấy mã nhận dạng này. |
matches[] |
Danh sách VehicleMatches cho các xe được trả về. |
VehicleMatchLog
Nhật ký của kết quả VehicleMatch trong SearchVehicles.
| Biểu diễn dưới dạng JSON |
|---|
{ "vehicle": { object ( |
| Trường | |
|---|---|
vehicle |
Một chiếc xe phù hợp với yêu cầu. |
vehiclePickupEta |
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. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
vehiclePickupDistanceMeters |
Khoảng cách lái xe 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 một chuyến đi hiện tại. Giá trị trống cho biết không tính toán được quãng đường cho xe. |
vehiclePickupStraightLineDistanceMeters |
Khoảng cách theo đường thẳng giữa xe và điểm đón được chỉ định trong yêu cầu, bao gồm cả các điểm trung gian cho các chuyến đi hiện có. |
vehicleDropoffEta |
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 mọi lượt ghé thăm bắt buộc cho các chuyến đi đang hoạt động mà bạn phải hoàn tất trước khi xe đến điểm trả khách được chỉ định trong yêu cầu. Giá trị này sẽ chỉ được điền khi điểm trả hàng được chỉ định trong yêu cầu. Giá trị trống cho biết không tính toán được ETA để xe đến điểm trả khách. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
vehiclePickupToDropoffDistanceMeters |
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 trung gian nào khác trước khi xe đến điểm đón hoặc điểm trả khách. Giá trị này sẽ chỉ được điền khi điểm trả hàng được chỉ định trong yêu cầu. Giá trị trống cho biết không tính toán được khoảng cách từ điểm đón đến điểm trả khách được chỉ định trong yêu cầu. |
tripType |
Loại chuyến đi của yêu cầu được dùng để tính thời gian đến điểm đón. |
vehicleMatchType |
Loại kiểu khớp xe. |
requestedOrderedBy |
Phương thức mà phương thức gọi yêu cầu để sắp xếp các kết quả trùng khớp về xe. |
orderedBy |
Phương thức thực tế được dùng để đặt xe này. Thông thường, giá trị 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 như khi phần phụ trợ của Google Maps gặp sự cố, bạn có thể sử dụng một phương thức khác (chẳng hạn như PICKUP_POINT_STRAIGHT_DISTANCE). |