調整轉送偏好設定

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

「較短」是指根據預設成本模型，在最佳路線中最短的路線。較短路線不一定是絕對最短路線，因為該選項可能不是理想的替代方案。舉例來說，如果絕對最短路線為 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

路徑摘要格式

在較短路線轉送策略下，沿途的摘要會顯示距離詳細資料。但可以改用 ETA 摘要。

設定路徑摘要格式

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

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

範例

以下程式碼範例示範如何設定路線摘要格式。

Swift

self.mapView.routeCalloutFormat = .time

Objective-C

_mapView.routeCalloutFormat = GMSNavigationRouteCalloutFormatTime;