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

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 必要欄位。來源陣列，用於決定回應矩陣的資料列。來源和目的地的基數有幾項大小限制： 指定為 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 尋找新的排序方式。如果 ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index 未在 X-Goog-FieldMask 標頭中要求，要求就會失敗。如果 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	省油路線。
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 包含指定為地址的路線控點地理編碼回應資訊。

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

LocalizedTime

時間的本地化說明。

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

位置

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

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

PolylineDetails

對應於折線特定索引或連續區段的詳細資料。假設折線包含 P_0、P_1、...、P_N 點 (以零為基準的索引)，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	省油路線。標示這個值的路線會根據燃油消耗量等環保參數進行最佳化。
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，具有相同的 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 時間的格式化文字表示法，以及對應的時區。

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 (以零為基準的索引)，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。