Package maps.fleetengine.v1

BatteryStatus

電池狀態：充飽電或正在充電等。

PowerSource

電池電源狀態。

float

目前電量百分比 [0-100]。

SpeedReadingInterval

從上一個路線控點到目前路線點的路徑速度。

string

驅動程式從上一個路線控點到目前路線點的路徑。此路徑包含地標，可讓用戶端顯示路徑沿途的車流量標記 (請參閱 speed_reading_interval)。目前不支援解碼。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

string

必要欄位。專屬行程 ID。必須遵守下列限制：

• 必須是有效的萬國碼 (Unicode) 字串。
• 長度上限為 64 個半形字元。
• 根據 Unicode 正規化表單 C 進行正規化。
• 不可包含下列 ASCII 字元：/、「:」、「?」、「,」或「#」。

Trip

必要欄位。要建立的行程實體。

建立行程時，請務必填寫下列欄位：

• trip_type
• pickup_point

系統會使用下列欄位：

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

系統會忽略所有其他行程欄位。舉例來說，即使您在建立要求中傳遞 CANCELED 的 trip_status，所有行程的 trip_status 都會以 NEW 為起點。

只有 EXCLUSIVE 趟行程支援intermediate_destinations。

如果為共用的行程設定 vehicle_id，您必須提供 Trip.vehicle_waypoints 清單來指定車輛其餘路線控點的順序，否則系統將無法判定路線控點順序。

指定 Trip.vehicle_waypoints 時，清單必須包含車輛行程的其餘所有路線控點，中間不可包含額外的路線控點。您必須排序這些路線控點，讓指定行程的上車地點早於中繼目的地，而且所有中繼目的地都必須在下車地點之前。EXCLUSIVE 行程的路線控點不得與任何其他行程交錯。

系統會使用 trip_id、waypoint_type 和 location 欄位，並忽略 vehicle_waypoints 中所有其他 TripWaypoint 欄位。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

string

必要欄位。專屬車輛 ID。必須遵守下列限制：

• 必須是有效的萬國碼 (Unicode) 字串。
• 長度上限為 64 個半形字元。
• 根據 Unicode 正規化表單 C 進行正規化。
• 不可包含下列 ASCII 字元：/、「:」、「?」、「,」或「#」。

Vehicle

必要欄位。要建立的車輛實體。建立交通工具時，請務必填寫下列欄位：

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

建立車輛時，系統會忽略下列欄位：

• 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

所有其他欄位均為選填欄位，如有提供。

LocationPowerSaveMode

省電模式開啟時，裝置的位置資訊設定如何運作。

bool

裝置目前是否處於省電模式。

bool

裝置是否處於互動狀態。

BatteryInfo

電池狀態相關資訊。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}/trips/{trip}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

TripView

應傳回的行程欄位子集和解讀內容。

Timestamp

指出擷取 Trip.route 或 Trip.current_route_segment 資料的最小時間戳記 (不含)。如果從此時間戳記之後的路線資料維持不變，則回應中不會設定路線欄位。如果未指定最小值，系統一律會擷取路線資料。

Timestamp

指出擷取 Trip.remaining_waypoints 的最小時間戳記 (不含)。如果從這個時間戳記後未發生任何變化，則不會在回應中設定 remaining_waypoints。如未指定這個欄位，系統一律會擷取 remaining_waypoints。

PolylineFormatType

傳回的目前路線格式：LAT_LNG_LIST_TYPE (在 Trip.route 中) 或 ENCODED_POLYLINE_TYPE (在 Trip.current_route_segment 中)。預設為 LAT_LNG_LIST_TYPE。

Timestamp

指出擷取 Trip.current_route_segment_traffic 的最小時間戳記 (不含)。如果從此時間戳記之後的流量資料維持不變，回應中不會設定 current_route_segment_traffic 欄位。如果未指定最小值，系統一律會擷取流量資料。請注意，只有隨選乘車和運送服務解決方案客戶才能查詢路況。

Timestamp

指出擷取 Trip.remaining_waypoints.traffic_to_waypoint 和 Trip.remaining_waypoints.path_to_waypoint 資料的最小時間戳記 (不含)。如果自此時間戳記後資料維持不變，則回應中不會設定以上欄位。如果未指定 remaining_waypoints_route_version，一律會擷取流量和路徑。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}/vehicles/{vehicle}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

Timestamp

指出擷取 Vehicle.current_route_segment 的最小時間戳記 (不含)。如果路線從這個時間戳記後維持不變，則回應中不會設定 current_route_segment 欄位。如果未指定最小值，系統一律會擷取 current_route_segment。

Timestamp

指出擷取 Vehicle.waypoints 資料的最小時間戳記 (不含)。如果路線控點自這個時間戳記後沒有變化，則回應中不會設定 vehicle.waypoints 資料。如未指定這個欄位，系統一律會擷取 vehicle.waypoints。

string

必要欄位。CLDR 國家/地區代碼。例如 US 代表美國，IN 代表印度。

string

車牌的末碼或「-1」表示車牌上沒有數值。

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

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

int32

要傳回的車輛數量上限。預設值為 100。

string

先前呼叫 ListVehicles 提供的 next_page_token 值，讓您可以對多組車輛進行分頁。如果要求的篩選條件與先前呼叫 ListVehicles 的篩選條件不同，該值就不會定義。

Int32Value

指定車輛所需的最低容量。所有傳回的車輛都會有大於或等於這個值的 maximum_capacity。設定時，必須大於或等於 0。

TripType

限制回應範圍必須支援至少一種指定行程類型的車輛。

Duration

限制系統在指定時間內對 Fleet Engine 傳送位置更新資訊的車輛做出回應。即使一般車輛仍在傳輸位置資訊，也不算過時。如有提供，必須是有效的正值。

Category

必要欄位。限制回應具有其中一個指定類型類別的車輛。不允許UNKNOWN。

string

呼叫端可以使用 required_attributes、required_one_of_attributes 和 required_one_of_attribute_sets 欄位的任意組合形成複雜的邏輯運算。

required_attributes 是清單；required_one_of_attributes 使用的訊息允許清單列表。結合這兩個欄位，即可編寫這個運算式：

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

限制回應具有指定屬性的車輛。這個欄位是結合/AND 作業。最多只能指定 50 個 required_attributes。這與車輛允許的屬性數量上限相符。每個重複字串的格式應為「key:value」。

string

限制對每個 VehicleAttributeList 中至少具有一個指定屬性的車輛回應。每份清單上的車輛至少須有一項屬性相符。這個欄位是每個 VehicleAttributeList 中的否定/OR 運算，以及 VehicleAttributeList 集合中的連接/AND 運算。每個重複字串的格式應為「key1:value1|key2:value2|key3:value3」。

string

required_one_of_attribute_sets 提供額外功能。

與 required_one_of_attributes 類似，required_one_of_attribute_sets 會使用訊息來允許清單清單，並允許下列運算式：

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

限制只能回應與 VehicleAttributeList 中所有屬性相符的車輛。每份清單上的車輛都必須與所有屬性相符。這個欄位是每個 VehicleAttributeList 中的合集/AND 運算，且 VehicleAttributeList 集合內包覆式/OR 運算。每個重複字串的格式應為「key1:value1|key2:value2|key3:value3」。

VehicleState

限制回應具有此車輛狀態的車輛。

bool

只傳回有當前行程的車輛。

string

選用設定。列出車輛時要套用的篩選查詢。如需篩選器語法範例，請參閱 http://aip.dev/160。

這個欄位是用來取代 required_attributes、required_one_of_attributes 和 required_one_of_attributes_sets 欄位。如果在這裡指定非空白值，下列欄位必須留空：required_attributes、required_one_of_attributes 和 required_one_of_attributes_sets。

這個篩選函式可做為 AND 子句，但具有其他限制條件，例如 vehicle_state 或 on_trip_only。

請注意，只有車輛屬性 (例如 attributes.<key> = <value> 或 attributes.<key1> = <value1> AND attributes.<key2> = <value2>) 才支援查詢。篩選查詢最多可包含 50 個限制。

此外，所有屬性都會儲存為字串，因此唯一支援與屬性的比較是字串比較。如要與數字或布林值比較，您必須明確加上引號，才能視為字串 (例如 attributes.<key> = "10" 或 attributes.<key> = "true")。

Viewport

選用設定。這個篩選器可限制車輛只返回可視位置位於可視區域定義的矩形區域。

Vehicle

符合要求條件的車輛。傳回的車輛數量上限取決於要求中的 page_size 欄位。

string

用來擷取下一頁車輛的權杖；如果沒有其他符合要求條件的車輛，則留空。

int64

必要欄位。在所有頁面中，符合要求的車輛總數。

string

必要欄位。格式須為 providers/{provider}/billableTrips/{billable_trip}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

string

必要欄位。行程所在國家/地區的雙字母國家/地區代碼。價格是根據國家/地區代碼定義，

BillingPlatformIdentifier

發出要求的平台。

string

與回報行程直接相關的 ID。這些通常是預訂作業的 ID (例如工作階段 ID)，在行程 ID 可供使用前完成。related_ids 數量上限為 50 個。

SolutionType

用於回報行程的 GMP 產品解決方案類型 (例如 ON_DEMAND_RIDESHARING_AND_DELIVERIES)。

string

BCP-47 語言代碼，例如 en-US 或 sr-Latn。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如未指定，回應可能會以任何語言寫成，如有這類名稱，應優先使用英文。欄位值範例：en-US。

string

必要欄位。要求來源地區的 CLDR 區域代碼。欄位值範例：US。

string

呼叫 SDK 的版本 (如適用)。版本格式為「major.minor.patch」，例如：1.1.2。

string

執行呼叫 SDK 的作業系統版本。欄位值範例：4.4.1、12.1。

string

執行呼叫 SDK 的裝置型號。欄位值範例：iPhone12,1、SM-G920F。

SdkType

傳送要求的 SDK 類型。

string

呼叫 SDK 依附的 MapSDK 版本 (如適用)。版本格式為「major.minor.patch」，例如：5.2.1。

string

呼叫 SDK 依附的 NavSDK 版本 (如適用)。版本格式為「major.minor.patch」，例如：2.1.0。

Platform

呼叫 SDK 的平台。

string

透過呼叫 SDK 的 Android 裝置製造商，僅適用於 Android SDK。欄位值範例：Samsung。

int32

呼叫 SDK 的 Android API 級別，僅適用於 Android SDK。欄位值範例：23。

string

可供記錄用途的選用 ID，以利辨識要求。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

string

與要求中行程相關聯的車輛。如果未指定，傳回的行程不包含：

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

如果設為 true，回應會包含影響駕駛路線的行程。

int32

如果未設定，伺服器會決定要傳回的結果數量。

string

將其設為先前在 SearchTripsResponse 中傳回的值，以便接續先前的結果。

Duration

如果指定的話，系統會傳回 (current - minimum_staleness) 時間之後尚未更新的行程。

Trip

要求車輛的行程清單。

string

在 SearchTripsRequest 中將此憑證傳遞到清單結果頁面。API 會在每次呼叫傳回行程清單，當行程清單未繼續時，就會傳回空白清單。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

TerminalLocation

必要欄位。要搜尋的上車地點。

TerminalLocation

客戶預計的下車地點。如果 trip_types 包含 TripType.SHARED，則此為必要欄位。

int32

必要欄位。定義取貨點周圍的車輛搜尋半徑。系統只會傳回搜尋半徑範圍內的車輛。值必須介於 400 至 10000 公尺 (含) 之間。

int32

必要欄位。指定傳回的車輛數量上限。這個值必須介於 1 至 50 (含) 之間。

int32

必要欄位。指定行程的乘客人數。這個值必須大於或等於 1。容量值不會計入驅動程式。

TripType

必要欄位。代表建議行程的類型。必須只包含一種類型。不允許使用 UNKNOWN_TRIP_TYPE。將搜尋範圍限制在支援該行程類型的車輛。

Duration

僅搜尋在指定時間內傳送位置更新資訊至 Fleet Engine 的車輛。即使一般車輛仍在傳輸位置資訊，也不算過時。如未設定這個欄位，伺服器會使用 5 分鐘做為預設值。

VehicleType

必要欄位。將搜尋範圍限制在符合其中一個指定類型的車輛。至少須指定一種交通工具類型。不允許使用類別為 UNKNOWN 的交通工具類型。

VehicleAttribute

呼叫端可以使用 required_attributes、required_one_of_attributes 和 required_one_of_attribute_sets 欄位的任意組合形成複雜的邏輯運算。

required_attributes 是清單；required_one_of_attributes 使用的訊息允許清單列表。結合這兩個欄位，即可編寫這個運算式：

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

將搜尋範圍限制在含有指定屬性的車輛。這個欄位是結合/AND 作業。最多只能指定 50 個 required_attributes。這與車輛允許的屬性數量上限相符。

VehicleAttributeList

僅搜尋各 VehicleAttributeList 中至少有一項指定屬性的車輛。每份清單上的車輛至少須有一項屬性相符。這個欄位是每個 VehicleAttributeList 中的否定/OR 運算，以及 VehicleAttributeList 集合中的連接/AND 運算。

VehicleAttributeList

required_one_of_attribute_sets 提供額外功能。

與 required_one_of_attributes 類似，required_one_of_attribute_sets 會使用訊息來允許清單清單，並允許下列運算式：

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

僅搜尋具有 VehicleAttributeList 所有屬性的車輛。每份清單上的車輛都必須與所有屬性相符。這個欄位是每個 VehicleAttributeList 中的合集/AND 運算，且 VehicleAttributeList 集合內包覆式/OR 運算。

VehicleMatchOrder

必要欄位。為結果指定所需的排序條件。

bool

指出是否只有單一有效行程的車輛可執行這項搜尋。只有在未指定 current_trips_present 的情況下，系統才會使用此欄位。如果未指定 current_trips_present 且這個欄位為 false，就會從搜尋結果中排除已指定行程的車輛。如未指定 current_trips_present 且這個欄位為 true，搜尋結果可能會包含只有一個進行中行程的車輛，且狀態為 ENROUTE_TO_DROPOFF。如果指定 current_trips_present，則無法將這個欄位設為 true。

預設值為 false。

string

表示與這個 SearchVehicleRequest 相關聯的行程。

CurrentTripsPresent

表示有有效行程的車輛是否可執行這項搜尋。如果 trip_type 包含 SHARED，則必須設為 CURRENT_TRIPS_PRESENT_UNSPECIFIED 以外的其他值。

string

選用設定。搜尋車輛時要套用的篩選查詢。如需篩選器語法範例，請參閱 http://aip.dev/160。

這個欄位是用來取代 required_attributes、required_one_of_attributes 和 required_one_of_attributes_sets 欄位。如果在這裡指定非空白值，下列欄位必須留空：required_attributes、required_one_of_attributes 和 required_one_of_attributes_sets。

這個篩選函式可做為 AND 子句，但具有其他限制條件，例如 minimum_capacity 或 vehicle_types。

請注意，只有車輛屬性 (例如 attributes.<key> = <value> 或 attributes.<key1> = <value1> AND attributes.<key2> = <value2>) 才支援查詢。篩選查詢最多可包含 50 個限制。

此外，所有屬性都會儲存為字串，因此唯一支援與屬性的比較是字串比較。如要與數字或布林值比較，您必須明確加上引號，才能視為字串 (例如 attributes.<key> = "10" 或 attributes.<key> = "true")。

VehicleMatch

符合 SearchVehiclesRequest 條件的車輛清單，依 SearchVehiclesRequest.order_by 欄位排序。

int32

在路徑中這個間隔的起始索引，在 JSON 中，當索引為 0 時，該欄位會顯示為未填入欄位。

int32

在路徑中這個間隔的結束索引。在 JSON 中，當索引為 0 時，該欄位會顯示為未填入欄位。

Speed

這段時間的車流速度。

LatLng

必要欄位。表示實際位置。

Timestamp

表示停止發生的時間。

Timestamp

僅限輸入。已淘汰，使用時間戳記欄位。

LatLng

必要欄位。表示行程路線控點的位置。

TerminalPointId

已淘汰：改為指定 point 欄位。

string

已淘汰：改為指定 point 欄位。

string

已淘汰。

WaypointType

已淘汰：「Vehicle.waypoint」會使用這項資料。

string

已淘汰。

string

已淘汰。

string

已淘汰。

VisualTrafficReportPolylineRendering

顯示顧客在一段期間內，所有區域的車速有多快的折線。

string

僅供輸出。格式為「provider/{provider}/trips/{trip}」

string

這趟行程的車輛 ID。

TripStatus

行程目前的狀態。

TripType

行程類型。

TerminalLocation

供客戶取貨的位置。

StopLocation

僅限輸入。實際取貨時間和地點。供應商可在這個欄位中提供有關實際取貨資訊的意見回饋。

StopLocation

僅限輸入。司機抵達上車地點的實際時間和地點。供應商可透過這個欄位，就抵達上車地點的實際抵達資訊提供意見回饋。

Timestamp

僅供輸出。可能是預計乘客上車時間的未來時間，或是他們上車地點的實際時間。

TerminalLocation

中途停靠站，以按照行程要求行程 (除了上車和下車)。目前這項功能不適用於已分享的行程。

Timestamp

表示上次修改 intermediate_destinations 的時間。您的伺服器應快取這個值，並在更新 intermediate_destination_index 時傳入 UpdateTripRequest，確保 intermediate_destinations 不會遭到變更。

int32

當 TripStatus 為 ENROUTE_TO_INTERMEDIATE_DESTINATION 時，介於 [0..N-1] 之間的數字，表示車輛接下來會跨越哪個中繼目的地。當 TripStatus 為 ARRIVED_AT_INTERMEDIATE_DESTINATION 時，介於 [0..N-1] 之間的數字，表示車輛目前位於哪個中繼目的地。這個值由提供者設定。如果沒有 intermediate_destinations，系統會忽略這個欄位。

StopLocation

僅限輸入。駕駛人抵達中繼目的地的實際時間和地點。供應商可透過這個欄位，針對中繼目的地的實際抵達資訊提供意見回饋。

StopLocation

僅限輸入。從中繼目的地取貨客戶的實際時間和地點。供應商可透過這個欄位，針對中繼目的地的實際取貨資訊提供意見回饋。

TerminalLocation

消費者表示受訓人員等待的地點。

StopLocation

僅限輸入。客戶退出後的實際時間和地點。供應商可在這個欄位中提供有關實際下車資訊的意見回饋。

Timestamp

僅供輸出。可能是乘客在最終目的地下車的預計未來時間，或是乘客下車的實際時間。

TripWaypoint

僅供輸出。從目前位置到下車地點的完整路徑 (含)。此路徑可能包含其他行程的路線控點。

TripWaypoint

這個欄位支援手動排序行程的路線控點。內含指定車輛所有其他路線控點，以及這趟行程的上車和下車路線控點。如果行程尚未指派給車輛，Fleet Engine 會忽略這個欄位。基於隱私考量，只有透過 UpdateTrip 和 CreateTrip 呼叫的伺服器填入這個欄位，「不會」在 GetTrip 呼叫上填入。

LatLng

僅供輸出。這趟行程的預期路徑，可前往 back_waypoints 中第一個項目。請注意，第一個路線控點可能屬於不同的行程。

string

僅供輸出。前往下一個路線控點的編碼路徑。

注意：這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。目前不支援解碼。

Timestamp

僅供輸出。指出上次修改路線的時間。

注意：這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。

ConsumableTrafficPolyline

僅供輸出。指出 current_route_segment 沿途的路況 (如有)。

注意：這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。

Timestamp

僅供輸出。表示上次修改 current_route_segment_traffic 的時間。

注意：這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。

TripWaypoint

僅供輸出。current_route_segment 結束的路線點。

Int32Value

僅供輸出。current_route_segment 欄位剩餘的行車距離。如果行程未指派給車輛，或是行程已完成或取消，則未指定這個值。

Timestamp

僅供輸出。到下一個路線控點的預計到達時間 (remaining_waypoints 欄位中的第一個項目)。如果行程未指派給車輛，或是行程無效 (已完成或取消)，則未指定這個值。

Duration

僅供輸出。從行程資料傳回 Trip.eta_to_first_waypoint 時間的期間。如果行程未指派給車輛，或是行程無效 (已完成或取消)，則未指定這個值。

Timestamp

僅供輸出。表示上次變更 remaining_waypoints 的時間 (新增、移除或變更路線控點)。

Timestamp

僅供輸出。表示上次修改 remaining_waypoints.path_to_waypoint 和 remaining_waypoints.traffic_to_waypoint 的時間。您的用戶端應用程式應快取這個值並傳入 GetTripRequest，確保只有更新後才會傳回 remaining_waypoints 的路徑和流量。

int32

不可變動。用於表示這趟行程的乘客人數，不包括司機。車輛必須有可用容量，才能在 SearchVehicles 回應中傳回。

VehicleLocation

僅供輸出。用於指出沿途車輛上次回報的位置。

bool

僅供輸出。用於指出車輛的 last_location 能否對齊 current_route_segment。如果 last_location 或 current_route_segment 不存在，則為「False」。由 Fleet Engine 計算。系統會忽略來自用戶端的任何更新。

TripView

已填入的行程欄位子集及應如何解讀。

TerminalLocation

這個路線控點的位置。

string

與這個路線控點相關聯的行程。

WaypointType

這個路線控點在這趟行程中扮演的角色，例如上車或下車地點。

LatLng

從上一個路線控點到目前路線點的路徑。清單中第一個路線點的未定義。這個欄位只有在要求時才會填入。

string

從前一個路線控點到目前路線點的編碼路徑。

注意：這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。目前不支援解碼。

ConsumableTrafficPolyline

途經此路線控點的路況。請注意，只有 Google 地圖平台乘車和配送服務解決方案客戶才能查詢路況。

Int32Value

上一個路線控點到目前路線點的路徑距離。清單中第一個路線點的未定義。

Timestamp

到達這個路線控點的預計到達時間。清單中第一個路線點的未定義。

Duration

從上一個路線控點到這個點的交通時間。清單中第一個路線點的未定義。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}/trips/{trip}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-consumer-project)。

Trip

必要欄位。與更新內容相關聯的行程。

以下欄位由 Fleet Engine 維護。請勿使用 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

更新共用行程的 Trip.vehicle_id 時，您必須提供 Trip.vehicle_waypoints 清單來指定其餘路線控點的順序，否則會無法決定順序。

指定 Trip.vehicle_waypoints 時，清單必須包含車輛行程的其餘所有路線控點，中間不可包含額外的路線控點。您必須排序這些路線控點，讓指定行程的上車地點早於中繼目的地，而且所有中繼目的地都必須在下車地點之前。EXCLUSIVE 行程的路線控點不得與任何其他行程交錯。系統會使用 trip_id、waypoint_type 和 location 欄位，並忽略 vehicle_waypoints 中所有其他 TripWaypoint 欄位。

為了避免含有多個目的地的行程出現競爭狀況，請在將行程狀態更新為 ENROUTE_TO_INTERMEDIATE_DESTINATION 時提供 Trip.intermediate_destinations_version。傳遞的 Trip.intermediate_destinations_version 必須與 Fleet Engine 的版本一致。否則，要求失敗。

FieldMask

必要欄位。欄位遮罩可指出行程中要更新哪些欄位。update_mask 必須包含至少一個欄位。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}/vehicles/{vehicle}。提供者必須是發出此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

VehicleAttribute

必要欄位。要更新的車輛屬性。但不會變更或移除未提及的屬性。

VehicleAttribute

必要欄位。更新後的車輛屬性完整清單，包括新屬性、經修改和未修改的屬性。

RequestHeader

標準 Fleet Engine 要求標頭。

string

必要欄位。格式須為 providers/{provider}/vehicles/{vehicle}。{provider} 必須是呼叫此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

Vehicle

必要欄位。要套用的 Vehicle 實體值。更新 Vehicle 時，下列欄位是由伺服器管理，因此可能不會更新。

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

如果 attributes 欄位更新，則「所有」車輛屬性都會替換成要求中提供的屬性。如果只想更新部分屬性，請參閱 UpdateVehicleAttributes 方法。

同樣地，waypoints 欄位可以更新，但必須包含車輛目前使用的所有路線控點，不得包含其他路線控點。

FieldMask

必要欄位。欄位遮罩，指出要更新 Vehicle 的哪些欄位。至少須提供一個欄位名稱。

string

僅供輸出。這輛車的專屬名稱。格式為 providers/{provider}/vehicles/{vehicle}。

VehicleState

車輛狀態。

TripType

這輛車支援的行程類型。

string

僅供輸出。目前指派給這輛車的行程 trip_id 清單。

VehicleLocation

上次回報的車輛位置

int32

這輛車可載客總人數。這個值不含驅動程式。這個值必須大於或等於 1。

VehicleAttribute

車輛屬性清單。一輛車最多能有 100 個屬性，而且每個屬性都必須有專屬索引鍵。

VehicleType

必要欄位。這輛車的類型。可用來篩選 SearchVehicles 結果中的車輛。這也會影響預計到達時間和路線的計算結果。

LicensePlate

車輛的車牌資訊。

TerminalLocation

已淘汰：請改用 Vehicle.waypoints。

string

用於指定駕駛應用程式前往下一個路線點的路徑的折線。凡是指派給車輛的有效行程，這份清單也會在 Trip.current_route_segment 中傳回。

注意：這個欄位僅供驅動程式 SDK 使用。目前不支援解碼。

TrafficPolylineData

僅限輸入。Fleet Engine 會使用這項資訊改善旅程分享體驗。注意：這個欄位僅供驅動程式 SDK 使用。

Timestamp

僅供輸出。設定current_route_segment的時間。用戶端可儲存這個檔案，並在日後的 GetVehicle 要求中傳遞，避免傳回未變更的路徑。

TripWaypoint

current_route_segment 結束的路線點。這項資訊可能由 UpdateVehicle 呼叫的駕駛提供，可以是完整的行程路線控點、路線控點 LatLng，或 current_route_segment 的最後一個 LatLng。在未完整指定的情況下，Fleet Engine 會盡可能內插至實際路線控點。除非一併指定 current_route_segment，否則 UpdateVehicle 呼叫中會忽略這個欄位。

Int32Value

current_route_segment剩餘的行車距離。對於指派給車輛的所有有效行程，系統也會在 Trip.remaining_distance_meters 中傳回這個值。如果 current_route_segment 欄位空白，則系統不會指定該值。

Timestamp

預計到達 waypoints 欄位中第一個項目的預計到達時間。如果 waypoints 欄位空白或 Vehicle.current_route_segment 欄位為空白，則系統不會指定這個值。

更新車輛時，在同一項要求中，remaining_time_seconds 的優先順序高於 eta_to_first_waypoint。

Int32Value

僅限輸入。current_route_segment的剩餘行車時間。如果 waypoints 欄位空白或 Vehicle.current_route_segment 欄位為空白，則系統不會指定這個值。如果所有方都使用相同的時鐘，這個值應符合 eta_to_first_waypoint - current_time。

更新車輛時，在同一項要求中，remaining_time_seconds 的優先順序高於 eta_to_first_waypoint。

TripWaypoint

指派給這輛車的其餘路線控點。

Timestamp

僅供輸出。上次更新 waypoints 欄位的時間。用戶端應快取這個值並傳入 GetVehicleRequest，確保 waypoints 欄位只有在更新之後才會傳回。

bool

指出駕駛是否接受返回行程。如果 true，即使目前已分配到行程，SearchVehicles 仍可能納入車輛。預設值為 false。

NavigationStatus

車輛的導航狀態。

DeviceSettings

僅限輸入。駕駛人所用行動裝置的設定相關資訊。

Category

交通工具類型類別

string

屬性鍵。鍵不得包含冒號字元 (:)。

string

屬性值。

string

字串類型的屬性值。

注意：這與 value 欄位相同，最終將會淘汰。針對建立或更新方法，任一欄位都可以使用，但我們強烈建議使用 string_value。如果 string_value 和 value 皆已設定，兩者必須相同，否則系統會擲回錯誤。這兩個欄位都會填入回應。

bool

布林值類型的屬性值。

double

雙重輸入的屬性值。

VehicleAttribute

這個集合中的屬性清單。

LatLng

車輛的位置。傳送到 Fleet Engine 時，車輛的位置是 GPS 位置。當您在回應中收到這項資訊時，車輛的所在位置可能是 GPS 位置、補充位置或其他大概位置。來源在 location_sensor 中指定。

DoubleValue

已淘汰：請改用 latlng_accuracy。

DoubleValue

半徑為 location (以公尺為單位) 的準確度。

Int32Value

車輛目前以度為單位的方向。0 代表北部。有效範圍為 [0,360]。

DoubleValue

已淘汰：請改用 heading_accuracy。

DoubleValue

精確度為 heading 度。

DoubleValue

高度 (以公尺為單位 WGS84 以上)。

DoubleValue

已淘汰：請改用 altitude_accuracy。

DoubleValue

精確度為 altitude (單位為公尺)。

Int32Value

車輛行駛速度，單位為公里。已淘汰：請改用 speed。

DoubleValue

車輛速度 (公尺/秒)

DoubleValue

speed的精確度 (單位為公尺/秒)。

Timestamp

感應器根據感應器時鐘回報location的時間。

Timestamp

僅供輸出。伺服器收到位置資訊的時間。

LocationSensor

位置資料的提供者 (例如 GPS)。

BoolValue

是否將 location 對齊道路。

BoolValue

僅限輸入。用於指出行動裝置是否已啟用 GPS 感應器。

Int32Value

僅限輸入。此位置首次傳送至伺服器後經過的時間 (以秒為單位)。如果是第一次更新，這個值會是零。如果時間不明 (例如應用程式重新啟動)，這個值會重設為零。

Int32Value

僅限輸入。已淘汰：系統現在會使用其他信號來判斷地區是否已過時。

LatLng

原始車輛位置 (未由道路救援人員處理)。

Timestamp

與原始位置相關聯的時間戳記。

LocationSensor

原始位置的來源。預設值為 GPS。

DoubleValue

半徑為 raw_location 的準確度 (以公尺為單位)。

LatLng

整合應用程式提供的補充位置。

Timestamp

與補充位置相關聯的時間戳記。

LocationSensor

補充位置的來源。預設值為 CUSTOMER_SUPPLIED_LOCATION。

DoubleValue

半徑為 supplemental_location 的準確度 (以公尺為單位)。

bool

已淘汰：請改用 is_road_snapped。

Vehicle

必要欄位。與要求相符的車輛。

Timestamp

車輛的行車預計到達時間，前往要求中指定的取貨地點。如果值為空白，表示計算車輛預計到達時間失敗。如果 SearchVehiclesRequest.include_back_to_back 為 true，且這輛車有進行中的行程，vehicle_pickup_eta 會包含完成目前有效行程所需的時間。

Int32Value

車輛目前位置與要求中指定的上車地點之間的距離，包括現有行程的任何中繼上車或下車點。這個距離包括計算出的行車 (路線) 距離，以及導航終點與所要求取貨地點之間的直線距離。(導航終點與所要求的取貨地點之間的距離通常很小。)空白值表示計算距離時發生錯誤。

Int32Value

必要欄位。車輛與要求中指定的取貨點之間的直線距離。

Timestamp

完整車輛的行車預計到達時間，前往要求中指定的下車地點。預計到達時間包括在要求中指定的 dropoff_point 之前任何路線控點的停靠站。只有在要求中指定下車地點時，系統才會填入這個值。空白值表示計算預計到達時間時發生錯誤。

Int32Value

從上車點到要求中指定的下車地點的車輛行車距離 (以公尺為單位)。距離只介於兩點之間，不含車輛位置，或是車輛造訪上車地點或下車地點前必須造訪的任何其他點。只有在要求中指定 dropoff_point 時，系統才會填入這個值。空白值表示在要求中，從上車地點到下車點的距離計算失敗。

TripType

必要欄位。要求的行程類型，用來計算抵達上車地點的預計到達時間。

Waypoint

用來計算預計到達時間的路線控點清單。這份清單包含車輛位置、車輛有效行程的取貨點，以及要求中提供的取貨點。如果清單空白，表示系統計算車輛預計到達時間時失敗。

VehicleMatchType

相符的車輛類型。

VehicleMatchOrder

要求排序車輛相符項目的順序。

VehicleMatchOrder

這輛車的實際訂單。通常會比對「order_by」欄位；不過，在某些情況下 (例如內部伺服器錯誤)，則可使用其他方法 (例如 PICKUP_POINT_STRAIGHT_DISTANCE)。

RoadStretch

選用設定。應沿著折線算繪的道路延伸。伸展量保證不會重疊，而且不一定能跨越整條路線。

如果沒有道路延展型，用戶端應套用路線的預設值。

Style

必要欄位。要套用的樣式。

int32

必要欄位。樣式應在 [offset_meters, offset_meters + length_meters) 之間。

int32

必要欄位。要套用樣式的路徑長度。

LatLng

這個路線控點的位置。

Timestamp

車輛抵達這個路線控點的預計時間。