Package google.maps.routing.v2

索引

路徑

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，否則所有訊息都會顯示為 OK。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

必要欄位。來源陣列，用於決定回應矩陣的資料列。來源和目的地的基數有幾項大小限制：

  • 以 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 中 duration 欄位傳回的值，其中包含根據歷來平均值預估的交通時間。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 中 duration 欄位傳回的值，其中包含根據歷來平均值預估的交通時間。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 欄位遮罩，才能傳回這項資訊。目前這項資料只會填入印度的特定都會區。這項功能仍在實驗階段，因此 SKU/收費項目可能會有變動。
NARROW_ROAD_INFO_ON_POLYLINE 路線的狹窄道路資訊。您必須指定 routes.polyline_details.narrow_road_info 欄位遮罩，才能傳回這項資訊。目前這項資料只會填入印度的特定都會區。這項功能仍在實驗階段，因此 SKU/收費項目可能會有變動。

ReferenceRoute

ComputeRoutesRequest 支援的參考路線。

列舉
REFERENCE_ROUTE_UNSPECIFIED 未使用。含有這個值的要求會失敗。
FUEL_EFFICIENT 省油路線。
SHORTER_DISTANCE

路線的移動距離較短。這是實驗功能。

對於 DRIVE 要求，這項功能會優先考量行車距離，而非行車舒適性。例如，系統可能會偏好當地道路而非高速公路、行經土路、穿越停車場等。這項功能不會傳回 Google 地圖認為違法的任何操作。

針對 BICYCLE 和 TWO_WHEELER 要求，這項功能會傳回類似於未指定 requested_reference_routes 時傳回的路線。

這項功能不支援任何其他行程模式、中繼路線控點或 optimize_waypoint_order；這類要求會失敗。不過，您可以將其與任何 routing_preference 搭配使用。

ComputeRoutesResponse

計算回應訊息的路徑。

欄位
routes[]

Route

在您指定 compute_alternatives_routes 時，此陣列會包含計算路線的陣列 (最多三個)，如果未指定 compute_alternatives_routes，則只會包含一個路線。如果這個陣列包含多個項目，建議您採用第一個項目。如果陣列為空白，表示系統找不到路線。
fallback_info

FallbackInfo

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

GeocodingResults

包含路線控點的 Geocoding 回應資訊，這些路線控點會指定為地址。

FallbackInfo

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

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

中繼地理編碼路線控點清單，每個路線控點都包含一個索引欄位，對應於要求中指定的路線控點位置 (以 0 為基準)。

LocalizedTime

時間的本地化說明。

欄位
time

LocalizedText

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

string

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

位置

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

欄位
lat_lng

LatLng

航點的地理座標。
heading

Int32Value

與流量方向相關的指南針方位。這個值會指定乘客上車和下車的路邊。航向值的範圍為 0 到 360，其中 0 指定正北方向，90 指定正東方向，以此類推。您只能將這個欄位用於 DRIVE 和 TWO_WHEELER RouteTravelMode。

機動

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

列舉
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 用於表示街道名稱變更。

封裝 RouteLegStep 的導覽指示。

欄位
maneuver

Maneuver

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

string

操作說明。

折線

封裝已編碼的折線。

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

string

使用折線編碼演算法對折線進行字串編碼
geo_json_linestring

Struct

使用 GeoJSON LineString 格式指定折線。

PolylineDetails

與多邊形的特定索引或相鄰區段相對應的詳細資料。假設多邊形包含 P_0、P_1、...、P_N 等點 (以 0 為基底的索引)，PolylineDetails 會定義間隔和相關中繼資料。

欄位
flyover_info[]

FlyoverInfo

沿著折線顯示的飛越詳細資料。
narrow_road_info[]

NarrowRoadInfo

沿著折線顯示狹窄道路的詳細資料。

FlyoverInfo

封裝沿著多邊形飛越的資訊。

欄位
flyover_presence

RoadFeatureState

僅供輸出。指出折線某段路段是否有飛越。
polyline_point_index

PolylinePointIndex

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

NarrowRoadInfo

封裝沿著多邊形的狹窄道路資訊。

欄位
narrow_road_presence

RoadFeatureState

僅供輸出。指出折線上某段路段是否有狹窄道路。
polyline_point_index

PolylinePointIndex

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

PolylinePointIndex

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

欄位
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。請勿比較不同要求的值，因為即使服務傳回完全相同的路線，值仍可能會有所變動。

注意：Route.route_token 僅適用於將 ComputeRoutesRequest.routing_preference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 的要求。對於含有經過路線控點的要求，系統不支援 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 省油路線。標示為此值的路線會根據燃料消耗量等 Eco 參數進行最佳化。
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 的步驟中不含任何多模態區隔，這個欄位就不會填入資料。

MultiModalSegment

提供 RouteLeg.steps 的不同多模態區段的摘要資訊。多模態區段的定義是一或多個連續的 RouteLegStep，且這些 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

時刻表和看板上顯示的文字，可供乘客識別大眾運輸行程。這段文字應可用於識別服務日內的特定行程。舉例來說，「538」是 Amtrak 火車的 trip_short_text，這班火車在工作日的 15:10 從加州聖荷西出發，前往加州薩克拉門托。

TransitDetailsLocalizedValues

RouteTransitDetails 值的本地化說明。

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

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

RouteLegTravelAdvisory

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

欄位
toll_info

TollInfo

包含特定 RouteLeg 的通行費資訊。只有在系統預期 RouteLeg 有收費時，才會填入這個欄位。如果已設定這個欄位，但未填入 estimated_price 子欄位，則表示該路段含有過路費，但我們不知道預估價格。如果這個欄位不存在，則 RouteLeg 就沒有通行費。
speed_reading_intervals[]

SpeedReadingInterval

速度讀取間隔，詳細說明流量密度。適用於 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 轉送偏好設定。間隔會涵蓋 RouteLeg 的整個多邊形，且不會重疊。指定間隔的起點與前一個間隔的結點相同。

範例：

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

RouteMatrixDestination

ComputeRouteMatrixRequest 的單一目的地

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

選用設定。針對以此為起點的每條路線的修飾符

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

包含路線上的通行費資訊。只有在路線上有收費站時，這個欄位才會填入資料。如果已設定這個欄位，但未填入 estimatedPrice 子欄位，則路線含有過路費，但預估價格不明。如果未設定這個欄位，表示路線上沒有收費站。
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

預測的燃料消耗量 (以微升為單位)。
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 等點 (以 0 為基底的索引)，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 AL, 美國
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS 美國阿拉斯加州。
US_CA_FASTRAK 加拿大、美國加州
US_CA_FASTRAK_CAV_STICKER 表示駕駛人除了有 DMV 核發的清淨空氣車輛 (CAV) 標籤外，還有其他 FasTrak 通行證。https://www.bayareafastrak.org/en/guide/doINeedFlex.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 美國堪薩斯州。
US_KS_KTAG 美國堪薩斯州。
US_KS_NATIONALPASS 美國堪薩斯州。
US_KS_PREPASS_ELITEPASS 美國堪薩斯州。
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。