Method: computeRoutes

enum (RouteLabel)

Route 的標籤，可用於識別路線的特定屬性，以便與其他路線進行比較。

object (RouteLeg)

路線的路段集合 (路線控點之間的路徑區段)。每個路段都對應至兩個非 via Waypoints 之間的行程。舉例來說，沒有中繼路線控點的路線只有一個路段。路線包含一個非 via 中繼路線控點，則有兩個路段。路線包含一個 via 中繼路線控點，則有一個路段。路段的順序與路線控點的順序相符，從 origin 到 intermediates 再到 destination。

integer

路線的移動距離 (以公尺為單位)。

string (Duration format)

導航路線所需的時間長度。如果您將 routingPreference 設為 TRAFFIC_UNAWARE，則這個值與 staticDuration 相同。如果您將 routingPreference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL，系統會在計算這個值時考量交通狀況。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

string (Duration format)

不考量交通狀況的路線行駛時間。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

object (Polyline)

整體路線折線。這條折線是所有 legs 的組合折線。

string

路線說明。

string

顯示路線時要顯示的警告陣列。

object (Viewport)

折線的可視區域定界框。

object (RouteTravelAdvisory)

路線的其他資訊。

integer

如果您將 optimizeWaypointOrder 設為 true，這個欄位就會包含最佳化中繼路線點的順序。否則，這個欄位會空白。舉例來說，如果您輸入的起點為洛杉磯；中繼點為達拉斯、邦戈和鳳凰城；目的地為紐約；最佳化中繼點順序為鳳凰城、達拉斯和邦戈，則這個欄位會包含 [2, 0, 1] 的值。在輸入內容中提供的第一個中繼路標，索引會從 0 開始。

object (RouteLocalizedValues)

Route 屬性的文字表示法。

string

不透明權杖，可傳遞至 Navigation SDK，以便在導航期間重建路線，並在重新導航時，遵循建立路線時的原始意圖。將這個符記視為不透明 blob。請勿比較不同要求的值，因為即使服務傳回完全相同的路線，值也可能會有所變動。

注意：Route.route_token 僅適用於將 ComputeRoutesRequest.routing_preference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 的要求。對於含有經過路線控點的要求，系統不支援 Route.route_token。

integer

路線路段的移動距離，以公尺為單位。

string (Duration format)

航程所需的時間長度。如果 route_preference 設為 TRAFFIC_UNAWARE，則這個值與 staticDuration 相同。如果 route_preference 是 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL，則系統會在計算這個值時考量交通狀況。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

string (Duration format)

路段的實際行程時間，計算時不考量交通狀況。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

object (Polyline)

這個路段的整體折線，包含每個 step 的折線。

object (Location)

這個路段的起點。這個位置可能與提供的 origin 不同。舉例來說，如果提供的 origin 不在道路附近，則表示這是道路上的某個點。

object (Location)

這個路段的終點位置。這個位置可能與提供的 destination 不同。舉例來說，如果提供的 destination 不在道路附近，則表示這是道路上的某個點。

object (RouteLegStep)

這個路段內的步驟陣列，用於表示路段內的區段。每個步驟都代表一個導覽指示。

object (RouteLegTravelAdvisory)

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

object (RouteLegLocalizedValues)

RouteLeg 屬性的文字表示法。

object (StepsOverview)

這個 RouteLeg 中的步驟概覽資訊。這個欄位只會填入大眾運輸路線的資料。

string

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

object (Struct format)

使用 GeoJSON LineString 格式指定折線。

integer

這個步驟的移動距離，以公尺為單位。在某些情況下，這個欄位可能沒有值。

string (Duration format)

不考量交通狀況的這個步驟所需的移動時間。在某些情況下，這個欄位可能沒有值。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

object (Polyline)

與此步驟相關聯的折線。

object (Location)

這個步驟的起點。

object (Location)

這個步驟的結束位置。

object (NavigationInstruction)

導航指示。

object (RouteLegStepTravelAdvisory)

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

object (RouteLegStepLocalizedValues)

RouteLegStep 屬性的文字表示法。

object (RouteLegStepTransitDetails)

如果旅遊模式為 TRANSIT，則此步驟的詳細資料。

enum (RouteTravelMode)

這個步驟使用的交通模式。

enum (Maneuver)

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

string

操作說明。

object (SpeedReadingInterval)

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

object (LocalizedText)

以文字形式表示的移動距離。

object (LocalizedText)

不考量交通狀況的時間長度，以文字形式表示。

object (TransitStopDetails)

步驟的抵達和出發站資訊。

object (TransitDetailsLocalizedValues)

RouteLegStepTransitDetails 屬性的文字表示法。

string

指定這條路線的行進方向，如交通工具或出發站上所標示的方向。方向通常是終點站。

string (Duration format)

指定從目前同一站點出發的預計間隔時間。例如，假設間隔秒數值為 600，則表示如果錯過上一班公車，下一班預計要等 10 分鐘。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

object (TransitLine)

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

integer

從出發站到抵達站的停靠站數量。這個計數包含抵達站，但不包含出發站。舉例來說，如果路線從 A 站出發，途經 B 和 C 兩站，最後抵達 D 站，

stopCount

會傳回 3。

string

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

object (TransitStop)

步驟的抵達站資訊。

string (Timestamp format)

步驟的預計到達時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (TransitStop)

步驟的出發站資訊。

string (Timestamp format)

步驟的預估出發時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string

大眾運輸停靠站的名稱。

object (Location)

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

object (LocalizedTime)

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

object (LocalizedTime)

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

object (LocalizedText)

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

string

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

object (TransitAgency)

營運這條大眾運輸路線的大眾運輸公司 (或多家公司)。

string

這條大眾運輸路線的全名，例如「8 Avenue Local」。

string

這條大眾運輸路線的 URI (由運輸公司提供)。

string

這條路線常用的標示顏色。以十六進制表示。

string

與這條路線相關聯的圖示 URI。

string

這條大眾運輸路線的簡稱。這個名稱通常是一個路線編號，例如「M7」或「355」。

string

這條路線常用的文字顏色，以十六進制表示。

object (TransitVehicle)

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

string

運輸公司的名稱。

string

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

string

運輸公司的 URI。

object (LocalizedText)

車輛名稱 (大寫)。

enum (TransitVehicleType)

使用的車輛類型。

string

與此交通工具類型相關聯的圖示 URI。

string

此交通工具類型相關圖示的 URI (根據本地交通標誌)。

object (TollInfo)

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

object (SpeedReadingInterval)

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

範例：

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

object (LocalizedText)

以文字形式表示的移動距離。

object (LocalizedText)

時間長度，以文字形式表示，並依查詢的地區進行本地化。考量路況。注意：如果您未要求流量資訊，這個值就會與 staticDuration 相同。

object (LocalizedText)

不考量交通狀況的時間長度，以文字形式表示。

object (MultiModalSegment)

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

object (NavigationInstruction)

多模態路段的 NavigationInstruction。

enum (RouteTravelMode)

多模態路段的交通方式。

integer

對應的 RouteLegStep 索引，是多模態區段的起始位置。

integer

對應的 RouteLegStep 索引，是多模態區段的結尾。

object (LatLng)

必要欄位。可視區域的低點。

object (LatLng)

必要欄位。可視區域的高點。

object (LocalizedText)

以文字形式表示的移動距離。

object (LocalizedText)

時間長度，以文字形式表示，並依查詢的地區進行本地化。考量路況。注意：如果您未要求擷取流量資訊，這個值會與 staticDuration 相同。

object (LocalizedText)

不考量交通狀況的時間長度，以文字形式表示。

object (LocalizedText)

以文字形式表示的大眾運輸票價。

object (GeocodedWaypoint)

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

object (GeocodedWaypoint)

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

object (GeocodedWaypoint)

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

object (Status)

表示地理編碼作業產生的狀態碼。

string

結果的類型，以零或多個類型標記的形式呈現。支援的類型：地址類型和地址元件類型。

boolean

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

string

這個結果的地點 ID。

integer

要求中對應中繼路線點的索引。只有在對應路線控點是中繼路線控點時，才會填入這個值。