RoutingParameters

設定參數,用於設定回應中位置的轉送計算,包括沿途 (影響結果排名) 及計算結果的交通時間。

JSON 表示法
{
  "origin": {
    object (LatLng)
  },
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routingPreference": enum (RoutingPreference)
}
欄位
origin

object (LatLng)

選用設定。明確的路徑起點,會覆寫在折線中定義的起點。根據預設,系統會使用多邊形起點。

travelMode

enum (TravelMode)

選用設定。交通方式。

routeModifiers

object (RouteModifiers)

選用設定。路徑修飾符。

routingPreference

enum (RoutingPreference)

選用設定。指定如何計算轉送摘要。伺服器會嘗試使用所選的路由偏好設定來計算路徑。流量感知轉送偏好設定僅適用於 DRIVETWO_WHEELER travelMode

TravelMode

交通方式選項。這些選項會對應至 Routes API 提供的內容

列舉
TRAVEL_MODE_UNSPECIFIED 未指定交通方式。預設值為 DRIVE
DRIVE 搭乘客車。
BICYCLE 騎單車旅遊。searchAlongRouteParameters 不支援。
WALK 而且是步行前往。不支援 searchAlongRouteParameters
TWO_WHEELER 電動摩托車和摩托車等各種輪椅。請注意,這與涵蓋人力運輸的 BICYCLE 交通模式不同。不支援使用 searchAlongRouteParameters。僅支援兩輪車輛支援的國家/地區中列出的國家/地區。

RouteModifiers

封裝一組可選條件,用於計算路徑時滿足這些條件。

JSON 表示法
{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean
}
欄位
avoidTolls

boolean

選用設定。設為 true 時,在合理情況下避開收費道路,讓系統優先選擇不含收費路段的路線。僅適用於 DRIVETWO_WHEELER TravelMode

avoidHighways

boolean

選用設定。設為 true 時,在合理情況下避開高速公路,系統會優先避開不含高速公路的路線。僅適用於 DRIVETWO_WHEELER TravelMode

avoidFerries

boolean

選用設定。設為 true 時,在合理情況下避開渡輪,系統會優先選擇不含渡輪的路線。僅適用於 DRIVETWO_WHEELER TravelMode

avoidIndoor

boolean

選用設定。如果設為 true,系統會在合理情況下避免室內導航,並優先選擇不含室內導航的路線。僅適用於 WALK TravelMode

RoutingPreference

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

列舉
ROUTING_PREFERENCE_UNSPECIFIED 未指定轉送偏好設定。預設值為 TRAFFIC_UNAWARE
TRAFFIC_UNAWARE 在不考量即時路況的情況下計算路線。適合用於交通狀況不重要或不適用的情況。使用這個值會產生最低延遲時間。注意:對於 TravelMode DRIVETWO_WHEELER,系統會根據路網及與時間無關的平均路況來選擇路線和時間,不會考量目前路況。因此,路線可能會包含暫時封閉的道路。受到路網變動、平均路況更新,以及這項服務的分散性質影響,特定要求的結果可能會隨時間而改變。此外,在時間或頻率都沒有限制的情況下,即使兩條路線幾乎相同,結果還是有可能不同。
TRAFFIC_AWARE 計算將即時路況納入考量的路線。與 TRAFFIC_AWARE_OPTIMAL 相較,此類型會套用部分最佳化項目,大幅縮短延遲時間。
TRAFFIC_AWARE_OPTIMAL 計算將即時路況納入考量的路線,但不套用大多數效能最佳化設定。使用這個值會產生最高的延遲時間。