ComputeRoutesRequest

v1alpha.computeRoutes 要求訊息。

JSON 表示法
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean
}
欄位
origin

object (Waypoint)

必要欄位。來源路線控點。

destination

object (Waypoint)

必要欄位。目的地路線控點。

intermediates[]

object (Waypoint)

選用設定。沿途一組路線控點 (不含終點站),用來在 或 經過。最多支援 25 個中繼路線控點。

travelMode

enum (RouteTravelMode)

選用設定。指定交通方式,

routingPreference

enum (RoutingPreference)

選用設定。指定如何計算路徑。伺服器會嘗試使用所選轉送偏好設定來計算路徑。如果轉送偏好設定導致錯誤或過長的延遲時間,則會傳回錯誤。日後如果偏好的選項無法提供有效結果,我們可能會導入備用機制,以便使用其他選項。只有在 travelModeDRIVETWO_WHEELER 時,您才能指定此選項,否則要求會失敗。

polylineQuality

enum (PolylineQuality)

選用設定。指定您對折線品質的偏好設定。

polylineEncoding

enum (PolylineEncoding)

選用設定。指定折線的偏好編碼。

departureTime

string (Timestamp format)

選用設定。出發時間。如未設定這個值,則這個值會預設為您提出要求的時間。如果將這個值設為已發生的時間,要求就會失敗。

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

computeAlternativeRoutes

boolean

指定是否要計算路線以外的替代路徑。

routeModifiers

object (RouteModifiers)

選用設定。一組滿足條件,這些條件會影響路線的計算方式。

languageCode

string

選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如需支援的語言清單,請參閱語言支援。如未提供這個值,系統會根據路線要求的位置推斷顯示語言。

units

enum (Units)

選用設定。指定顯示欄位的測量單位。這包括 NavigationInstruction 中的 instruction 欄位。路線、路段、步數和所需時間的測量單位不受這個值影響。如未提供這個值,系統會根據要求的位置推斷顯示單位。

optimizeWaypointOrder

boolean

如果 optWaypointOrder 設定為 true,系統會嘗試重新排序指定的中間路點,盡可能降低路線的整體成本。如果有任何中繼路點是透過路線控點傳送,要求就會失敗。使用 ComputeRoutesResponse.Routes.optimized_中間_waypoint_index 尋找新的排序方式。如果 X-Goog-FieldMask 標頭未要求 route.optimized_中繼_waypoint_index ,要求失敗。如果將 optWaypointOrder 設為 false,ComputeRoutesResponse.optimized_中繼_waypoint_index 為空白。