本頁面由 Cloud Translation API 翻譯而成。

Switch to English

Package google.maps.routing.v2

索引

Routes (介面)
ComputeRouteMatrixRequest (訊息)
ComputeRouteMatrixRequest.ExtraComputation (列舉)
ComputeRoutesRequest (訊息)
ComputeRoutesRequest.ExtraComputation (列舉)
ComputeRoutesRequest.ReferenceRoute (列舉)
ComputeRoutesResponse (訊息)
FallbackInfo (訊息)
FallbackReason (列舉)
FallbackRoutingMode (列舉)
GeocodedWaypoint (訊息)
GeocodingResults (訊息)
Location (訊息)
Maneuver (列舉)
NavigationInstruction (訊息)
Polyline (訊息)
PolylineEncoding (列舉)
PolylineQuality (列舉)
Route (訊息)
RouteLabel (列舉)
RouteLeg (訊息)
RouteLegStep (訊息)
RouteLegStepTravelAdvisory (訊息)
RouteLegTravelAdvisory (訊息)
RouteMatrixDestination (訊息)
RouteMatrixElement (訊息)
RouteMatrixElementCondition (列舉)
RouteMatrixOrigin (訊息)
RouteModifiers (訊息)
RouteTravelAdvisory (訊息)
RouteTravelMode (列舉)
RoutingPreference (列舉)
SpeedReadingInterval (訊息)
SpeedReadingInterval.Speed (列舉)
TollInfo (訊息)
TollPass (列舉)
Units (列舉)
VehicleEmissionType (列舉)
VehicleInfo (訊息)
Waypoint (訊息)

路徑介面集

Routes API。

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` 擷取出發地和目的地清單，並傳回包含不同起點與目的地組合路線資訊的串流。注意：如要使用這種方法，您必須在輸入內容中指定回應欄位遮罩。您可以使用網址參數 `$fields` 或 `fields`，或使用 HTTP/gRPC 標頭 `X-Goog-FieldMask` (請參閱可用的網址參數和標頭) 來提供回應欄位遮罩。值是以逗號分隔的欄位路徑清單。請參閱這份詳細說明文件，瞭解如何建構欄位路徑。例如，透過此方法：所有可用欄位的欄位遮罩 (手動檢查)：`X-Goog-FieldMask: ` 路線持續時間、距離、元素狀態、狀況和元素索引 (適用於生產環境範例) 的欄位遮罩：`X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` 請務必在欄位遮罩中加入 `status`，否則所有訊息都會正常顯示。Google 不建議使用萬用字元 (``) 回應欄位遮罩，原因如下：我們的伺服器只可以選取您所需的欄位，藉此協助計算運算週期，並縮短您的延遲時間，並將結果傳回給您。只選擇在實際工作環境工作中需要的欄位，可確保穩定延遲效能。我們日後可能會新增更多回應欄位，而這些新欄位可能需要額外的運算時間。如果您選取所有欄位，或是在頂層選取所有欄位，成效可能會降低，因為系統新增的所有回應會自動加入回應中。請僅選取你需要的欄位，這樣可產生較低的回應大小，進而提高網路處理量。

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

擷取出發地和目的地清單，並傳回包含不同起點與目的地組合路線資訊的串流。

注意：如要使用這種方法，您必須在輸入內容中指定回應欄位遮罩。您可以使用網址參數 $fields 或 fields，或使用 HTTP/gRPC 標頭 X-Goog-FieldMask (請參閱可用的網址參數和標頭) 來提供回應欄位遮罩。值是以逗號分隔的欄位路徑清單。請參閱這份詳細說明文件，瞭解如何建構欄位路徑。

例如，透過此方法：

所有可用欄位的欄位遮罩 (手動檢查)：X-Goog-FieldMask: *
路線持續時間、距離、元素狀態、狀況和元素索引 (適用於生產環境範例) 的欄位遮罩：X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

請務必在欄位遮罩中加入 status，否則所有訊息都會正常顯示。Google 不建議使用萬用字元 (*) 回應欄位遮罩，原因如下：

我們的伺服器只可以選取您所需的欄位，藉此協助計算運算週期，並縮短您的延遲時間，並將結果傳回給您。
只選擇在實際工作環境工作中需要的欄位，可確保穩定延遲效能。我們日後可能會新增更多回應欄位，而這些新欄位可能需要額外的運算時間。如果您選取所有欄位，或是在頂層選取所有欄位，成效可能會降低，因為系統新增的所有回應會自動加入回應中。
請僅選取你需要的欄位，這樣可產生較低的回應大小，進而提高網路處理量。

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` 根據一組終端機和中繼路線控點，傳回主要路徑和選擇性的替代路線。注意：如要使用這種方法，您必須在輸入內容中指定回應欄位遮罩。您可以使用網址參數 `$fields` 或 `fields`，或使用 HTTP/gRPC 標頭 `X-Goog-FieldMask` (請參閱可用的網址參數和標頭) 來提供回應欄位遮罩。值是以逗號分隔的欄位路徑清單。請參閱如何建立欄位路徑的詳細說明文件。例如，透過此方法：所有可用欄位的欄位遮罩 (手動檢查)：`X-Goog-FieldMask: ` 路徑層級時間長度、距離和折線的欄位遮罩 (實際工作環境設定範例)：`X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google 不建議使用萬用字元 (``) 回應欄位遮罩，或是在頂層 (`routes`) 中指定欄位遮罩，原因如下：我們的伺服器只可以選取您所需的欄位，藉此協助計算運算週期，並縮短您的延遲時間，並將結果傳回給您。只選擇在實際工作環境工作中需要的欄位，可確保穩定延遲效能。我們日後可能會新增更多回應欄位，而這些新欄位可能需要額外的運算時間。如果您選取所有欄位，或是在頂層選取所有欄位，成效可能會降低，因為系統新增的所有回應會自動加入回應中。請僅選取你需要的欄位，這樣可產生較低的回應大小，進而提高網路處理量。

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

根據一組終端機和中繼路線控點，傳回主要路徑和選擇性的替代路線。

注意：如要使用這種方法，您必須在輸入內容中指定回應欄位遮罩。您可以使用網址參數 $fields 或 fields，或使用 HTTP/gRPC 標頭 X-Goog-FieldMask (請參閱可用的網址參數和標頭) 來提供回應欄位遮罩。值是以逗號分隔的欄位路徑清單。請參閱如何建立欄位路徑的詳細說明文件。

例如，透過此方法：

所有可用欄位的欄位遮罩 (手動檢查)：X-Goog-FieldMask: *
路徑層級時間長度、距離和折線的欄位遮罩 (實際工作環境設定範例)：X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google 不建議使用萬用字元 (*) 回應欄位遮罩，或是在頂層 (routes) 中指定欄位遮罩，原因如下：

我們的伺服器只可以選取您所需的欄位，藉此協助計算運算週期，並縮短您的延遲時間，並將結果傳回給您。
只選擇在實際工作環境工作中需要的欄位，可確保穩定延遲效能。我們日後可能會新增更多回應欄位，而這些新欄位可能需要額外的運算時間。如果您選取所有欄位，或是在頂層選取所有欄位，成效可能會降低，因為系統新增的所有回應會自動加入回應中。
請僅選取你需要的欄位，這樣可產生較低的回應大小，進而提高網路處理量。

ComputeRouteMatrixRequest

ComputeRouteMatrix 要求訊息

欄位
`origins[]`	`RouteMatrixOrigin` 必要欄位。來源陣列，用於決定回應矩陣的資料列。來源和目的地的基數有幾項大小限制：在任何情況下，元素 (來源 × 目的地) 的數量不得大於 625。如果 Routing_preference 設為 `TRAFFIC_AWARE_OPTIMAL`，則元素數量 (來源 × 目的地) 不得大於 100。指定為 `place_id` 的路線控點 (出發地 + 目的地) 數量不得超過 50。
`destinations[]`	`RouteMatrixDestination` 必要欄位。目的地陣列，用於決定回應矩陣的資料欄。
`travel_mode`	`RouteTravelMode` 選填欄位，指定交通方式。
`routing_preference`	`RoutingPreference` 選填欄位，指定如何計算路徑。伺服器會嘗試使用所選的轉送偏好設定來計算路徑。如果轉送偏好設定導致錯誤或較長的延遲時間，則會傳回錯誤。只有在 `travel_mode` 為 `DRIVE` 或 `TWO_WHEELER` 時，才可指定這個選項，否則要求將會失敗。
`departure_time`	`Timestamp` 選填欄位，出發時間。如未設定這個值，預設值為您提出要求的時間。如果將這個值設定為已經發生的時間，請求就會失敗。
`language_code`	`string` 選填欄位，BCP-47 語言代碼，例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如需支援的語言清單，請參閱語言支援。如未提供這個值，系統將根據第一個來源的位置推測顯示語言。
`region_code`	`string` 選填欄位，以 ccTLD (「頂層網域」) 為兩個字元的值來指定區域代碼。詳情請參閱 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
`extra_computations[]`	`ExtraComputation` 選填欄位，可用於完成要求的額外運算清單。注意：這些額外運算可能會在回應中傳回額外的欄位。您必須在欄位遮罩中指定這些額外欄位，以在回應中傳回。

額外計算

在完成要求時執行的額外運算。

列舉
`EXTRA_COMPUTATION_UNSPECIFIED`	未使用。包含此值的要求會失敗。
`TOLLS`	矩陣元素的收費路段資訊。

ComputeRoutes 要求

ComputeRoutes 要求訊息。

欄位
`origin`	`Waypoint` 必要欄位。起點路線控點。
`destination`	`Waypoint` 必要欄位。目的地路線控點。
`intermediates[]`	`Waypoint` 選填欄位，沿途的一組路線控點 (不含終點點)，用於停靠或通過。最多可支援 25 個中繼路線控點。
`travel_mode`	`RouteTravelMode` 選填欄位，指定交通方式。
`routing_preference`	`RoutingPreference` 選填欄位，指定如何計算路徑。伺服器會嘗試使用所選的轉送偏好設定來計算路徑。如果轉送偏好設定導致錯誤或較長的延遲時間，則會傳回錯誤。只有在 `travel_mode` 為 `DRIVE` 或 `TWO_WHEELER` 時，才可指定這個選項，否則要求將會失敗。
`polyline_quality`	`PolylineQuality` 選填欄位，指定您對折線的偏好設定。
`polyline_encoding`	`PolylineEncoding` 選填欄位，指定折線的編碼方式。
`departure_time`	`Timestamp` 選填欄位，出發時間。如未設定這個值，則預設值為您提出要求的時間。如果您將這個值設為已經發生的時間，請求就會失敗。
`compute_alternative_routes`	`bool` 選填欄位，指定除了路線之外，是否要計算替代路徑。但不會傳回含有中繼路線控點的替代路徑。
`route_modifiers`	`RouteModifiers` 選填欄位，一組可滿足路徑計算方式的條件。
`language_code`	`string` 選填欄位，BCP-47 語言代碼，例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如需支援的語言清單，請參閱語言支援。如未提供這個值，系統則會根據路線要求的位置推測顯示語言。
`region_code`	`string` 選填欄位，以 ccTLD (「頂層網域」) 為兩個字元的值來指定區域代碼。詳情請參閱 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
`units`	`Units` 選填欄位，指定顯示欄位的測量單位。這包括 `NavigationInstruction` 中的 `instruction` 欄位。路徑、腿部、步距和時間長度的測量單位不受這個值影響。如未提供這個值，系統則會從要求位置推測顯示單元。
`requested_reference_routes[]`	`ReferenceRoute` 選填欄位，除了預設的預設路徑外，也需指定在要求中計算的參考路徑。參考路徑是指與預設路線不同的路線計算目標。舉例來說，FUEL_EFFICIENT 參照路徑計算的計算方式會考量多種參數，以便找出最佳的燃油效率。
`extra_computations[]`	`ExtraComputation` 選填欄位，可用於完成要求的額外運算清單。注意：這些額外運算可能會在回應中傳回額外的欄位。您必須在欄位遮罩中指定這些額外欄位，以在回應中傳回。

額外計算

在完成要求時執行的額外運算。

列舉
`EXTRA_COMPUTATION_UNSPECIFIED`	未使用。包含此值的要求會失敗。
`TOLLS`	路線收費資訊。
`FUEL_CONSUMPTION`	路線的預估油耗量。
`TRAFFIC_ON_POLYLINE`	路線的交通號誌折線。

參考路徑

ComputeRoutesRequest 支援的參考路徑。

列舉
`REFERENCE_ROUTE_UNSPECIFIED`	未使用。包含此值的要求會失敗。
`FUEL_EFFICIENT`	省油路線。系統會判斷已加上這個路徑的路徑，以根據油耗等參數進行最佳化。

ComputeRoutes 回應

ComputeRoutes 會回應回應訊息。

欄位

欄位
`routes[]`	`Route` 在您指定 compute_alternatives_routes 時，包含一組計算路徑 (最多三條)，不指定則只包含一個路徑。當這個陣列包含多個項目時，第一個項目是最建議的路徑。如果陣列是空的，表示找不到任何路線。
`fallback_info`	`FallbackInfo` 在某些情況下，如果伺服器無法根據所有輸入偏好設定計算路線結果，則會改用不同的運算方式。使用備用模式時，這個欄位會包含備用回應的詳細資訊。否則系統會取消設定這個欄位。
`geocoding_results`	`GeocodingResults` 包含指定為地址的路線控點的地理編碼回應資訊。

routes[]

Route

在您指定 compute_alternatives_routes 時，包含一組計算路徑 (最多三條)，不指定則只包含一個路徑。當這個陣列包含多個項目時，第一個項目是最建議的路徑。如果陣列是空的，表示找不到任何路線。

fallback_info

FallbackInfo

在某些情況下，如果伺服器無法根據所有輸入偏好設定計算路線結果，則會改用不同的運算方式。使用備用模式時，這個欄位會包含備用回應的詳細資訊。否則系統會取消設定這個欄位。

geocoding_results

GeocodingResults

包含指定為地址的路線控點的地理編碼回應資訊。

備用資訊

使用備用結果的方式和原因相關資訊。如果設定了這個欄位，則代表伺服器使用偏好的轉送模式做為備用模式。

欄位

欄位
`routing_mode`	`FallbackRoutingMode` 用於回應的轉送模式。如果已觸發備用廣告，該模式可能與原始用戶端要求中設定的轉送偏好設定不同。
`reason`	`FallbackReason` 使用備用回應取代原始回應的原因。只有在觸發備用模式並傳回備用回應時，系統才會填入這個欄位。

routing_mode

FallbackRoutingMode

用於回應的轉送模式。如果已觸發備用廣告，該模式可能與原始用戶端要求中設定的轉送偏好設定不同。

reason

FallbackReason

使用備用回應取代原始回應的原因。只有在觸發備用模式並傳回備用回應時，系統才會填入這個欄位。

備用原因

使用備用回應的原因。

列舉
`FALLBACK_REASON_UNSPECIFIED`	未指定備用原因。
`SERVER_ERROR`	使用您偏好的轉送模式計算路徑時發生伺服器錯誤，但我們能夠傳回透過替代模式計算的結果。
`LATENCY_EXCEEDED`	我們無法按您偏好的路線模式完成計算，但我們無法傳回以替代模式計算的結果。

備用轉送模式

用於傳回備用回應的實際轉送模式。

列舉
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	未使用。
`FALLBACK_TRAFFIC_UNAWARE`	表示系統使用「TRAFFIC_UNAWARE」轉送模式來計算回應。
`FALLBACK_TRAFFIC_AWARE`	表示系統使用「TRAFFIC_AWARE」轉送模式來計算回應。

GPS 編碼方式

用來當做路線控點的位置詳細資料。僅填入地址路線控點。包含地理編碼結果的詳細資料，可用於判斷地址的地理編碼。

欄位
`geocoder_status`	`Status` 指出地理編碼作業產生的狀態碼。
`type[]`	`string` 結果的類型，以零或多個類型標記的形式表示。支援的類型：https://developers.google.com/maps/documentation/syndication/requests-Composite#Types
`partial_match`	`bool` 表示地理編碼器能傳回要求部分部分，但原始要求卻無法傳回原始要求。建議您比對原始要求，檢查是否有拼寫錯誤和/或不完整的地址。
`place_id`	`string` 這個結果的地點 ID。
`intermediate_waypoint_request_index`	`int32` 要求中對應的中繼路線索引。只有在對應的路線控點為中繼路線控點時，才會填入資料。

地理編碼結果

包含起點、目的地和中繼路線控點的 GeocodedWaypoint。僅填入地址路線控點。

欄位

欄位
`origin`	`GeocodedWaypoint` 來源地理編碼路線控點。
`destination`	`GeocodedWaypoint` 目的地地理編碼路線點。
`intermediates[]`	`GeocodedWaypoint` 中間點地理編碼路線清單，每個索引點都有一個索引欄位，且該欄位會對應至路線點的 0 定位點 (依要求中指定的順序)。

origin

GeocodedWaypoint

來源地理編碼路線控點。

destination

GeocodedWaypoint

目的地地理編碼路線點。

intermediates[]

GeocodedWaypoint

中間點地理編碼路線清單，每個索引點都有一個索引欄位，且該欄位會對應至路線點的 0 定位點 (依要求中指定的順序)。

位置

封裝地點 (地理位置和選用的標題)。

欄位

欄位
`lat_lng`	`LatLng` 路線控點的地理座標。
`heading`	`Int32Value` 與流量方向相關聯的指南針方向。這個值用於指定道路的上車處和下車地點。標題值可以介於 0 到 360 之間，其中 0 可指定標題的「北方」標題，90 則是指定到期東方等標題。這個欄位只能用於 `DRIVE` 和 `TWO_WHEELER` 交通方式。

lat_lng

LatLng

路線控點的地理座標。

heading

Int32Value

與流量方向相關聯的指南針方向。這個值用於指定道路的上車處和下車地點。標題值可以介於 0 到 360 之間，其中 0 可指定標題的「北方」標題，90 則是指定到期東方等標題。這個欄位只能用於 DRIVE 和 TWO_WHEELER 交通方式。

駕駛人

一組值，用來指定目前步驟要完成的導覽動作 (例如向左、合併、直接等等)。

列舉
`MANEUVER_UNSPECIFIED`	未使用。
`TURN_SLIGHT_LEFT`	稍微向左轉。
`TURN_SHARP_LEFT`	向左大幅轉彎。
`UTURN_LEFT`	請左轉。
`TURN_LEFT`	向左轉。
`TURN_SLIGHT_RIGHT`	稍微向右轉。
`TURN_SHARP_RIGHT`	向右向右轉。
`UTURN_RIGHT`	右轉。
`TURN_RIGHT`	請向右轉。
`STRAIGHT`	直走。
`RAMP_LEFT`	靠左坡道行駛。
`RAMP_RIGHT`	靠右坡道。
`MERGE`	合併為流量。
`FORK_LEFT`	使用左分支。
`FORK_RIGHT`	使用叉子。
`FERRY`	搭渡輪。
`FERRY_TRAIN`	搭火車搭渡輪。
`ROUNDABOUT_LEFT`	在圓環處左轉。
`ROUNDABOUT_RIGHT`	在圓環處向右轉。

導航教學

封裝 RouteLegStep 的導覽操作說明

欄位

maneuver

Maneuver

封裝目前步驟的導覽操作說明，例如向左、合併、直線等。這個欄位會決定要顯示的圖示。

instructions

string

瀏覽這個步驟的操作說明。

Polyline

封裝編碼折線。

欄位

欄位
聯集欄位 `polyline_type`。封裝折線的類型。預設值為 encoded_polyline。`polyline_type` 只能是下列其中一項：
`encoded_polyline`	`string` 使用折線編碼演算法為折線的字串編碼
`geo_json_linestring`	`Struct` 使用 GeoJSON LineString 格式指定折線

聯集欄位 polyline_type。封裝折線的類型。預設值為 encoded_polyline。polyline_type 只能是下列其中一項：

encoded_polyline

string

使用折線編碼演算法為折線的字串編碼

geo_json_linestring

Struct

使用 GeoJSON LineString 格式指定折線

折線編碼

指定要傳回的折線類型。

列舉
`POLYLINE_ENCODING_UNSPECIFIED`	未指定折線類型偏好設定。預設值為 `ENCODED_POLYLINE`。
`ENCODED_POLYLINE`	指定使用折線編碼演算法編碼的折線。
`GEO_JSON_LINESTRING`	使用 GeoJSON LineString 格式指定折線

折線品質

指定折線品質的一組值。

列舉
`POLYLINE_QUALITY_UNSPECIFIED`	未指定折線品質偏好設定。預設值為 `OVERVIEW`。
`HIGH_QUALITY`	指定高品質折線，這類片段是由 `OVERVIEW` 以外的點所組成，但會增加回應的大小。當您需要更精準的數值時，請使用這個值。
`OVERVIEW`	指定總覽折線 - 由少量點組成。顯示路徑總覽時，請使用這個值。相較於使用 `HIGH_QUALITY` 選項，使用這個選項的延遲時間較少。

路線

封裝路徑，由一系列連接的航段組成，可分為起點、終點和中間點。

欄位
`route_labels[]`	`RouteLabel` `Route` 的標籤，可用於識別路線的特定屬性，以與其他屬性進行比較。
`legs[]`	`RouteLeg` 構成路線的一組腿 (路線點之間的路徑區隔)。每條腿都對應至兩個非 `via` 路線控點之間的行程。例如，沒有中間路線的航線只有一個路段。包含一個非 `via` 中繼路線控點的路徑有兩條腿。包含一個 `via` 中繼路線控點的航路只有一個路段。路段的順序會依照 Waypoint 的順序，從 `origin` 到 `intermediates` 到 `destination`。
`distance_meters`	`int32` 路線的移動距離，單位為公尺。
`duration`	`Duration` 導航所需的所需時間。如果將 `routing_preference` 設為 `TRAFFIC_UNAWARE`，則此值會與 `static_duration` 相同。如果將 `routing_preference` 設為 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL`，則系統會考量流量條件來計算這個值。
`static_duration`	`Duration` 沿著路線進行行駛的時間長度，但不考慮路況。
`polyline`	`Polyline` 整體路線折線。這個折線將是所有 `legs` 的綜合折線。
`description`	`string` 路線說明。
`warnings[]`	`string` 顯示路徑時顯示的警告陣列。
`viewport`	`Viewport` 折線的可視區域定界框。
`travel_advisory`	`RouteTravelAdvisory` 有關路線的其他資訊。
`route_token`	`string` 可傳遞至 NavigationSDK 的網路安全 Base64 編碼路徑權杖，讓 Navigation SDK 可在導航期間重建路徑，且會在呼叫路徑 ComputeRoutes 時重新轉送原始意圖。客戶應將這個權杖視為不透明的 blob。注意：`Route.route_token` 僅適用於將 `ComputeRoutesRequest.routing_preference` 設為 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL` 的要求。`Route.route_token` 也不支援包含 Via 路線控點的要求。

路徑標籤

Route 的標籤，可用於識別路線的特定屬性，以與其他屬性進行比較。

列舉
`ROUTE_LABEL_UNSPECIFIED`	預設 - 未使用。
`DEFAULT_ROUTE`	路徑計算傳回的預設「最佳」路線。
`DEFAULT_ROUTE_ALTERNATE`	這是預設「最佳」路線的替代方案。如果指定了 `ComputeRoutesRequest.compute_alternative_routes`，系統將傳回這類路徑。
`FUEL_EFFICIENT`	省油路線。包含此值的路徑已確定根據 Eco 參數 (如油耗) 最佳化。

路線

封裝非 via 路線控點之間的區隔。

欄位
`distance_meters`	`int32` 路線腿的移動距離，單位為公尺。
`duration`	`Duration` 導航腿所需的時間長度。如果 `route_preference` 設為 `TRAFFIC_UNAWARE`，則這個值會與 `static_duration` 相同。如果 `route_preference` 為 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL`，則計算這個值時會考量路況。
`static_duration`	`Duration` 穿越腿部的所需時間，計算時不會考量路況。
`polyline`	`Polyline` 這條腿的整體折線。這包括每個 `step` 的折線。
`start_location`	`Location` 這條腿的起點。這可能與提供的 `origin` 不同。舉例來說，如果提供的 `origin` 不在道路上，這便是道路上的一個點。
`end_location`	`Location` 這個腿的終點位置。這可能與提供的 `destination` 不同。舉例來說，如果提供的 `destination` 不在道路上，這便是道路上的一個點。
`steps[]`	`RouteLegStep` 表示這個腿中段的一系列步驟。每個步驟都代表一個瀏覽操作說明。
`travel_advisory`	`RouteLegTravelAdvisory` 封裝使用者應瞭解的其他資訊，例如可能的交通路線限制等交通路線限制。

路線圖例

封裝 RouteLeg 的區隔。步驟對應單一導覽指示。路線腿由多個步驟組成。

欄位
`distance_meters`	`int32` 這個步驟的移動距離，單位為公尺。在某些情況下，這個欄位可能沒有值。
`static_duration`	`Duration` 完成這個步驟後，系統不會將流量狀況納入考量。在某些情況下，這個欄位可能沒有值。
`polyline`	`Polyline` 與這個步驟相關聯的折線。
`start_location`	`Location` 這個步驟的起點。
`end_location`	`Location` 這個步驟的終點位置。
`navigation_instruction`	`NavigationInstruction` 導航操作說明。
`travel_advisory`	`RouteLegStepTravelAdvisory` 封裝使用者應瞭解的額外資訊，例如腿部可能的交通區域限制。

航行步行旅程顧問

封裝使用者應瞭解的額外資訊，例如腿部可能的交通區域限制。

欄位

欄位
`speed_reading_intervals[]`	`SpeedReadingInterval` 注意：這個欄位目前未填入資料。

speed_reading_intervals[]

SpeedReadingInterval

注意：這個欄位目前未填入資料。

航線旅遊顧問

封裝使用者應瞭解的其他資訊，例如可能的交通路線限制等交通路線限制。

欄位

欄位
`toll_info`	`TollInfo` 封裝特定 RouteLeg 上的收費路段相關資訊。只有在我們預期 RouteLeg 上有收費路段時，才會填入這個欄位。如果設定這個欄位，但系統卻未填寫推測的 _price 欄位，我們預期道路會包含收費路段，但不知道預估價格。如果這個欄位不存在，則 RouteLeg 不會支付任何費用。
`speed_reading_intervals[]`	`SpeedReadingInterval` 讀取流量密度的讀取間隔。適用於 `TRAFFIC_AWARE` 和 `TRAFFIC_AWARE_OPTIMAL` 轉送偏好設定。間隔涵蓋 RouteLg 的整個折線，且沒有重疊。指定間隔的起點與前一個間隔的終點相同。例子： `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

封裝特定 RouteLeg 上的收費路段相關資訊。只有在我們預期 RouteLeg 上有收費路段時，才會填入這個欄位。如果設定這個欄位，但系統卻未填寫推測的 _price 欄位，我們預期道路會包含收費路段，但不知道預估價格。如果這個欄位不存在，則 RouteLeg 不會支付任何費用。

speed_reading_intervals[]

SpeedReadingInterval

讀取流量密度的讀取間隔。適用於 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 轉送偏好設定。間隔涵蓋 RouteLg 的整個折線，且沒有重疊。指定間隔的起點與前一個間隔的終點相同。

例子：

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

路徑馬德里

ComputeRouteMatrixRequest 的單一目的地

欄位

欄位
`waypoint`	`Waypoint` 必要欄位。目的地路線控點

waypoint

Waypoint

必要欄位。目的地路線控點

RouteMatrix 元素

封裝在 ComputeRouteMatrix API 中為起點/目的地組合計算的路線資訊。這個 proto 可以串流至用戶端。

欄位
`status`	`Status` 這個元素的錯誤狀態碼。
`condition`	`RouteMatrixElementCondition` 指出系統是否找到該路徑。不受狀態影響。
`distance_meters`	`int32` 路線的移動距離，單位為公尺。
`duration`	`Duration` 導航所需的所需時間。如果將 `routing_preference` 設為 `TRAFFIC_UNAWARE`，則此值會與 `static_duration` 相同。如果將 `routing_preference` 設為 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL`，則系統會考量流量條件來計算這個值。
`static_duration`	`Duration` 沿著路線進行行駛的時間長度，但不考慮路況。
`travel_advisory`	`RouteTravelAdvisory` 有關路線的其他資訊。例如：限制資訊及收費路段資訊
`fallback_info`	`FallbackInfo` 在某些情況下，如果伺服器無法依照該特定來源/目的地組合的指定偏好設定計算路徑，可能會改用不同的計算模式。使用備用模式時，這個欄位會包含備用回應的詳細資訊。否則系統會取消設定這個欄位。
`origin_index`	`int32` 要求中來源的零索引索引。
`destination_index`	`int32` 要求中的目的地為零的索引。

RouteMatrixElementCondition

所傳迴路線的條件。

列舉
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	只有在元素的 `status` 不正常時才會使用。
`ROUTE_EXISTS`	已找到路徑，且該元素已填入對應的資訊。
`ROUTE_NOT_FOUND`	找不到路線。系統不會在元素中填入路線資訊的欄位，例如 `distance_meters` 或 `duration`。

路徑矩陣

ComputeRouteMatrixRequest 的單一來源

欄位

欄位
`waypoint`	`Waypoint` 必要欄位。起點路線控點
`route_modifiers`	`RouteModifiers` 選填欄位，所有以此做為起點的來源路徑的修飾符

waypoint

Waypoint

必要欄位。起點路線控點

route_modifiers

RouteModifiers

選填欄位，所有以此做為起點的來源路徑的修飾符

RouteModifier

封裝一組在選用路徑時可滿足的選用條件。

欄位
`avoid_tolls`	`bool` 指定是否要避開合理道路。系統會優先考量不含收費路段的路線。僅適用於 `DRIVE` 和 `TWO_WHEELER` 交通方式。
`avoid_highways`	`bool` 指定是否要在合理情況下避開高速公路。系統會優先考量不含高速公路的路線。僅適用於 `DRIVE` 和 `TWO_WHEELER` 交通方式。
`avoid_ferries`	`bool` 指定是否要在合理情況下避開渡輪。如果路線沒有搭渡輪，目的地將會優先顯示。這項設定僅適用於 `DRIVE` 和 `TWO_WHEELER` 交通方式。
`avoid_indoor`	`bool` 指定是否要在合理情況下避免在室內導航。系統會參照不含室內導航的路線。僅適用於 `WALK` 交通方式。
`vehicle_info`	`VehicleInfo` 指定車輛資訊。
`toll_passes[]`	`TollPass` 封裝收費通行證相關資訊。如果提供收費通行證，API 會嘗試傳回票證價格。如未提供收費通行證，API 會將收費通行證視為未知，並嘗試傳回現金價格。僅適用於 DRIVE 和 TWO_WHEELER 交通方式。

航線旅遊顧問

封裝使用者應瞭解的額外資訊，例如可能的流量限制等。

欄位

欄位
`toll_info`	`TollInfo` 封裝路線上的收費路段相關資訊。只有在預期路線會經過收費時，這個欄位才會填入資料。如果設定這個欄位，但系統卻未填寫推測的 _price 欄位，我們預期道路會包含收費路段，但不知道預估價格。如未設定這個欄位，我們預期路線不會有收費路段。
`speed_reading_intervals[]`	`SpeedReadingInterval` 讀取流量密度的讀取間隔。適用於 `TRAFFIC_AWARE` 和 `TRAFFIC_AWARE_OPTIMAL` 轉送偏好設定。間隔會涵蓋路徑的完整折線，且不會重疊。指定間隔的起點與前一個間隔的終點相同。例子： `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`
`fuel_consumption_microliters`	`int64` 燃油消耗預測 (以微升為單位)。

toll_info

TollInfo

封裝路線上的收費路段相關資訊。只有在預期路線會經過收費時，這個欄位才會填入資料。如果設定這個欄位，但系統卻未填寫推測的 _price 欄位，我們預期道路會包含收費路段，但不知道預估價格。如未設定這個欄位，我們預期路線不會有收費路段。

speed_reading_intervals[]

SpeedReadingInterval

讀取流量密度的讀取間隔。適用於 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 轉送偏好設定。間隔會涵蓋路徑的完整折線，且不會重疊。指定間隔的起點與前一個間隔的終點相同。

例子：

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

fuel_consumption_microliters

int64

燃油消耗預測 (以微升為單位)。

路線交通方式

用於指定交通方式的一組值。注意：WALK、BICYCLE 和 TWO_WHEELER 路線目前仍為 Beta 版，有時可能遺漏明確的人行道、人行道或單車道。您必須針對應用程式中顯示的所有步行、單車和機車路線，顯示這則警告。

列舉
`TRAVEL_MODE_UNSPECIFIED`	未指定交通方式。預設值為 `DRIVE`。
`DRIVE`	乘客乘車。
`BICYCLE`	騎自行車。
`WALK`	步行即可旅行。
`TWO_WHEELER`	機動車輛例如：機車。請注意，這與涵蓋人用模式的 `BICYCLE` 交通方式不同。

轉送偏好設定

一組值，用來指定計算路線時要考量的因素。

列舉
`ROUTING_PREFERENCE_UNSPECIFIED`	未指定轉送偏好設定。預設為 `TRAFFIC_UNAWARE`。
`TRAFFIC_UNAWARE`	在不考慮即時路況的情況下計算路徑。適合在路況不相關或不適用的情況下適用。使用這個值會產生延遲時間最短。注意：在 `RouteTravelMode` DRIVE 和 TWO_WHEELER 中，路線的所需時間和所需時間取決於道路網路以及平均與路線無關的路況。由於道路網路的異動、平均路況更新以及服務的分散式特性，特定要求的結果可能會隨時間而改變。此外，搜尋結果也會顯示在最接近相等範圍的路徑，而且不限頻率。
`TRAFFIC_AWARE`	計算將即時路況納入考量的路徑。相較於 `TRAFFIC_AWARE_OPTIMAL`，某些最佳化設定會大幅縮短延遲時間。
`TRAFFIC_AWARE_OPTIMAL`	計算採取即時路況的條件時，並未套用大部分的效能最佳化。使用這個值會產生最大延遲。

速度讀取間隔

折線或路徑的相鄰區隔的流量密度指標。假設路徑路徑為 P_0、P_1、...、P_N (以零為基準)，因此 SpeedReadingInterval 定義了間隔，並使用下列類別描述其流量。

欄位
`start_polyline_point_index`	`int32` 此間隔的折線在折線中的起始索引。
`end_polyline_point_index`	`int32` 此間隔的折線在折線中的結束索引。
聯集欄位 `speed_type`。 `speed_type` 只能是下列其中一個值：
`speed`	`Speed` 這段期間內的車流速度。

速度

根據車流量資料區分的折線速度分類。

列舉
`SPEED_UNSPECIFIED`	預設值。未使用這個值。
`NORMAL`	正常速度，未偵測到車速變慢。
`SLOW`	偵測到車多擁擠情形，但目前沒有任何交通壅塞。
`TRAFFIC_JAM`	偵測到交通壅塞。

收費資訊

封裝 Route 或 RouteLeg 的收費路段資訊。

欄位

欄位
`estimated_price[]`	`Money` 相應路線或路由的收費金額。這份清單會針對預計由收費所收取的每個幣別設定金額，一般來說，這份清單只會列出使用相同幣別的收費路段。在國際旅行中，此清單可能包含多個項目，以反映不同貨幣的收費。

estimated_price[]

Money

相應路線或路由的收費金額。這份清單會針對預計由收費所收取的每個幣別設定金額，一般來說，這份清單只會列出使用相同幣別的收費路段。在國際旅行中，此清單可能包含多個項目，以反映不同貨幣的收費。

收費通行證

我們支援世界各地通行費的通行證清單。

列舉
`TOLL_PASS_UNSPECIFIED`	未使用。如果使用此值，則要求將會失敗。
`AU_ETOLL_TAG`	雪梨通行費詳情請前往 https://www.myetoll.com.au。
`AU_EWAY_TAG`	雪梨通行費詳情請參閱 https://www.tollpay.com.au。
`AU_LINKT`	澳洲的收費通行證。詳情請參閱 https://www.linkt.com.au/。
`AR_TELEPASE`	阿根廷通行費。如要瞭解詳情，請前往 https://telepase.com.ar
`BR_AUTO_EXPRESO`	巴西通行費。詳情請參閱 https://www.autoexpreso.com
`BR_CONECTCAR`	巴西通行費。詳情請參閱 https://conectcar.com。
`BR_MOVE_MAIS`	巴西通行費。如要瞭解詳情，請前往 https://movemais.com。
`BR_PASSA_RAPIDO`	巴西通行費。詳情請參閱 https://pasorapido.gob.do/
`BR_SEM_PARAR`	巴西通行費。詳情請參閱 https://www.semparar.com.br。
`BR_TAGGY`	巴西通行費。詳情請參閱 https://taggy.com.br。
`BR_VELOE`	巴西通行費。詳情請參閱 https://veloe.com.br/site/onde-usar。
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	加拿大到美國邊境跨境。
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	加拿大到美國邊境跨境。
`CA_US_BLUE_WATER_EDGE_PASS`	加拿大安大略省至美國密西根州邊境交界處。
`CA_US_CONNEXION`	加拿大安大略省至美國密西根州邊境交界處。
`CA_US_NEXUS_CARD`	加拿大到美國邊境跨境。
`ID_E_TOLL`	印尼用於支付收費費的多家銀行提供的電子卡。所有由銀行發行的電子卡片費用皆相同，因此只需要一個列舉值。例如 - Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.
`IN_LOCAL_HP_PLATE_EXEMPT`	印度 (HP 州) 免稅。
`MX_IAVE`	墨西哥通行費。https://iave.capufe.gob.mx/#/
`MX_PASE`	墨西哥 https://www.pase.com.mx
`MX_QUICKPASS`	墨西哥 https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	墨西哥
`MX_TAG_TELEVIA`	墨西哥收費通行證公司。墨西哥市的眾多公司之一。詳情請參閱 https://www.televia.com.mx。
`MX_TELEVIA`	墨西哥收費通行證公司。墨西哥市的眾多公司之一。https://www.televia.com.mx
`MX_VIAPASS`	墨西哥通行費。詳情請參閱 https://www.viapass.com.mx/viapass/web_home.aspx。
`US_AL_FREEDOM_PASS`	美國，
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	美國 AK
`US_CA_FASTRAK`	。
`US_CA_FASTRAK_CAV_STICKER`	表示除了 DMV 核發的乾淨空氣車輛 (CAV) 貼圖外，駕駛人還會有 FasTrak 票證。https://www.bayareafastrak.org/en/guide/doIRequireFlex.shtml
`US_CO_EXPRESSTOLL`	美國科羅拉多州
`US_CO_GO_PASS`	美國科羅拉多州
`US_DE_EZPASSDE`	美國。
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	美國佛羅裡達州
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	美國佛羅裡達州
`US_FL_EPASS`	美國佛羅裡達州
`US_FL_GIBA_TOLL_PASS`	美國佛羅裡達州
`US_FL_LEEWAY`	美國佛羅裡達州
`US_FL_SUNPASS`	美國佛羅裡達州
`US_FL_SUNPASS_PRO`	美國佛羅裡達州
`US_IL_EZPASSIL`	美國。
`US_IL_IPASS`	美國。
`US_IN_EZPASSIN`	美國。
`US_KS_BESTPASS_HORIZON`	KS, USA
`US_KS_KTAG`	KS, USA
`US_KS_NATIONALPASS`	KS, USA
`US_KS_PREPASS_ELITEPASS`	KS, USA
`US_KY_RIVERLINK`	KY, USA
`US_LA_GEAUXPASS`	美國洛杉磯。
`US_LA_TOLL_TAG`	美國洛杉磯。
`US_MA_EZPASSMA`	麻薩諸塞州。
`US_MD_EZPASSMD`	美國的馬裡蘭州
`US_ME_EZPASSME`	我來自美國。
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	美國麻薩諸塞州。
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	美國麻薩諸塞州。
`US_MI_IQ_PROX_CARD`	美國麻薩諸塞州。
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	美國麻薩諸塞州。
`US_MI_NEXPRESS_TOLL`	美國麻薩諸塞州。
`US_MN_EZPASSMN`	美國的 MN。
`US_NC_EZPASSNC`	NC。
`US_NC_PEACH_PASS`	NC。
`US_NC_QUICK_PASS`	NC。
`US_NH_EZPASSNH`	美國。
`US_NJ_DOWNBEACH_EXPRESS_PASS`	美國西北部。
`US_NJ_EZPASSNJ`	美國西北部。
`US_NY_EXPRESSPASS`	美國紐約。
`US_NY_EZPASSNY`	美國紐約。
`US_OH_EZPASSOH`	俄亥俄州。
`US_PA_EZPASSPA`	PA。
`US_RI_EZPASSRI`	美國。
`US_SC_PALPASS`	SC。
`US_TX_BANCPASS`	美國。
`US_TX_DEL_RIO_PASS`	美國。
`US_TX_EFAST_PASS`	美國。
`US_TX_EAGLE_PASS_EXPRESS_CARD`	美國。
`US_TX_EPTOLL`	美國。
`US_TX_EZ_CROSS`	美國。
`US_TX_EZTAG`	美國。
`US_TX_LAREDO_TRADE_TAG`	美國。
`US_TX_PLUSPASS`	美國。
`US_TX_TOLLTAG`	美國。
`US_TX_TXTAG`	美國。
`US_TX_XPRESS_CARD`	美國。
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	UT, USA
`US_VA_EZPASSVA`	美國 VA。
`US_WA_BREEZEBY`	美國華盛頓州。
`US_WA_GOOD_TO_GO`	美國華盛頓州。
`US_WV_EZPASSWV`	美國西維吉尼亞州。
`US_WV_MEMORIAL_BRIDGE_TICKETS`	美國西維吉尼亞州。
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	美國西維吉尼亞州。

單位

一組值，用於指定顯示器所使用的測量單位。

列舉
`UNITS_UNSPECIFIED`	未指定度量單位。預設為從要求推估的測量單位。
`METRIC`	度量單位。
`IMPERIAL`	英制 (英制) 度量單位。

交通工具排放類型

一組值，用來說明車輛的排放類型。僅適用於行車模式。

列舉
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	未指定排放類型。預設為 GASOLINE。
`GASOLINE`	汽油/汽油燃料汽油。
`ELECTRIC`	電動車。
`HYBRID`	油耗燃料 (例如汽油 + 電動車)。
`DIESEL`	柴油燃料車。

車輛資訊

封裝車輛資訊，例如車牌最後字元。

欄位

欄位
`emission_type`	`VehicleEmissionType` 說明車輛的排放類型。僅適用於行車模式。

emission_type

VehicleEmissionType

說明車輛的排放類型。僅適用於行車模式。

途經點

封裝路線控點。路線控點會標示路線的起點和終點，並包含沿途的中途停靠站。

欄位
`via`	`bool` 此路線點代表里程碑 (而非停靠點)。針對要求中的每個非直通路線控點，回應會附加一個項目至 `legs` 陣列，以提供該行程該航段的停靠站詳細資料。如果你希望路線通過這個停靠點，請在不中斷的情況下，將這個值設為 true。透過路線控點，系統不會將某個項目新增至 `legs` 陣列，但仍會透過路線控點規劃歷程。此值只能在中間的路線控點上設定。如果您在終端機路線控點上設定這個欄位，要求將會失敗。如果將 `ComputeRoutesRequest.optimize_waypoint_order` 設為 true，則這個欄位不得設為 True，否則將導致要求失敗。
`vehicle_stopover`	`bool` 用於表示車輛在停靠站的出發點，目的是要取下或下車。設定這個值後，計算的路線就不會包含無法上車自取的道路上的非 `via` 路線控點。這個選項僅適用於 `DRIVE` 和 `TWO_WHEELER` 交通方式，且 `location_type` 為 `location` 時。
`side_of_road`	`bool` 用於表示這個路線控點的位置，是偏好的車輛停在道路的某側。設定此值時，路線會通過地點，以便車輛可在道路正中央行駛。這個選項僅適用於「DRIVE」和「TWO_WHEELER」交通方式。
聯集欄位 `location_type`。表示某地點的位置：`location_type` 只能是下列其中一項：
`location`	`Location` 使用地理座標指定的點，包括選用的標題。
`place_id`	`string` 與路線控點相關聯的搜尋點地點 ID。
`address`	`string` 使用者可理解的地址或 Plus Code。詳情請參閱 https://plus.codes。