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

注意：只有將 ComputeRoutesRequest.routing_preference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 的要求，才能使用 Route.route_token。如果要求含有中途行經的路線控點，則不支援 Route.route_token。

object (PolylineDetails)

內含折線詳細資料的相關資訊。

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

時刻表和看板上顯示的文字，可供乘客識別大眾運輸行程。這段文字應可識別服務日的特定行程。舉例來說，Amtrak 列車「538」於平日 15:10 從加州聖荷西出發，前往加州沙加緬度。tripShortText

object (TransitStop)

步驟的抵達站點資訊。

string (Timestamp format)

該步驟的預計到達時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

object (TransitStop)

步驟的起點站資訊。

string (Timestamp format)

該步驟的預計出發時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

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 有收費路段，且要求中包含 ComputeRoutesRequest.extra_computations 的 TOLLS 時，才會填入這個欄位。如果已設定這個欄位，但未填入 estimatedPrice 子欄位，表示道路有收費路段，但我們不知道預估價格。如果 tollInfo 不存在，則 RouteLeg 不會收取通行費。

object (SpeedReadingInterval)

顯示交通密度的速度讀取間隔。只有在要求具有 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference 值，且 TRAFFIC_ON_POLYLINE 包含在 ComputeRoutesRequest.extra_computations 中時，才會填入這個欄位。這些間隔會涵蓋 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 (FlyoverInfo)

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

object (NarrowRoadInfo)

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

enum (RoadFeatureState)

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

object (PolylinePointIndex)

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

integer

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

integer

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

enum (RoadFeatureState)

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

object (PolylinePointIndex)

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

object (GeocodedWaypoint)

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

object (GeocodedWaypoint)

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

object (GeocodedWaypoint)

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

object (Status)

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

string

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

boolean

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

string

這筆結果的地點 ID。

integer

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