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

Package google.maps.routing.v2

索引

Routes (介面)
ComputeRouteMatrixRequest (訊息)
ComputeRouteMatrixRequest.ExtraComputation (列舉)
ComputeRoutesRequest (訊息)
ComputeRoutesRequest.ExtraComputation (列舉)
ComputeRoutesRequest.ReferenceRoute (列舉)
ComputeRoutesResponse (訊息)
FallbackInfo (訊息)
FallbackReason (列舉)
FallbackRoutingMode (列舉)
GeocodedWaypoint (訊息)
GeocodingResults (訊息)
LocalizedTime (訊息)
Location (訊息)
Maneuver (列舉)
NavigationInstruction (訊息)
Polyline (訊息)
PolylineDetails (訊息)
PolylineDetails.FlyoverInfo (訊息)
PolylineDetails.NarrowRoadInfo (訊息)
PolylineDetails.PolylinePointIndex (訊息)
PolylineDetails.RoadFeatureState (列舉)
PolylineEncoding (列舉)
PolylineQuality (列舉)
Route (訊息)
Route.RouteLocalizedValues (訊息)
RouteLabel (列舉)
RouteLeg (訊息)
RouteLeg.RouteLegLocalizedValues (訊息)
RouteLeg.StepsOverview (訊息)
RouteLeg.StepsOverview.MultiModalSegment (訊息)
RouteLegStep (訊息)
RouteLegStep.RouteLegStepLocalizedValues (訊息)
RouteLegStepTransitDetails (訊息)
RouteLegStepTransitDetails.TransitDetailsLocalizedValues (訊息)
RouteLegStepTransitDetails.TransitStopDetails (訊息)
RouteLegStepTravelAdvisory (訊息)
RouteLegTravelAdvisory (訊息)
RouteMatrixDestination (訊息)
RouteMatrixElement (訊息)
RouteMatrixElement.LocalizedValues (訊息)
RouteMatrixElementCondition (列舉)
RouteMatrixOrigin (訊息)
RouteModifiers (訊息)
RouteTravelAdvisory (訊息)
RouteTravelMode (列舉)
RoutingPreference (列舉)
SpeedReadingInterval (訊息)
SpeedReadingInterval.Speed (列舉)
TollInfo (訊息)
TollPass (列舉)
TrafficModel (列舉)
TransitAgency (訊息)
TransitLine (訊息)
TransitPreferences (訊息)
TransitPreferences.TransitRoutingPreference (列舉)
TransitPreferences.TransitTravelMode (列舉)
TransitStop (訊息)
TransitVehicle (訊息)
TransitVehicle.TransitVehicleType (列舉)
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` 必要欄位。來源陣列，用於決定回應矩陣的資料列。來源和目的地的基數有幾項大小限制：指定為 `place_id` 或 `address` 的起點數量和目的地數量總和不得超過 50。在任何情況下，起點數量 × 目的地數量不得大於 625。如果 routing_preference 設為 `TRAFFIC_AWARE_OPTIMAL`，則起點數量 × 目的地數量不得大於 100。如果 travel_mode 設為 `TRANSIT`，起點數量 × 目的地數量不得超過 100。
`destinations[]`	`RouteMatrixDestination` 必要欄位。目的地陣列，決定回應矩陣的資料欄。
`travel_mode`	`RouteTravelMode` (選用步驟) 指定交通方式。
`routing_preference`	`RoutingPreference` (選用步驟) 指定路線的計算方式。伺服器會嘗試使用所選的轉送偏好設定來計算路徑。如果路由偏好設定導致錯誤或延遲時間過長，系統會傳回錯誤。只有在 `travel_mode` 為 `DRIVE` 或 `TWO_WHEELER` 時，才能指定這個選項，否則要求會失敗。
`departure_time`	`Timestamp` (選用步驟) 出發時間。如未設定這個值，系統會預設為您提出要求的時間。注意：只有在 `RouteTravelMode` 設為 `TRANSIT` 時，才能指定過去的 `departure_time`。
`arrival_time`	`Timestamp` (選用步驟) 抵達時間。注意：只有在 `RouteTravelMode` 設為 `TRANSIT` 時，才能設定這項屬性。您可以選擇指定 `departure_time` 或 `arrival_time`，但不能兩者同時指定。
`language_code`	`string` (選用步驟) BCP-47 語言代碼，例如「en-US」或「sr-Latn」。詳情請參閱「Unicode 語言代碼」。如需支援的語言清單，請參閱「語言支援」一文。如未提供這個值，系統會根據第一個來源的位置推斷顯示語言。
`region_code`	`string` (選用步驟) 區碼，指定為 ccTLD (「頂層網域」) 的兩位字元值。詳情請參閱「國家/地區代碼頂層網域」。
`units`	`Units` (選用步驟) 指定顯示欄位的測量單位。
`extra_computations[]`	`ExtraComputation` (選用步驟) 可用於完成要求的額外運算清單。注意：這些額外計算可能會在回應中傳回額外欄位。這些額外欄位也必須在欄位遮罩中指定，才能在回應中傳回。
`traffic_model`	`TrafficModel` (選用步驟) 指定計算交通時間時要採用的假設。這項設定會影響 `RouteMatrixElement` 中「時間長度」欄位傳回的值，其中包含根據歷來平均值預估的交通時間。`TrafficModel` 僅適用於將 `RoutingPreference` 設為 `TRAFFIC_AWARE_OPTIMAL`，並將 `RouteTravelMode` 設為 `DRIVE` 的要求。如果要求提供流量，但未指定 `TrafficModel`，則預設值為 `BEST_GUESS`。
`transit_preferences`	`TransitPreferences` (選用步驟) 指定偏好設定，影響 `TRANSIT` 路線傳回的路線。注意：只有在 `RouteTravelMode` 設為 `TRANSIT` 時，才能指定 `transit_preferences`。

ExtraComputation

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

列舉
`EXTRA_COMPUTATION_UNSPECIFIED`	未使用。含有這個值的要求會失敗。
`TOLLS`	矩陣元素適用的收費資訊。

ComputeRoutesRequest

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` (選用步驟) 出發時間。如未設定這個值，系統會預設為您提出要求的時間。注意：只有在 `RouteTravelMode` 設為 `TRANSIT` 時，才能指定過去的 `departure_time`。大眾運輸行程最多可查詢過去 7 天或未來 100 天的行程。
`arrival_time`	`Timestamp` (選用步驟) 抵達時間。注意：如果要求指定的 `RouteTravelMode` 不是 `TRANSIT`，系統會忽略這個欄位。你可以指定 `departure_time` 或 `arrival_time`，但不能同時指定兩者。大眾運輸行程最多可查詢過去 7 天或未來 100 天的行程。
`compute_alternative_routes`	`bool` (選用步驟) 指定是否要計算替代路線。如果要求含有中繼路線控點，系統不會傳回替代路線。
`route_modifiers`	`RouteModifiers` (選用步驟) 一組必須滿足的條件，會影響路徑的計算方式。
`language_code`	`string` (選用步驟) BCP-47 語言代碼，例如「en-US」或「sr-Latn」。詳情請參閱「Unicode 語言代碼」。如需支援的語言清單，請參閱「語言支援」一文。如果未提供這個值，系統會根據路線要求的地點推斷顯示語言。
`region_code`	`string` (選用步驟) 區碼，指定為 ccTLD (「頂層網域」) 的兩位字元值。詳情請參閱「國家/地區代碼頂層網域」。
`units`	`Units` (選用步驟) 指定顯示欄位的測量單位。這些欄位包括 `NavigationInstruction` 中的 `instruction` 欄位。路線、路段、步距和時間長度所用的度量單位不受這個值影響。如未提供這個值，系統會根據第一個來源的位置推斷顯示單位。
`optimize_waypoint_order`	`bool` (選用步驟) 如果設為 true，服務會重新排序指定的中間路線控點，盡量降低路線的整體成本。如果任何中繼路線控點是 `via` 路線控點，要求就會失敗。使用 `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` 尋找新的排序方式。如果 `X-Goog-FieldMask` 標頭中未要求 `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index`，要求就會失敗。如果 `optimize_waypoint_order` 設為 false，`ComputeRoutesResponse.optimized_intermediate_waypoint_index` 會是空白。
`requested_reference_routes[]`	`ReferenceRoute` (選用步驟) 指定要在要求中計算哪些參考路線 (預設路線除外)。參考路線是指路線計算目標與預設路線不同的路線。舉例來說，`FUEL_EFFICIENT` 參考路線計算會考量各種參數，產生最省油的路線。使用這項功能時，請在產生的路線中尋找 `route_labels`。
`extra_computations[]`	`ExtraComputation` (選用步驟) 可用於完成要求的額外運算清單。注意：這些額外計算可能會在回應中傳回額外欄位。這些額外欄位也必須在欄位遮罩中指定，才能在回應中傳回。
`traffic_model`	`TrafficModel` (選用步驟) 指定計算交通時間時要採用的假設。這項設定會影響 `Route` 和 `RouteLeg` 中時間長度欄位傳回的值，其中包含根據歷來平均值預估的交通時間。`TrafficModel` 僅適用於將 `RoutingPreference` 設為 `TRAFFIC_AWARE_OPTIMAL`，並將 `RouteTravelMode` 設為 `DRIVE` 的要求。如果要求提供流量，但未指定 `TrafficModel`，則預設值為 `BEST_GUESS`。
`transit_preferences`	`TransitPreferences` (選用步驟) 指定偏好設定，影響 `TRANSIT` 路線傳回的路線。注意：只有在 `RouteTravelMode` 設為 `TRANSIT` 時，才能指定 `transit_preferences`。

ExtraComputation

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

列舉
`EXTRA_COMPUTATION_UNSPECIFIED`	未使用。含有這個值的要求會失敗。
`TOLLS`	路線的收費資訊。
`FUEL_CONSUMPTION`	路線的預估燃料耗量。
`TRAFFIC_ON_POLYLINE`	路線的車流量監測折線。
`HTML_FORMATTED_NAVIGATION_INSTRUCTIONS`	`NavigationInstructions`，以格式化的 HTML 文字字串呈現。這類內容應按原樣讀取。這類內容僅供顯示，請勿以程式輔助方式剖析。
`FLYOVER_INFO_ON_POLYLINE`	路線的立體空照圖資訊。必須指定 `routes.polyline_details.flyover_info` fieldmask，才能傳回這項資訊。目前只有印度特定都會區會填入這項資料。這項功能仍在實驗階段，SKU/費用可能會有所變動。
`NARROW_ROAD_INFO_ON_POLYLINE`	路線的狹窄道路資訊。必須指定 `routes.polyline_details.narrow_road_info` fieldmask，才能傳回這項資訊。目前只有印度特定都會區會填入這項資料。這項功能仍在實驗階段，SKU/費用可能會有所變動。

ReferenceRoute

ComputeRoutesRequest 中支援的參考路線。

列舉

REFERENCE_ROUTE_UNSPECIFIED 未使用。含有這個值的要求會失敗。

FUEL_EFFICIENT 省油路線。

列舉
`REFERENCE_ROUTE_UNSPECIFIED`	未使用。含有這個值的要求會失敗。
`FUEL_EFFICIENT`	省油路線。
`SHORTER_DISTANCE`	行車距離較短的路線。這是實驗功能。對於 `DRIVE` 要求，這項功能會優先選擇距離較短的路線，而非駕駛舒適度。舉例來說，系統可能會偏好當地道路而非高速公路、行駛泥土路、穿過停車場等。這項功能不會傳回 Google 地圖已知違法的任何動作。如果是 `BICYCLE` 和 `TWO_WHEELER` 要求，這項功能會傳回與未指定 `requested_reference_routes` 時類似的路徑。這項功能不支援任何其他交通方式、中途路線控點或 `optimize_waypoint_order`，否則要求會失敗。不過，您可以搭配任何 `routing_preference` 使用。

SHORTER_DISTANCE

行車距離較短的路線。這是實驗功能。

對於 DRIVE 要求，這項功能會優先選擇距離較短的路線，而非駕駛舒適度。舉例來說，系統可能會偏好當地道路而非高速公路、行駛泥土路、穿過停車場等。這項功能不會傳回 Google 地圖已知違法的任何動作。

如果是 BICYCLE 和 TWO_WHEELER 要求，這項功能會傳回與未指定 requested_reference_routes 時類似的路徑。

這項功能不支援任何其他交通方式、中途路線控點或 optimize_waypoint_order，否則要求會失敗。不過，您可以搭配任何 routing_preference 使用。

ComputeRoutesResponse

ComputeRoutes 回應訊息。

欄位

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

routes[]

Route

如果您指定 compute_alternatives_routes，這個陣列最多會包含三條計算出的路線；如果您未指定，則只會包含一條路線。如果這個陣列包含多個項目，第一個項目就是最建議的路徑。如果陣列為空白，表示系統找不到任何路線。

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

FallbackInfo

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

欄位

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

routing_mode

FallbackRoutingMode

回覆使用的轉送模式。如果系統觸發備援，模式可能與原始用戶端要求中設定的轉送偏好設定不同。

reason

FallbackReason

系統改用備用回覆而非原始回覆的原因。只有在觸發備援模式並傳回備援回應時，才會填入這個欄位。

FallbackReason

使用備用回覆的原因。

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

FallbackRoutingMode

用於傳回備用回應的實際路徑模式。

列舉
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	未使用。
`FALLBACK_TRAFFIC_UNAWARE`	指出用於計算回應的 `TRAFFIC_UNAWARE` `RoutingPreference`。
`FALLBACK_TRAFFIC_AWARE`	指出用於計算回應的 `TRAFFIC_AWARE` `RoutingPreference`。

GeocodedWaypoint

用做中途點的地點詳細資料。只有地址航點會填入這項資料。包含地理編碼結果的詳細資料，用於判斷地址的地理編碼結果。

欄位
`geocoder_status`	`Status` 表示地理編碼作業產生的狀態碼。
`type[]`	`string` 結果類型，以零或多個類型標記的形式呈現。支援的類型：地址類型和地址元件類型。
`partial_match`	`bool` 指出地理編碼器沒有傳回與原始要求完全相符的結果，但可以比對部分要求的地址。建議您比對原始要求，檢查是否有拼寫錯誤和/或不完整的地址。
`place_id`	`string` 這筆結果的地點 ID。
`intermediate_waypoint_request_index`	`int32` 要求中對應中途停靠點的索引。只有在對應路線控點是中繼路線控點時，才會填入這個欄位。

GeocodingResults

包含起點、目的地和中途路線控點的 GeocodedWaypoints。只有地址航點會填入這項資料。

欄位

欄位
`origin`	`GeocodedWaypoint` 經過地理編碼的起點路線控點。
`destination`	`GeocodedWaypoint` 經過地理編碼的目的地路線控點。
`intermediates[]`	`GeocodedWaypoint` 中間地理編碼路線控點的清單，每個路線控點都包含索引欄位，對應於要求中指定路線控點順序的以零為準位置。

origin

GeocodedWaypoint

經過地理編碼的起點路線控點。

destination

GeocodedWaypoint

經過地理編碼的目的地路線控點。

intermediates[]

GeocodedWaypoint

中間地理編碼路線控點的清單，每個路線控點都包含索引欄位，對應於要求中指定路線控點順序的以零為準位置。

LocalizedTime

時間的本地化說明。

欄位

欄位
`time`	`LocalizedText` 以字串形式指定的時間，時區為指定時區。
`time_zone`	`string` 包含時區。這個值是時區名稱 (如 IANA 時區資料庫中所定義)，例如「America/New_York」。

time

LocalizedText

以字串形式指定的時間，時區為指定時區。

time_zone

string

包含時區。這個值是時區名稱 (如 IANA 時區資料庫中所定義)，例如「America/New_York」。

位置

封裝位置 (地理點和選用航向)。

欄位

欄位
`lat_lng`	`LatLng` 途中的地理座標。
`heading`	`Int32Value` 與車流方向相關的羅盤方位。這個值會指定上車和下車地點的道路側。航向值範圍為 0 到 360，其中 0 代表正北方的航向，90 代表正東方的航向，依此類推。這個欄位僅適用於 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。

lat_lng

LatLng

途中的地理座標。

heading

Int32Value

與車流方向相關的羅盤方位。這個值會指定上車和下車地點的道路側。航向值範圍為 0 到 360，其中 0 代表正北方的航向，90 代表正東方的航向，依此類推。這個欄位僅適用於 DRIVE 和 TWO_WHEELER RouteTravelMode。

Maneuver

一組值，用於指定目前步驟要採取的導航動作 (例如左轉、併入車道或直行)。

列舉
`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`	在圓環處右轉。
`DEPART`	初步演練。
`NAME_CHANGE`	用於表示街道名稱變更。

NavigationInstruction

封裝 RouteLegStep 的導覽指示。

欄位

maneuver

Maneuver

封裝目前步驟的導航指示 (例如左轉、併入或直行)。這個欄位會決定要顯示的圖示。

instructions

string

如何完成這個步驟。

折線

封裝編碼折線。

欄位

欄位
聯集欄位 `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 格式指定折線。

PolylineDetails

對應於折線特定索引或連續區段的詳細資料。假設折線包含 P_0、P_1、...、P_N 點 (以零為基準的索引)，PolylineDetails 會定義間隔和相關聯的中繼資料。

欄位

欄位
`flyover_info[]`	`FlyoverInfo` 折線沿途的立體空照圖詳細資料。
`narrow_road_info[]`	`NarrowRoadInfo` 折線沿途的狹窄道路詳細資料。

flyover_info[]

FlyoverInfo

折線沿途的立體空照圖詳細資料。

narrow_road_info[]

NarrowRoadInfo

折線沿途的狹窄道路詳細資料。

FlyoverInfo

封裝沿折線的飛越資訊。

欄位

欄位
`flyover_presence`	`RoadFeatureState` 僅供輸出。表示特定折線路段是否有高架道路。
`polyline_point_index`	`PolylinePointIndex` 沿著折線的飛越相關資訊位置。

flyover_presence

RoadFeatureState

僅供輸出。表示特定折線路段是否有高架道路。

polyline_point_index

PolylinePointIndex

沿著折線的飛越相關資訊位置。

NarrowRoadInfo

封裝有關折線沿線狹窄道路的資訊。

欄位

欄位
`narrow_road_presence`	`RoadFeatureState` 僅供輸出。表示指定折線路段是否有狹窄道路。
`polyline_point_index`	`PolylinePointIndex` 沿著折線的狹窄道路相關資訊位置。

narrow_road_presence

RoadFeatureState

僅供輸出。表示指定折線路段是否有狹窄道路。

polyline_point_index

PolylinePointIndex

沿著折線的狹窄道路相關資訊位置。

PolylinePointIndex

封裝折線詳細資料的開始和結束索引。如果資料對應至單一點，start_index 和 end_index 會相等。

欄位

欄位
`start_index`	`int32` 折線中這項詳細資料的起始索引。
`end_index`	`int32` 折線中這項詳細資料的結束索引。

start_index

int32

折線中這項詳細資料的起始索引。

end_index

int32

折線中這項詳細資料的結束索引。

RoadFeatureState

封裝一段折線沿線道路特徵的狀態。

列舉
`ROAD_FEATURE_STATE_UNSPECIFIED`	系統未計算道路特徵的狀態 (預設值)。
`EXISTS`	道路特徵存在。
`DOES_NOT_EXIST`	道路特徵不存在。

PolylineEncoding

指定要傳回的折線偏好類型。

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

PolylineQuality

一組值，用於指定折線的品質。

列舉
`POLYLINE_QUALITY_UNSPECIFIED`	未指定折線品質偏好設定。預設值為 `OVERVIEW`。
`HIGH_QUALITY`	指定高品質折線，這類折線是由比 `OVERVIEW` 更多的點組成，但會增加回應大小。需要更精確的值時，請使用這個值。
`OVERVIEW`	指定概覽折線，這條折線是由少量點組成。顯示路線總覽時，請使用這個值。相較於使用 `HIGH_QUALITY` 選項，這個選項的要求延遲時間較短。

路線

內含路線，由一系列相連的路段組成，連接起點、終點和中途路線控點。

欄位
`route_labels[]`	`RouteLabel` `Route` 的標籤，有助於識別路線的特定屬性，以便與其他路線比較。
`legs[]`	`RouteLeg` 路線是由多個路段 (路線控點之間的路線區段) 組成。每段行程都對應兩個非 `via` `Waypoints` 之間的旅程。舉例來說，如果路線沒有中繼路線控點，就只有一個路段。如果路線包含一個非 `via` 的中途路線控點，則會有兩個路段。如果路線包含一個 `via` 中間路線控點，則只有一個路段。路段順序與路線控點順序一致，從 `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` 路線的其他資訊。
`optimized_intermediate_waypoint_index[]`	`int32` 如果將 `optimize_waypoint_order` 設為 true，這個欄位會包含最佳化的中途控點順序。否則這個欄位會空白。舉例來說，如果輸入的起點為洛杉磯，中途停靠點為達拉斯、班戈和鳳凰城，目的地為紐約，而最佳化的中途停靠點順序為鳳凰城、達拉斯和班戈，則這個欄位會包含 [2, 0, 1] 值。輸入內容中第一個中途航點的索引為 0。
`localized_values`	`RouteLocalizedValues` `Route` 屬性的文字表示法。
`route_token`	`string` 不透明權杖，可傳遞至 Navigation SDK，在導航期間重建路線，並在重新規劃路線時，遵守建立路線時的原始意圖。請將這個權杖視為不透明的 Blob。請勿比較不同要求間的值，因為即使服務傳回完全相同的路線，值也可能會變更。注意：只有將 `ComputeRoutesRequest.routing_preference` 設為 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL` 的要求，才能使用 `Route.route_token`。如果要求含有中途行經的路線控點，則不支援 `Route.route_token`。
`polyline_details`	`PolylineDetails` 內含折線詳細資料的相關資訊。

RouteLocalizedValues

特定屬性的文字表示法。

欄位
`distance`	`LocalizedText` 以文字形式表示的行駛距離。
`duration`	`LocalizedText` 以文字形式表示的時長，並根據查詢區域進行本地化。考量路況。注意：如果未要求提供即時路況資訊，這個值會與 `static_duration` 的值相同。
`static_duration`	`LocalizedText` 以文字形式表示的時長，未考量流量狀況。
`transit_fare`	`LocalizedText` 以文字形式呈現的大眾運輸車資。

RouteLabel

Route 的標籤，有助於識別路線的特定屬性，以便與其他路線比較。

列舉
`ROUTE_LABEL_UNSPECIFIED`	預設值為不使用。
`DEFAULT_ROUTE`	系統在計算路線時傳回的預設「最佳」路線。
`DEFAULT_ROUTE_ALTERNATE`	替代預設的「最佳」路線。指定 `compute_alternative_routes` 時，系統會傳回這類路線。
`FUEL_EFFICIENT`	省油路線。標示這個值的路線會根據燃油消耗量等環保參數進行最佳化。
`SHORTER_DISTANCE`	路線的行車距離較短。這是實驗功能。

RouteLeg

包含非 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` 包含應告知使用者的額外資訊，例如路線路段上可能的交通區域限制。
`localized_values`	`RouteLegLocalizedValues` `RouteLeg` 屬性的文字表示法。
`steps_overview`	`StepsOverview` 本`RouteLeg`中的步驟概要資訊。這個欄位只會填入大眾運輸路線。

RouteLegLocalizedValues

特定屬性的文字表示法。

欄位

distance

LocalizedText

以文字形式表示的行駛距離。

duration

LocalizedText

以文字形式表示的時長，並根據查詢區域進行本地化。考量路況。注意：如果未要求提供即時路況資訊，這個值會與 static_duration 相同。

static_duration

LocalizedText

以文字形式表示的時長，未考量流量狀況。

StepsOverview

提供 RouteLegStep 清單的總覽資訊。

欄位

欄位
`multi_modal_segments[]`	`MultiModalSegment` `RouteLeg.steps`不同多模態區隔的摘要資訊。如果 `RouteLeg` 的步驟中沒有任何多模式路段，系統就不會填入這個欄位。

multi_modal_segments[]

MultiModalSegment

RouteLeg.steps不同多模態區隔的摘要資訊。如果 RouteLeg 的步驟中沒有任何多模式路段，系統就不會填入這個欄位。

MultiModalSegment

提供 RouteLeg.steps 不同多模態區隔的摘要資訊。多模態片段是指一或多個連續的 RouteLegStep，具有相同的 RouteTravelMode。如果 RouteLeg 的步驟中沒有任何多模式路段，系統就不會填入這個欄位。

欄位
`navigation_instruction`	`NavigationInstruction` 多模態路段的 NavigationInstruction。
`travel_mode`	`RouteTravelMode` 多模式路段的交通方式。
`step_start_index`	`int32` 多模態區段開頭的對應 `RouteLegStep` 索引。
`step_end_index`	`int32` 多模態區隔結尾的對應 `RouteLegStep` 索引。

RouteLegStep

包含 RouteLeg 的區段。每個步驟都對應一項導航指示。路段是由多個步驟組成。

欄位
`distance_meters`	`int32` 這個步驟的移動距離 (以公尺為單位)。在某些情況下，這個欄位可能沒有值。
`static_duration`	`Duration` 不考量路況，通過這個步驟所需的時間。在某些情況下，這個欄位可能沒有值。
`polyline`	`Polyline` 與這個步驟相關聯的折線。
`start_location`	`Location` 這個步驟的起點。
`end_location`	`Location` 這個步驟的終點。
`navigation_instruction`	`NavigationInstruction` 導航指示。
`travel_advisory`	`RouteLegStepTravelAdvisory` 包含應告知使用者的額外資訊，例如行程步驟中可能的交通區域限制。
`localized_values`	`RouteLegStepLocalizedValues` `RouteLegStep` 屬性的文字表示法。
`transit_details`	`RouteLegStepTransitDetails` 如果交通方式為 `TRANSIT`，則會顯示這個步驟的詳細資料。
`travel_mode`	`RouteTravelMode` 這個步驟使用的交通方式。

RouteLegStepLocalizedValues

特定屬性的文字表示法。

欄位

distance

LocalizedText

以文字形式表示的行駛距離。

static_duration

LocalizedText

以文字形式表示的時長，未考量流量狀況。

RouteLegStepTransitDetails

與 TRANSIT 路徑相關的 RouteLegStep 其他資訊。

欄位
`stop_details`	`TransitStopDetails` 步驟的抵達和出發停靠站資訊。
`localized_values`	`TransitDetailsLocalizedValues` `RouteLegStepTransitDetails` 屬性的文字表示法。
`headsign`	`string` 指定這條路線的行進方向，如交通工具或出發站上所標示的方向。方向通常是終點站。
`headway`	`Duration` 指定從目前同一站點出發的預計間隔時間。舉例來說，如果間隔秒數值為 600，則表示如果錯過上一班公車，下一班預計要等 10 分鐘。
`transit_line`	`TransitLine` 目前步驟中使用的大眾運輸路線相關資訊。
`stop_count`	`int32` 從出發站到抵達站的停靠站數量。這項數量包含抵達站，但不包含出發站。舉例來說，如果您的路線是從 A 站出發，途經 B、C 兩站，最後抵達 D 站， `stop_count` 傳回 3。
`trip_short_text`	`string` 時刻表和看板上顯示的文字，可供乘客識別大眾運輸行程。這段文字應可識別服務日的特定行程。舉例來說，Amtrak 列車「538」於平日 15:10 從加州聖荷西出發，前往加州沙加緬度。`trip_short_text`

TransitDetailsLocalizedValues

RouteTransitDetails 值的本地化說明。

欄位

欄位
`arrival_time`	`LocalizedTime` 時間的格式化文字表示法，以及對應的時區。
`departure_time`	`LocalizedTime` 時間的格式化文字表示法，以及對應的時區。

arrival_time

LocalizedTime

時間的格式化文字表示法，以及對應的時區。

departure_time

LocalizedTime

時間的格式化文字表示法，以及對應的時區。

TransitStopDetails

RouteLegStep 的停靠站詳細資料。

欄位
`arrival_stop`	`TransitStop` 步驟的抵達站點資訊。
`arrival_time`	`Timestamp` 該步驟的預計到達時間。
`departure_stop`	`TransitStop` 步驟的起點站資訊。
`departure_time`	`Timestamp` 該步驟的預計出發時間。

RouteLegStepTravelAdvisory

包含應告知使用者的額外資訊，例如行程步驟可能有的交通區域限制。

欄位

欄位
`speed_reading_intervals[]`	`SpeedReadingInterval` 注意：這個欄位目前未填入任何內容。

speed_reading_intervals[]

SpeedReadingInterval

注意：這個欄位目前未填入任何內容。

RouteLegTravelAdvisory

包含使用者應在行程步驟中瞭解的其他資訊，例如可能的交通區域限制。

欄位

欄位
`toll_info`	`TollInfo` 內含特定 `RouteLeg` 的收費資訊。只有在我們預期 `RouteLeg` 有收費路段，且要求中包含 `ComputeRoutesRequest.extra_computations` 的 `TOLLS` 時，才會填入這個欄位。如果已設定這個欄位，但未填入 estimated_price 子欄位，表示道路包含收費路段，但我們不知道預估價格。如果 `toll_info` 不存在，則 `RouteLeg` 不會收取通行費。
`speed_reading_intervals[]`	`SpeedReadingInterval` 顯示交通密度的速度讀取間隔。只有在要求具有 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL` `ComputeRoutesRequest.routing_preference` 值，且 `TRAFFIC_ON_POLYLINE` 包含在 `ComputeRoutesRequest.extra_computations` 中時，才會填入這個欄位。這些間隔會涵蓋 `RouteLeg` 的整條折線，且不會重疊。指定間隔的起點與前一個間隔的終點相同。範例： `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

內含特定 RouteLeg 的收費資訊。只有在我們預期 RouteLeg 有收費路段，且要求中包含 ComputeRoutesRequest.extra_computations 的 TOLLS 時，才會填入這個欄位。如果已設定這個欄位，但未填入 estimated_price 子欄位，表示道路包含收費路段，但我們不知道預估價格。如果 toll_info 不存在，則 RouteLeg 不會收取通行費。

speed_reading_intervals[]

SpeedReadingInterval

顯示交通密度的速度讀取間隔。只有在要求具有 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference 值，且 TRAFFIC_ON_POLYLINE 包含在 ComputeRoutesRequest.extra_computations 中時，才會填入這個欄位。這些間隔會涵蓋 RouteLeg 的整條折線，且不會重疊。指定間隔的起點與前一個間隔的終點相同。

範例：

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

RouteMatrixDestination

ComputeRouteMatrixRequest 的單一目的地

欄位

欄位
`waypoint`	`Waypoint` 必要欄位。目的地航點

waypoint

Waypoint

必要欄位。目的地航點

RouteMatrixElement

包含 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` 在某些情況下，如果伺服器無法根據特定起點/目的地組合的偏好設定計算路線，可能會改用其他計算模式。使用備援模式時，這個欄位會包含備援回應的詳細資訊。否則這個欄位不會設定。
`localized_values`	`LocalizedValues` `RouteMatrixElement` 屬性的文字表示法。
`origin_index`	`int32` 要求中來源的索引，從零開始。
`destination_index`	`int32` 要求中目的地的索引，從零開始。

LocalizedValues

特定屬性的文字表示法。

欄位
`distance`	`LocalizedText` 以文字形式表示的移動距離。
`duration`	`LocalizedText` 以文字形式表示的預估時間，會考量路況。注意：如果未要求提供交通資訊，這個值會與 static_duration 相同。
`static_duration`	`LocalizedText` 以文字形式表示的時長，未考量流量狀況。
`transit_fare`	`LocalizedText` 以文字形式呈現的大眾運輸車資。

RouteMatrixElementCondition

傳回路線的狀況。

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

RouteMatrixOrigin

ComputeRouteMatrixRequest 的單一來源

欄位

欄位
`waypoint`	`Waypoint` 必要欄位。起點路線控點
`route_modifiers`	`RouteModifiers` (選用步驟) 以這個做為起點的每條路線的修飾符

waypoint

Waypoint

必要欄位。起點路線控點

route_modifiers

RouteModifiers

(選用步驟) 以這個做為起點的每條路線的修飾符

RouteModifiers

封裝一組選用條件，用於計算路徑時。

欄位
`avoid_tolls`	`bool` 如果設為 true，系統會盡量避開收費道路，優先選擇不含收費道路的路線。僅適用於 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。
`avoid_highways`	`bool` 如果設為 true，系統會盡量避開高速公路，優先選擇不含高速公路的路線。僅適用於 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。
`avoid_ferries`	`bool` 如果設為 true，系統會盡量避開渡輪，優先選擇不含渡輪的路線。僅適用於 `DRIVE`和`TWO_WHEELER` `RouteTravelMode`。
`avoid_indoor`	`bool` 如果設為 true，系統會盡量避開室內導航，優先選擇不含室內導航的路線。僅適用於 `WALK` `RouteTravelMode`。
`vehicle_info`	`VehicleInfo` 指定車輛資訊。
`toll_passes[]`	`TollPass` 內含收費路段通行證的相關資訊。如果提供收費路段通行證，API 會嘗試傳回通行證價格。如果未提供收費證，API 會將收費證視為不明，並嘗試傳回現金價格。僅適用於 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。

RouteTravelAdvisory

包含應告知使用者的額外資訊，例如可能的交通區域限制。

欄位
`toll_info`	`TollInfo` 內含路線的收費資訊。只有在路線預計會經過收費站，且要求中包含 `ComputeRoutesRequest.extra_computations` 時，才會填入這個欄位。`TOLLS`如果已設定這個欄位，但未填入 `estimatedPrice` 子欄位，則表示路線包含收費路段，但預估價格不明。如果未設定 `toll_info`，表示路線上不會有收費站。
`speed_reading_intervals[]`	`SpeedReadingInterval` 顯示交通密度的速度讀取間隔。只有在要求具有 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL` `ComputeRoutesRequest.routing_preference` 值，且 `TRAFFIC_ON_POLYLINE` 包含在 `ComputeRoutesRequest.extra_computations` 中時，才會填入這個欄位。間隔會涵蓋路線的整條折線，不會重疊。指定間隔的起點與前一個間隔的終點相同。範例： `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`
`fuel_consumption_microliters`	`int64` 預測的燃料消耗量 (以微升為單位)。只有在要求的 `ComputeRoutesRequest.extra_computations` 中包含 `FUEL_CONSUMPTION` 時，才會填入這個欄位。
`route_restrictions_partially_ignored`	`bool` 傳回的路線可能設有不適合所要求交通方式或路線修飾符的限制。
`transit_fare`	`Money` 如果存在，則包含這條路線的總車資或票價。這個屬性只會針對 `TRANSIT` 要求傳回，且僅適用於所有大眾運輸路段皆有車資資訊的路線。

RouteTravelMode

用來指定交通方式的一組值。注意：WALK、BICYCLE 和 TWO_WHEELER 路線目前為 Beta 版，有時可能缺少清楚的人行道、步道或單車道。在應用程式中顯示所有步行、自行車和雙輪車路線時，都必須向使用者顯示這項警告。

列舉
`TRAVEL_MODE_UNSPECIFIED`	未指定交通方式，預設值為 `DRIVE`。
`DRIVE`	搭乘客車。
`BICYCLE`	騎自行車。
`WALK`	步行。
`TWO_WHEELER`	兩輪機動車輛，例如摩托車。請注意，這與涵蓋人力驅動模式的`BICYCLE`交通方式不同。
`TRANSIT`	盡量搭乘大眾運輸路線。

RoutingPreference

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

列舉
`ROUTING_PREFERENCE_UNSPECIFIED`	未指定任何轉送偏好設定。預設值為 `TRAFFIC_UNAWARE`。
`TRAFFIC_UNAWARE`	計算路線時不會考量即時路況。如果路況不重要或不適用，就很適合使用這項設定。使用這個值可產生最低延遲時間。注意：如果是 `RouteTravelMode`、`DRIVE` 和 `TWO_WHEELER`，系統會根據路網及與時間無關的平均路況來選擇路線和時間，不會考量目前路況。因此，路線可能會包含暫時封閉的道路。受到路網變動、平均路況更新，以及這項服務的分散性質影響，特定要求的結果可能會隨時間而改變。此外，在時間或頻率都沒有限制的情況下，即使兩條路線幾乎相同，結果還是有可能不同。
`TRAFFIC_AWARE`	計算路線時會考量即時路況。與 `TRAFFIC_AWARE_OPTIMAL` 相比，部分最佳化項目可大幅縮短延遲時間。
`TRAFFIC_AWARE_OPTIMAL`	計算路線時會考量即時路況，但不套用大部分的效能最佳化設定。使用這個值會產生最高延遲。

SpeedReadingInterval

折線或路徑上連續路段的車流密度指標。假設路徑的點為 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`	車流堵塞。

TollInfo

封裝 Route 或 RouteLeg 上的收費資訊。

欄位

estimated_price[]

Money

對應 Route 或 RouteLeg 的通行費金額。這份清單包含各幣別的金額，這些是收費站預計會收取的費用。通常來說，如果路線有過路費，且以單一幣別支付，這份清單只會包含一個項目。如果是國際行程，這份清單可能包含多個項目，反映不同幣別的通行費。

TollPass

我們支援的全球各地通行證清單。

列舉
`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 州別車牌豁免。
`JP_ETC`	日本 ETC。電子無線收費系統。https://www.go-etc.jp/
`JP_ETC2`	日本 ETC2.0。新版 ETC，提供更多折扣，並在車輛上的裝置與道路上的天線之間進行雙向通訊。https://www.go-etc.jp/etc2/index.html
`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`	美國阿拉斯加州
`US_CA_FASTRAK`	美國加州。
`US_CA_FASTRAK_CAV_STICKER`	指出駕駛人是否持有任何 FasTrak 通行證，以及 DMV 核發的清潔能源車輛 (CAV) 貼紙。https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	美國科羅拉多州。
`US_CO_GO_PASS`	美國科羅拉多州。
`US_DE_EZPASSDE`	DE, USA.
`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`	美國堪薩斯州
`US_KS_KTAG`	美國堪薩斯州
`US_KS_NATIONALPASS`	美國堪薩斯州
`US_KS_PREPASS_ELITEPASS`	美國堪薩斯州
`US_KY_RIVERLINK`	美國肯塔基州。
`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_BCPASS`	美國密西根州。
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	美國密西根州。
`US_MI_IQ_PROX_CARD`	美國密西根州。已淘汰，因為這類票證已不存在。這個項目已遭淘汰！
`US_MI_IQ_TAG`	美國密西根州。
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	美國密西根州。
`US_MI_NEXPRESS_TOLL`	美國密西根州。
`US_MN_EZPASSMN`	美國明尼蘇達州。
`US_NC_EZPASSNC`	美國北卡羅來納州。
`US_NC_PEACH_PASS`	美國北卡羅來納州。
`US_NC_QUICK_PASS`	美國北卡羅來納州。
`US_NH_EZPASSNH`	美國新罕布夏州。
`US_NJ_DOWNBEACH_EXPRESS_PASS`	美國紐澤西州。
`US_NJ_EZPASSNJ`	美國紐澤西州。
`US_NY_EXPRESSPASS`	美國紐約州。
`US_NY_EZPASSNY`	美國紐約州。
`US_OH_EZPASSOH`	美國俄亥俄州。
`US_PA_EZPASSPA`	美國賓州。
`US_RI_EZPASSRI`	美國羅德島州
`US_SC_PALPASS`	美國南卡羅來納州。
`US_TX_AVI_TAG`	美國德州。
`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_FUEGO_TAG`	美國德州。
`US_TX_LAREDO_TRADE_TAG`	美國德州。
`US_TX_PLUSPASS`	美國德州。
`US_TX_TOLLTAG`	美國德州。
`US_TX_TXTAG`	美國德州。
`US_TX_XPRESS_CARD`	美國德州。
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	美國猶他州
`US_VA_EZPASSVA`	美國維吉尼亞州。
`US_WA_BREEZEBY`	美國華盛頓州。
`US_WA_GOOD_TO_GO`	美國華盛頓州。
`US_WV_EZPASSWV`	美國西維吉尼亞州
`US_WV_MEMORIAL_BRIDGE_TICKETS`	美國西維吉尼亞州
`US_WV_MOV_PASS`	美國西維吉尼亞州
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	美國西維吉尼亞州

TrafficModel

指定計算交通時間時要採用的假設。這項設定會影響回應中 duration 欄位傳回的值，其中包含根據歷來平均值預估的交通時間。

列舉
`TRAFFIC_MODEL_UNSPECIFIED`	未使用。如未指定，則會預設為 `BEST_GUESS`。
`BEST_GUESS`	表示傳回的 `duration` 應是最準確的預估交通時間 (根據歷來路況和即時車流量兩者的已知相關資訊計算而得)。`departure_time` 距離現在的時間越近，即時車流量的影響力就越大。
`PESSIMISTIC`	表示傳回的時間長度在大多數日子應該都會比實際交通時間長，但偶爾路況特別差時，實際交通時間可能會超過這個值。
`OPTIMISTIC`	表示傳回的時間在大多數日子應該都會比實際交通時間短，但偶爾路況特別好時，實際交通時間可能會短於這個值。

TransitAgency

經營大眾運輸路線的運輸公司。

欄位

name

string

這間運輸公司的名稱。

phone_number

string

運輸公司特定地區格式的電話號碼。

uri

string

運輸公司的 URI。

TransitLine

包含目前步驟中使用的大眾運輸路線相關資訊。

欄位
`agencies[]`	`TransitAgency` 營運這條大眾運輸路線的運輸公司。
`name`	`string` 這條大眾運輸路線的全名，例如「8 Avenue Local」。
`uri`	`string` 這條大眾運輸路線的 URI (由運輸公司提供)。
`color`	`string` 這條路線常用的顏色，以十六進位表示。
`icon_uri`	`string` 與這條路線相關聯的圖示 URI。
`name_short`	`string` 這條大眾運輸路線的簡稱。通常是路線編號，例如「M7」或「355」。
`text_color`	`string` 這條路線常用的文字顏色，以十六進位表示。
`vehicle`	`TransitVehicle` 這條大眾運輸路線使用的交通工具類型。

TransitPreferences

影響傳回路線的 TRANSIT 路線偏好設定。

欄位

allowed_travel_modes[]

TransitTravelMode

取得 TRANSIT 路線時要使用的一組交通方式。預設為所有支援的交通方式。

routing_preference

TransitRoutingPreference

指定後會影響傳回的 TRANSIT 路線。

TransitRoutingPreference

指定大眾運輸路線的路線偏好設定。

列舉
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	未指定偏好設定。
`LESS_WALKING`	表示計算出的路線應優先選擇步行距離較短的選項。
`FEWER_TRANSFERS`	表示計算出的路線應優先選擇轉乘次數較少的選項。

TransitTravelMode

用來指定大眾運輸模式的一組值。

列舉
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	未指定大眾運輸交通方式。
`BUS`	搭乘公車。
`SUBWAY`	搭乘地鐵。
`TRAIN`	搭乘火車。
`LIGHT_RAIL`	搭乘輕軌電車或電車。
`RAIL`	搭乘火車。這相當於 `SUBWAY`、`TRAIN` 和 `LIGHT_RAIL` 的組合。

TransitStop

大眾運輸站牌的相關資訊。

欄位

name

string

大眾運輸停靠站的名稱。

location

Location

停靠站的位置，以經緯度座標表示。

TransitVehicle

大眾運輸路線使用的車輛相關資訊。

欄位
`name`	`LocalizedText` 這輛車的名稱 (大寫)。
`type`	`TransitVehicleType` 使用的車輛類型。
`icon_uri`	`string` 與此車輛類型相關聯的圖示 URI。
`local_icon_uri`	`string` 此交通工具類型相關圖示的 URI (根據當地交通標誌)。

TransitVehicleType

大眾運輸路線的車輛類型。

列舉
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	未使用。
`BUS`	公車。
`CABLE_CAR`	靠電纜運作的交通工具，通常在地面上行駛。空中纜車可視為 `GONDOLA_LIFT` 類型。
`COMMUTER_TRAIN`	通勤鐵路。
`FERRY`	渡輪。
`FUNICULAR`	靠電纜從陡坡往上拉升的交通工具。纜車通常由兩個車廂組成，其中每個車廂都為另一個車廂保持平衡。
`GONDOLA_LIFT`	空中纜車。
`HEAVY_RAIL`	重軌電車。
`HIGH_SPEED_TRAIN`	高速火車。
`INTERCITY_BUS`	城際巴士。
`LONG_DISTANCE_TRAIN`	長途火車。
`METRO_RAIL`	輕軌電車運輸。
`MONORAIL`	單軌電車。
`OTHER`	所有其他車輛。
`RAIL`	火車。
`SHARE_TAXI`	共乘的計程車可視為一種沿路上下客的公車。
`SUBWAY`	地下輕軌電車。
`TRAM`	地上輕軌電車。
`TROLLEYBUS`	無軌電車。

單位

一組值，用於指定顯示畫面中使用的測量單位。

列舉
`UNITS_UNSPECIFIED`	未指定測量單位。預設為從要求推斷出的計量單位。
`METRIC`	公制測量單位。
`IMPERIAL`	英制 (英式) 計量單位。

VehicleEmissionType

一組描述車輛排放類型的數值。僅適用於 DRIVE RouteTravelMode。

列舉
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	未指定排放類型。預設值為 `GASOLINE`。
`GASOLINE`	汽油車。
`ELECTRIC`	以電力為動力的車輛。
`HYBRID`	油電混合車 (例如汽油 + 電動)。
`DIESEL`	柴油車。

VehicleInfo

包含車輛資訊，例如車輛排放類型。

欄位

emission_type

VehicleEmissionType

說明車輛的排放類型。僅適用於 DRIVE RouteTravelMode。

途經點

封裝路徑點。路線控點會標示路線的起點和終點，以及路線中的中途停靠點。

欄位
`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` `RouteTravelMode`。
聯集欄位 `location_type`。表示位置的不同方式。`location_type` 只能是下列其中一項：
`location`	`Location` 使用地理座標指定的點，包括選用的航向。
`place_id`	`string` 與途中的航點相關聯的 POI 地點 ID。
`address`	`string` 使用者可理解的地址或 Plus Code。詳情請參閱 https://plus.codes。

Package google.maps.routing.v2 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

索引

路徑

ComputeRouteMatrixRequest

ExtraComputation

ComputeRoutesRequest

ExtraComputation

ReferenceRoute

ComputeRoutesResponse

FallbackInfo

FallbackReason

FallbackRoutingMode

GeocodedWaypoint

GeocodingResults

LocalizedTime

位置

Maneuver

NavigationInstruction

折線

PolylineDetails

FlyoverInfo

NarrowRoadInfo

PolylinePointIndex

RoadFeatureState

PolylineEncoding

PolylineQuality

路線

RouteLocalizedValues

RouteLabel

RouteLeg

RouteLegLocalizedValues

StepsOverview

MultiModalSegment

RouteLegStep

RouteLegStepLocalizedValues

RouteLegStepTransitDetails

TransitDetailsLocalizedValues

TransitStopDetails

RouteLegStepTravelAdvisory

RouteLegTravelAdvisory

RouteMatrixDestination

RouteMatrixElement

LocalizedValues

RouteMatrixElementCondition

RouteMatrixOrigin

RouteModifiers

RouteTravelAdvisory

RouteTravelMode

RoutingPreference

SpeedReadingInterval

速度

TollInfo

TollPass

TrafficModel

TransitAgency

TransitLine

TransitPreferences

TransitRoutingPreference

TransitTravelMode

TransitStop

TransitVehicle

TransitVehicleType

單位

VehicleEmissionType

VehicleInfo

途經點

Package google.maps.routing.v2