Method: computeRoutes

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}

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，這個欄位會包含最佳化的中繼路線控點順序。否則，這個欄位會留空。例如，如果輸入內容是 Origin: LA；中階路線控點：達拉斯、邦哥爾、鳳凰城等地區；目的地：紐約；而最佳化的中繼路線控點順序為鳳凰城、達拉斯、Bangor，則這個欄位會包含 [2, 0, 1] 值。輸入內容中提供的第一個中繼路線控點，且索引開頭為 0。

object (RouteLocalizedValues)

Route 屬性的文字表示法。

string

一種具備網路安全性的 Base64 編碼路徑符記，這個符記可傳送至 Navigation SDK，讓 Navigation SDK 在導航期間重建路徑，並在重新規劃路線時，配合呼叫 v2.computeRoutes 建立路徑時的原始意圖。客戶應將此權杖視為不透明 blob。請勿跨要求比較這個值，即使傳回完全相同的路線，這個憑證仍可能有所變更。注意：Route.route_token 僅適用於將 ComputeRoutesRequest.routing_preference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 的要求。不支援包含透過路線控點的要求 Route.route_token。

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}

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

{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}

string

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

object (Struct format)

使用 GeoJSON LineString 格式指定折線。

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}

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)

這個步驟所用的交通方式。

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum (Maneuver)

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

string

瀏覽此步驟的操作說明。

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (SpeedReadingInterval)

注意：這個欄位目前未填入資料。

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

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

object (LocalizedText)

未考量路況，以文字格式表示的時間長度。

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

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」是阿姆特拉克的 tripShortText 列車，該列車從加州聖荷西飛往加州沙加緬度的平日下午 15:10。

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object (TransitStop)

步驟的抵達站相關資訊。

string (Timestamp format)

步驟的預計到達時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (TransitStop)

步驟的出發停靠站相關資訊。

string (Timestamp format)

步驟的預計出發時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

大眾運輸停靠站的名稱。

object (Location)

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

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object (LocalizedTime)

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

object (LocalizedTime)

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

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object (LocalizedText)

在指定時區中以字串的形式指定的時間。

string

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

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object (TransitAgency)

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

string

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

string

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

string

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

string

此行相關圖示的 URI。

string

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

string

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

object (TransitVehicle)

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

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

這間運輸公司的名稱。

string

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

string

運輸公司的 URI。

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object (LocalizedText)

這輛車的名稱，大寫。

enum (TransitVehicleType)

使用的交通工具類型。

string

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

string

與此車輛類型相關聯圖示的 URI (根據本地交通標誌)。

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (TollInfo)

包含特定 RouteLeg 的收費路段相關資訊。只有在 RouteLeg 上需要停留時間時，才會填入這個欄位。如果已設定這個欄位，但預估價格子欄位未填入值，則道路應該會包含收費路段，但不顯示預估價格。如果這個欄位不存在，RouteLeg 上就不會出現任何收費站。

object (SpeedReadingInterval)

速度讀取間隔，詳細說明交通密度。適用於 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 轉送偏好設定間隔會涵蓋 RouteLeg 的整條折線，而且不會重疊。指定間隔的開始時間與前一個間隔的端點相同。

範例：

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

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

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

object (LocalizedText)

將路況納入考量以文字形式計算的持續時間。注意：如果您沒有要求流量資訊，這個值將會與 staticDuration 相同。

object (LocalizedText)

未考量路況，以文字格式表示的時間長度。

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object (MultiModalSegment)

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

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object (NavigationInstruction)

多模態區隔的導覽指示。

enum (RouteTravelMode)

多模態區隔的交通方式。

integer

對應的 RouteLegStep 索引，是多模態片段的開頭。

integer

多模態片段結尾的對應 RouteLegStep 索引。

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

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

object (LatLng)

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

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object (LocalizedText)

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

object (LocalizedText)

考量路況 (以文字格式表示) 的時間長度。注意：如果您沒有要求流量資訊，這個值將會與 staticDuration 相同。

object (LocalizedText)

未考量路況，以文字格式表示的時間長度。

object (LocalizedText)

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

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object (GeocodedWaypoint)

已進行地理編碼的路線控點。

object (GeocodedWaypoint)

目的地已地理編碼的路線控點。

object (GeocodedWaypoint)

一系列經過地理編碼的路點清單，每個路徑皆包含一個索引欄位，該欄位會依照要求中所指定的順序，與路線控點的零位置位置對應。

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object (Status)

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

string

結果的類型，格式為 0 或多個型別標記。支援的類型：地址類型和地址元件類型。

boolean

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

string

這個結果的地點 ID。

integer

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