ルーティング設定の調整

ルート計算（ルート変更を含む）では、所要時間が最も短いルートがデフォルトの最適ルートとして返されます。ただし、ルーティング戦略を変更して、代わりにより短いルート候補が返されるようにすることもできます。

「短い」とは、デフォルトの費用モデルに基づく最適なルートの中で最も短いルートを指します。短いルートが最短ルートとは限りません。そのルートが最適な選択肢ではない場合があります。たとえば、最短のルートでは 10 km で所要時間が 50 分、別のルートでは 15 km で所要時間が 20 分の場合、5 km 短縮するために 30 分も費やすのは良いトレードオフではないため、2 つ目のルートを選択するのが最適です。

ルートの戦略を設定すると、そのルート完了まで変更されません。既存のルートのルーティング戦略を変更するには、目的地を消去して、新しいルーティング戦略で再び設定する必要があります。

ルートの詳細の取得

特定のウェイポイントに最適なルート戦略を判断するには、getRouteInfoForDestination() を呼び出して、デフォルトの最適なルートと絶対的に短いルートの両方のルート詳細を取得します。詳細には、所要時間と目的地のウェイポイントまでの距離が含まれます。

これらの詳細は、コールバックの GMSNavigationRouteInfo から取得されます。

例

次のコードサンプルは、2 つのルーティング戦略のそれぞれについてルートの詳細を取得する方法を示しています。

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;