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，否則所有訊息都會正常顯示。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。
  • 如果您將起點數量設為 TRAFFIC_AWARE_OPTIMAL，則目的地數量 × 目的地數量不得大於 100。
  • 如果出發地的旅遊_價格設為 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」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。請參閱「語言支援」部分，查看支援的語言清單。如未提供這個值，系統會從第一個來源的位置推測顯示語言。
region_code

string

(選填) 區碼，以 ccTLD (「頂層網域」) 的兩位字元值指定詳情請參閱 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
extra_computations[]

ExtraComputation

(選填) 可能會用來完成要求的額外運算清單。注意：這些額外計算可能會傳回回應中的額外欄位。這些額外欄位也必須在回應遮罩中傳回，
traffic_model

TrafficModel

(選填) 指定計算交通時間時要採用的假設。這項設定會影響 RouteMatrixElement 中持續時間欄位傳回的值，其中包含根據歷來平均值預估的交通時間。RoutingPreference 到 TRAFFIC_AWARE_OPTIMAL，並將 RouteTravelMode 變更為 DRIVE。如果要求流量且未指定 TrafficModel，預設值為 BEST_GUESS。
transit_preferences

TransitPreferences

(選填) 指定會影響 TRANSIT 路線傳迴路徑的偏好設定。注意：只有在 RouteTravelMode 設為 TRANSIT 時，您才能指定 transit_preferences。

額外運算

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

列舉
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。
arrival_time

Timestamp

(選填) 抵達時間。注意：只有在 RouteTravelMode 設為 TRANSIT 時才能設定。您可以指定 departure_time 或 arrival_time，但不能同時指定兩者。
compute_alternative_routes

bool

(選填) 指定除了路線以外，是否計算替代路徑。如果要求具有中繼路線控點，就不會傳回替代路徑。
route_modifiers

RouteModifiers

(選填) 滿足一組條件會影響路線的計算方式。
language_code

string

(選填) BCP-47 語言代碼，例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。請參閱「語言支援」部分，查看支援的語言清單。如果未提供這個值，系統會根據路徑要求的位置推測顯示語言。
region_code

string

(選填) 區碼，以 ccTLD (「頂層網域」) 的兩位字元值指定詳情請參閱 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
units

Units

(選填) 指定顯示欄位的測量單位。這些欄位包含 NavigationInstruction 中的 instruction 欄位。路線、路段、步數和時間長度的測量單位，不會受到這個值影響。如未提供這個值，系統則會從第一個來源的位置推測顯示單位。
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 參照路徑計算會將各種參數納入考量，進而產生最佳燃油路線。
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。

額外運算

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

列舉
EXTRA_COMPUTATION_UNSPECIFIED 未使用。包含這個值的要求將會失敗。
TOLLS 路線的收費資訊。
FUEL_CONSUMPTION 路線的燃料耗量。
TRAFFIC_ON_POLYLINE 路線的封閉折線。
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS 導覽操作說明 (以格式化的 HTML 文字字串表示)。這類內容應依原樣讀取。此內容僅供顯示。請勿以程式輔助方式剖析。

參考路徑

ComputeRoutesRequest 支援的參考路徑。

列舉
REFERENCE_ROUTE_UNSPECIFIED 未使用。包含這個值的要求會失敗。
FUEL_EFFICIENT 燃油效率。系統會為標有這個值的路徑，決定最佳參數 (例如燃料消耗量)。

ComputeRoutesResponse

ComputeRoute 轉送回應訊息。

欄位
routes[]

Route

包含指定 compute_alternatives_routes 時，包含經計算的路線陣列 (最多三個)，而且即使您不使用，也只會有一個路線。如果這個陣列包含多個項目，第一個項目是建議採用的路徑。如果陣列為空白，則表示找不到路線。
fallback_info

FallbackInfo

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

GeocodingResults

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

備用資訊

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

欄位
routing_mode

FallbackRoutingMode

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

FallbackReason

使用備用回應的原因，而非原始回應。只有在觸發備用廣告模式且傳回備用廣告回應時，系統才會填入這個欄位。

備用原因

使用備用回應的原因。

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

備用轉送模式

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

列舉
FALLBACK_ROUTING_MODE_UNSPECIFIED 未使用。
FALLBACK_TRAFFIC_UNAWARE 表示用於計算回應的 TRAFFIC_UNAWARE google.maps.routing.v2.RoutingPreference。
FALLBACK_TRAFFIC_AWARE 表示用於計算回應的 TRAFFIC_AWARE RoutingPreference。

GeocodedWaypoint

路線控點用地點的詳細資料。僅填入地址路線控點。加入地理編碼結果，以便判斷地址的地理編碼方式。

欄位
geocoder_status

Status

指出地理編碼作業產生的狀態碼。
type[]

string

結果的類型，包含 0 或多個類型標記。支援的類型：https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types
partial_match

bool

指出地理編碼器沒有傳回與原始要求完全相符的結果，但可以比對部分要求的地址。建議您比對原始要求，檢查是否有拼寫錯誤和/或不完整的地址。
place_id

string

這筆結果的地點 ID。
intermediate_waypoint_request_index

int32

要求中對應中繼路線控點的索引。只有在對應的路線控點為中繼路線控點時，才會填入這項資訊。

地理編碼結果

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

欄位
origin

GeocodedWaypoint

起點地理編碼的路線控點。
destination

GeocodedWaypoint

目的地地理編碼的路線控點。
intermediates[]

GeocodedWaypoint

中繼地理編碼路線控點清單，每個索引包含索引欄位，包含路線控點中以零為基準的座標點。

本地化時間

本地化時間說明。

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

封裝經過編碼的折線。

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

string

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

Struct

使用 GeoJSON LineString 格式指定折線

折線編碼

指定要傳回的折線類型。

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

折線品質

指定折線品質的一組值。

列舉
POLYLINE_QUALITY_UNSPECIFIED 未指定折線品質偏好設定。預設值為 OVERVIEW。
HIGH_QUALITY 指定高品質折線 (使用超過 OVERVIEW 點的點)，但回應大小會增加。如果需要更高的精確度，請使用這個值。
OVERVIEW 指定總覽折線，使用少量點組成。顯示路徑總覽時，請使用這個值。相較於使用 HIGH_QUALITY 選項，使用這個選項會使要求延遲時間更短。

路線

包含一條路線，由一系列相連接的路段，包括起點、終點和中繼路線控點。

欄位
route_labels[]

RouteLabel

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

RouteLeg

組成路線的一組路段 (路線控點之間的路徑區隔)。每個路段都會對應到兩個非 via 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，這個欄位會包含最佳化路線控點的最佳化順序。否則，這個欄位會空白。舉例來說，如果您輸入 Origin: LA;中級路線控點：Dallas、Bangor、Phoenix、Destination: New York；最佳化最佳化路線控點順序為 Phoenix、Dalas、Bangor，這個欄位就會包含 [2, 0, 1]。從輸入中提供的第一個中繼路線控點開頭 0。
localized_values

RouteLocalizedValues

Route 的屬性文字表示法。
route_token

string

網頁式 Base64 編碼路徑權杖，可傳遞至 Navigation SDK，讓 Navigation SDK 在導航期間重新建構路徑，而且在重新轉送路徑時，則藉由呼叫 ComputeRoutes 來遵循原始意圖。客戶應將這組權杖視為不透明的 blob。本功能並不適合讀取或變動。注意：Route.route_token 僅適用於將 ComputeRoutesRequest.routing_preference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 的要求。Route.route_token 不支援含有通道路線控點的要求。

RouteLocalizedValues (路徑本地化值)

特定屬性的文字表示法。

欄位
distance

LocalizedText

以文字形式呈現的移動距離。
duration

LocalizedText

將路況納入考量的時間，以文字形式顯示。注意事項：如未要求流量資訊，這個值會與 static_duration 值相同。
static_duration

LocalizedText

將流量納入考量，並以文字形式表示。
transit_fare

LocalizedText

以文字表示的大眾運輸車資。

路徑標籤

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

列舉
ROUTE_LABEL_UNSPECIFIED 預設 - 未使用。
DEFAULT_ROUTE 用於計算路徑的預設「最佳」路徑。
DEFAULT_ROUTE_ALTERNATE 預設的「最佳」路線的替代選項。指定 compute_alternative_routes 時，將傳回這類路線。
FUEL_EFFICIENT 燃油效率。系統會為標有這個值的路徑，判斷是否要針對燃料消耗量 (例如燃料消耗量) 進行最佳化。

路徑規劃

包含非 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 中的步驟總覽資訊。這個欄位只會針對 TRANSIT 路線填入。

RouteLegLocalizedValues

特定屬性的文字表示法。

欄位
distance

LocalizedText

以文字形式呈現的移動距離。
duration

LocalizedText

將路況考慮到文字的時間長度，以文字形式呈現。注意事項：如未要求流量資訊，這個值會與 static_duration 值相同。
static_duration

LocalizedText

將流量納入考量，並以文字形式表示。

步驟總覽

提供 RouteLegStep 清單的總覽資訊。

欄位
multi_modal_segments[]

MultiModalSegment

關於 RouteLeg.steps 各種多重模組區隔的摘要資訊。如果步驟中有任何 RouteLeg 未包含任何多重模組區隔，則系統不會填入這個欄位。

多模組區隔

提供 RouteLeg.steps 各種多重模組區隔的摘要資訊。多重模組區隔是指具有相同 RouteTravelMode 的一或多個連續 RouteLegStep。如果步驟中有任何 RouteLeg 未包含任何多重模組區隔，則系統不會填入這個欄位。

欄位
navigation_instruction

NavigationInstruction

多重模組區隔的 NavigationInstruction。
travel_mode

RouteTravelMode

多重模組區隔的交通方式。
step_start_index

int32

多重模組區隔開始時的對應 RouteLegStep 索引。
step_end_index

int32

多重模組區隔結尾的對應 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 站，停靠站就會傳回 3。
trip_short_text

string

顯示在時間表和看板上的文字，用於識別乘客的大眾運輸行程。文字都應該在服務日內明確識別行程。例如，「538」是 Amtrak 火車的 trip_short_text，從加州平日的午夜 15:10 出發至加州 Sacramento。

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 上收費路段時，系統才會填入這個欄位。如果您設定了這個欄位，但系統未填寫 shipping_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

要求中目的地的零索引索引。

本地化值

特定屬性的文字表示法。

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

包含路線上的收費路段資訊。只有在路線上有收費路段時，才會填入這個欄位。如果設定了這個欄位，但系統未填寫估計價格子欄位，那麼路線就會包含收費路段，但預估價格不明。如果不設定這個欄位，路線上就不會出現收費路段。
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 要求傳回這個屬性，且僅適用於所有大眾運輸步驟皆有車資資訊的路線。

路徑旅遊模式

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

列舉
TRAVEL_MODE_UNSPECIFIED 未指定交通方式。預設值為 DRIVE。
DRIVE 旅客搭乘的車輛。
BICYCLE 騎單車。
WALK 散步，
TWO_WHEELER 雙輪驅動車輛。例如摩托車。請注意，這與採用人體模式的 BICYCLE 交通方式不同。
TRANSIT 根據大眾運輸路線 (如有) 搭乘大眾運輸工具。

轉送偏好設定

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

列舉
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 系統偵測到交通壅塞情形。

收費資訊

封裝 Route 或 RouteLeg 的收費資訊。

欄位
estimated_price[]

Money

相應 Route 或 RouteLeg 的娃娃金額。這份清單列出各站收費站的相應金額。一般來說，這份清單只會列出一個幣別為收費路段的項目。如果是國外旅遊，這份清單可能會列出以不同貨幣計算的收費路段。

收費通行卡

我們支援的全球道路收費通行證清單。

列舉
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 印度商品
MX_IAVE 墨西哥收費站。https://iave.capufe.gob.mx/#/
MX_PASE 墨西哥 https://www.pase.com.mx
MX_QUICKPASS 墨西哥 https://初次 davial.com/fast-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 ALAL，美國。
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS 美國加州
US_CA_FASTRAK 美國加州
US_CA_FASTRAK_CAV_STICKER 指示駕駛除了 DMV 核發的 Clean Air Vehicle (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 KS，美國。
US_KS_KTAG KS，美國。
US_KS_NATIONALPASS KS，美國。
US_KS_PREPASS_ELITEPASS KS，美國。
US_LA_GEAUXPASS 洛杉磯，美國。
US_LA_TOLL_TAG 洛杉磯，美國。
US_MA_EZPASSMA 美國麻薩諸塞州
US_MD_EZPASSMD 美國 MD，
US_ME_EZPASSME MEA，美國。
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 美國 MN
US_NC_EZPASSNC NC、美國。
US_NC_PEACH_PASS NC、美國。
US_NC_QUICK_PASS NC、美國。
US_NH_EZPASSNH 美國新西蘭。
US_NJ_DOWNBEACH_EXPRESS_PASS NJ，美國。
US_NJ_EZPASSNJ NJ，美國。
US_NY_EXPRESSPASS 美國紐約。
US_NY_EZPASSNY 美國紐約。
US_OH_EZPASSOH 美國俄亥俄州
US_PA_EZPASSPA PA、美國。
US_RI_EZPASSRI 插頁式
US_SC_PALPASS 南卡羅來納州，
US_TX_AVI_TAG 美國 TX
US_TX_BANCPASS 美國 TX
US_TX_DEL_RIO_PASS 美國 TX
US_TX_EFAST_PASS 美國 TX
US_TX_EAGLE_PASS_EXPRESS_CARD 美國 TX
US_TX_EPTOLL 美國 TX
US_TX_EZ_CROSS 美國 TX
US_TX_EZTAG 美國 TX
US_TX_FUEGO_TAG 美國 TX
US_TX_LAREDO_TRADE_TAG 美國 TX
US_TX_PLUSPASS 美國 TX
US_TX_TOLLTAG 美國 TX
US_TX_TXTAG 美國 TX
US_TX_XPRESS_CARD 美國 TX
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT，美國。
US_VA_EZPASSVA 美國維吉尼亞州
US_WA_BREEZEBY 美國華盛頓州
US_WA_GOOD_TO_GO 美國華盛頓州
US_WV_EZPASSWV 美國維吉尼亞州
US_WV_MEMORIAL_BRIDGE_TICKETS 美國維吉尼亞州
US_WV_NEWELL_TOLL_BRIDGE_TICKET 美國維吉尼亞州

車流量模型

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

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

運輸公司

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

欄位
name

string

這間運輸公司的名稱。
phone_number

string

運輸公司在地區專屬的電話號碼。
uri

string

運輸公司的 URI。

大眾運輸路線

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

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

這條大眾運輸路線的交通工具類型。

大眾運輸偏好設定

影響 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 的組合。

大眾運輸站

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

欄位
name

string

轉運站的名稱。
location

Location

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

大眾運輸車輛

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

欄位
name

LocalizedText

這輛車的名稱 (大小寫)。
type

TransitVehicleType

使用的交通工具類型。
icon_uri

string

與這個交通工具類型相關聯的圖示 URI。
local_icon_uri

string

與這個交通工具類型相關的圖示 URI，以本地交通標誌為準。

大眾運輸交通工具類型

大眾運輸路線的交通工具類型。

列舉
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 英制單位 (英文)。

交通工具排放量類型

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

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

車輛資訊

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

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

與路線控點相關聯的搜尋點地點 ID。
address

string

清楚易懂的地址或 Plus Code。詳情請參閱 https://plus.codes。