進一步瞭解 SearchVehicles 要求和回應。
注意:如果記錄總大小超過 256 KB,這項記錄會拆分為相符欄位。詳情請參閱分割記錄的相關說明。
JSON 表示法 |
---|
{ "request": { object ( |
欄位 | |
---|---|
request |
要求已傳送至 Fleet Engine。 |
response |
傳回用戶端的回應。如果 RPC 呼叫導致錯誤,則未設定回應。 |
errorResponse |
傳回用戶端的錯誤回應。如果 RPC 呼叫成功,就會取消設定。 |
SearchVehiclesRequestLog
搜尋車輛要求的詳細資料。
JSON 表示法 |
---|
{ "header": { object ( |
欄位 | |
---|---|
header |
要求標頭。 |
pickupPoint |
要搜尋的取貨地點。 |
dropoffPoint |
客戶的預計下車地點。 |
pickupRadiusMeters |
指定上車地點周圍的車輛搜尋半徑。 |
count |
指定要傳回的車輛數量上限。 |
minimumCapacity |
指定車輛的最小容量需求。 |
searchTripTypes[] |
將搜尋範圍限制在支援至少一個指定行程類型的車輛。 |
maximumStaleness |
限制搜尋範圍僅限在指定時間內已更新地點的車輛。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
vehicleTypes[] |
搜尋的車輛類型。 |
requiredAttributes[] |
將搜尋範圍限制在具有指定屬性的車輛。 |
requiredOneOfAttributes[] |
將搜尋範圍限制在至少有一個指定屬性套用至每個 VehicleAttributeList 的車輛。 |
requiredOneOfAttributeSets[] |
將搜尋範圍限制在 VehicleAttributeList 中至少具備一組指定屬性的車輛。 |
matchOrderBy |
搜尋結果的排序順序。 |
includeBackToBack |
指出具備有效行程的車輛是否可進行其他比賽。 |
tripId |
與 searchVehiclesRequest 相關聯的行程 ID。 |
filter |
一種 AIP-160 查詢,可根據車輛屬性限制傳回的車輛。 |
VehicleAttributeListLog
VehicleAttributeLog 的清單資料類型清單。
JSON 表示法 |
---|
{
"attributes": [
{
object ( |
欄位 | |
---|---|
attributes[] |
這個集合中的屬性清單。 |
SearchVehiclesResponseLog
進一步瞭解 SearchVehicles 回應。
JSON 表示法 |
---|
{
"matchIds": [
string
],
"matches": [
{
object ( |
欄位 | |
---|---|
matchIds[] |
已淘汰:退回車輛的車輛 ID 清單。請使用 match.vehicle.name 衍生這個 ID。 |
matches[] |
傳回的車輛的交通工具符合清單。 |
VehicleMatchLog
SearchVehicles VehicleMatch 結果的記錄。
JSON 表示法 |
---|
{ "vehicle": { object ( |
欄位 | |
---|---|
vehicle |
符合要求的車輛。 |
vehiclePickupEta |
車輛的行駛時間 (到達要求中指定的上車地點)。空白值表示系統計算車輛的預計到達時間時失敗。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
vehiclePickupDistanceMeters |
車輛前往要求中指定的上車地點的行車距離,包括現有行程的任何中繼上車或下車地點。空白值表示系統計算車輛距離時失敗。 |
vehiclePickupStraightLineDistanceMeters |
車輛與要求中指定的上車點之間的直線距離,包括現有行程的中繼路線控點。 |
vehicleDropoffEta |
完整車輛的行駛預計到達點,到達要求中指定的下車地點。你必須在車輛抵達指定下車地點前完成所有必要行程,才能抵達「預計到達時間」。只有在要求中指定下車點時,系統才會填入這個值。如果值為空白,表示系統無法計算車輛抵達下車地點的預計到達時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
vehiclePickupToDropoffDistanceMeters |
車輛從上車地點到要求中指定的下車地點的行車距離 (以公尺為單位)。距離只介於兩個點之間,且不包含車輛抵達上車地點或下車地點前的車輛位置或任何其他路線控點。只有在要求中指定下車點時,系統才會填入這個值。如果值為空白,則代表無法計算要求中指定的上車地點與下車地點之間的距離。 |
tripType |
要求中的行程類型,用於計算預計到達上車地點的預計到達時間。 |
vehicleMatchType |
交通工具的類型。 |
requestedOrderedBy |
呼叫端為車輛排序要求的方法。 |
orderedBy |
用來訂購這輛車的實際方式。通常,這個欄位會與要求中的「order_by」欄位相符。但是在某些情況下,例如 Google 地圖後端故障等,您可能會使用其他方法 (例如 PICKUP_POINT_STRAIGHT_DISTANCE)。 |