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 Normalization Form C 進行正規化。
• 不得包含下列任何 ASCII 字元：'/'、':'、'?'、',' 或 '#'。

Trip

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

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

• trip_type
• pickup_point

系統會使用您提供的下列欄位：

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

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

只有 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 Normalization Form C 進行正規化。
• 不得包含下列任何 ASCII 字元：'/'、':'、'?'、',' 或 '#'。

Vehicle

必要欄位。要建立的 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

應傳回的 Trip 欄位子集及其解讀方式。

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。這與車輛允許的屬性數量上限相符。每個重複字串的格式應為「鍵：值」。

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 欄位必須留空。

這個篩選器可與其他限制條件 (例如 vehicle_state 或 on_trip_only) 搭配使用，做為 AND 子句。

請注意，系統僅支援車輛屬性查詢 (例如 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 傳送位置更新的車輛。靜止車輛仍會傳送位置，因此不會被視為過時。如果未設定此欄位，伺服器會使用五分鐘做為預設值。

VehicleType

必要欄位。將搜尋範圍限制在某個指定類型的車輛。您必須指定至少一種車輛類型。不允許類別為 UNKNOWN 的 VehicleTypes。

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 欄位必須留空。

這個篩選器可與其他限制條件 (例如 minimum_capacity 或 vehicle_types) 搭配使用，做為 AND 子句。

請注意，系統僅支援車輛屬性查詢 (例如 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

僅供輸出。格式為「providers/{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

僅供輸出。這趟行程預期的路線，從起點到 remaining_waypoints 中的首個項目。請注意，第一個路線點可能屬於不同的行程。

string

僅供輸出。下一個路標的經過編碼的路徑。

注意：此欄位僅供 Driver SDK 和 Consumer SDK 使用。尚未支援解碼。

Timestamp

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

注意：此欄位僅供 Driver SDK 和 Consumer SDK 使用。

ConsumableTrafficPolyline

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

注意：此欄位僅供 Driver SDK 和 Consumer SDK 使用。

Timestamp

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

注意：此欄位僅供 Driver 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。由車隊引擎計算。系統會忽略來自用戶端的任何更新。

TripView

要填入的 Trip 欄位子集，以及如何解讀這些欄位。

TerminalLocation

此航點的位置。

string

與此路標相關聯的行程。

WaypointType

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

LatLng

從上一個路標到目前路標的路徑。清單中的第一個路線點為未定義。只有在使用者提出要求時，系統才會填入這個欄位。

string

從上一個路標到目前路標的經過編碼的路徑。

注意：此欄位僅供 Driver SDK 和 Consumer SDK 使用。尚未支援解碼。

ConsumableTrafficPolyline

前往此路線的路況。請注意，只有 Google 地圖平台的叫車和外送解決方案客戶才能使用交通資訊。

Int32Value

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

Timestamp

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

Duration

從上一個路標到這個點的車程時間。清單中的第一個路線點為未定義。

RequestHeader

標準 Fleet Engine 要求標頭。

string

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

Trip

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

下列欄位由車隊引擎維護。請勿使用 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 中傳回這份清單，列出指派給車輛的所有有效行程。

注意：這個欄位僅供 Driver SDK 使用。尚未支援解碼。

TrafficPolylineData

僅限輸入。Fleet Engine 會利用這些資訊改善行程分享功能。注意：這個欄位僅供 Driver 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

請求的車輛比對排序順序。等同於 ordered_by。

VehicleMatchOrder

請求的車輛比對排序順序。等同於 requested_ordered_by。

RoadStretch

選用設定。應沿著折線算繪的道路路段。系統會保證不重疊區塊，但不一定會跨越整個路線。

如果沒有要設定樣式的路段，用戶端應為路線套用預設值。

Style

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

int32

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

int32

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

LatLng

此航點的位置。

Timestamp

車輛預計抵達這個路標的時間。