調整轉送偏好設定

路線計算 (包括重新規劃路線) 會傳回導航時間最短的路線，做為預設最佳路線。不過，您可以變更路徑策略，改為傳回較短的替代路徑。

「較短」是指根據預設費用模型，在最佳路徑中距離最短的路徑。較短路線可能不是絕對最短路線，因為該選項可能不是理想的替代路線。舉例來說，如果最短路線為 10 公里，導航時間為 50 分鐘，而另一條路線為 15 公里，導航時間僅 20 分鐘，則後者是最佳選擇，因為花費 30 分鐘減少 5 公里並非划算的交易。

行程的路線策略一經設定，在行程完成前不會變更。如要變更現有行程的路線規劃策略，請清除目的地，然後使用新的路線規劃策略重新設定目的地。

取得路線詳細資料

如要判斷特定中途點的最佳路徑策略，請呼叫 getRouteInfoForDestination()，取得預設最佳路徑和絕對最短路徑的路徑詳細資料。詳細資料包括抵達目的地路線控點所需的時間和距離。

這些詳細資料來自回呼中的 GMSNavigationRouteInfo。

範例

以下程式碼範例示範如何取得兩種路徑規劃策略的路徑詳細資料。

Swift

let routingOptions = GMSNavigationRoutingOptions()
navigator?.getRouteInfoForDestination(destination,
                                      routingOptions: routingOptions) { routeInfo in
  ...
}

Objective-C

GMSNavigationRoutingOptions *routingOptions =
    [[GMSNavigationRoutingOptions alloc] init];
[navigator getRouteInfoForDestination:destination
                   withRoutingOptions:routingOptions
                             callback:^(GMSNavigationRouteInfo *routeInfo){...}];

設定轉送策略

您可以透過 GMSNavigationRoutingOptions 設定轉送策略， 並在呼叫 setDestinations() 時設定 routingStrategy。

routingStrategy 採用下列其中一個列舉值：

列舉值說明
GMSNavigationRoutingStrategyDefaultBest 依據 Navigation SDK 預設費用模型排列路線。這是預設的轉送策略。
GMSNavigationRoutingStrategyShorter 依距離排序路線。排名最高的路線是傳回的路線中最短的路線。

範例

以下程式碼範例示範如何設定較短路徑的路線規劃策略。

Swift

let routingOptions = GMSNavigationRoutingOptions(routingStrategy: .shorter)
navigator?.setDestinations(destinations,
                           routingOptions: routingOptions) { routeStatus in
  ...
}

Objective-C

GMSNavigationRoutingOptions *routingOptions = [[GMSNavigationRoutingOptions alloc] initWithRoutingStrategy:GMSNavigationRoutingStrategyShorter];
[navigator setDestinations:destinations
            routingOptions:routingOptions
                  callback:^(GMSRouteStatus routeStatus){...}];

包含渡輪的路線

根據預設，Navigation SDK for iOS 會排除包含渡輪的路徑。如要將渡輪選項納入路線，請將 avoidsFerries 設為 false，調整這項路線偏好設定，顯示渡輪路段的行程。

範例

Swift

self.mapView.navigator?.avoidsFerries = false

Objective-C

self.mapView.navigator.avoidsFerries = NO

路線摘要格式

如果使用較短路線的路線規劃策略，路線上的標註會顯示距離詳細資料。但你可以改用預估到達時間註解。

設定路線標註格式

您可以在 GMSMapView 中設定 routeCalloutFormat，變更路線標註格式。routeCalloutFormat 採用下列其中一個列舉值：

列舉值說明
GMSNavigationRouteCalloutFormatDefault 使用預設最佳路線路徑策略時，會顯示剩餘時間。使用較短路徑的路線規劃策略時，顯示剩餘距離
GMSNavigationRouteCalloutFormatTime 顯示剩餘時間。
GMSNavigationRouteCalloutFormatDistance 顯示剩餘距離。

範例

下列程式碼範例示範如何設定路線標註格式。

Swift

self.mapView.routeCalloutFormat = .time

Objective-C

_mapView.routeCalloutFormat = GMSNavigationRouteCalloutFormatTime;