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

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

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 包含指定為地址的路線控點的地理編碼回應資訊。

備用資訊

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

欄位
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 定位點 (依要求中指定的順序)。

位置

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

欄位
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_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 注意：這個欄位目前未填入資料。

航線旅遊顧問

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

欄位
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 必要欄位。目的地路線控點

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 選填欄位，所有以此做為起點的來源路徑的修飾符

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 燃油消耗預測 (以微升為單位)。

路線交通方式

用於指定交通方式的一組值。注意：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 相應路線或路由的收費金額。這份清單會針對預計由收費所收取的每個幣別設定金額，一般來說，這份清單只會列出使用相同幣別的收費路段。在國際旅行中，此清單可能包含多個項目，以反映不同貨幣的收費。

收費通行證

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

列舉
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 說明車輛的排放類型。僅適用於行車模式。

途經點

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

欄位
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。