ルーティング設定の調整

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

「短い」とは、デフォルトの費用モデルに基づく最適なルートの中で最も短いルートを意味します。短いルートは、絶対的な最短ルートではない可能性があります。そのオプションが最適な代替手段ではない可能性があるためです。たとえば、最短ルートが 10 km で、所要時間が 50 分、別のルートが 15 km で、所要時間が 20 分の場合、後者のルートが最適です。5 km 短縮するために 30 分余計にかけるのは、トレードオフとして適切ではありません。

乗車ルートの戦略を設定すると、乗車が完了するまで変更されません。既存の旅行のルート検索方法を変更するには、目的地をクリアして、新しいルート検索方法で再度設定する必要があります。

ルートの詳細を取得しています

特定の経由地に最適なルート戦略を判断するには、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

ルートのコールアウトの形式

短いルートのルーティング戦略では、ルート沿いの吹き出しに距離の詳細が表示されます。代わりに、ETA コールアウトを使用できます。

ルート コールアウト形式の構成

ルート コールアウトの形式を変更するには、GMSMapView で routeCalloutFormat を設定します。routeCalloutFormat は、次の列挙型のいずれかの値を取ります。

列挙値説明
GMSNavigationRouteCalloutFormatDefault デフォルトの最適ルート ルーティング戦略を使用している場合、残り時間を表示します。短いルートのルーティング戦略を使用している場合に、残りの距離を表示します
GMSNavigationRouteCalloutFormatTime 残り時間を表示します。
GMSNavigationRouteCalloutFormatDistance 残りの距離を表示します。

例

次のコード例は、ルート コールアウトの形式を構成する方法を示しています。

Swift

self.mapView.routeCalloutFormat = .time

Objective-C

_mapView.routeCalloutFormat = GMSNavigationRouteCalloutFormatTime;