ルート逸脱を処理する
ルートの逸脱が検出された際に、目的地へのルートを変更してユーザーを誘導するかどうかをdistanceInMetersに基づいて決定できます。完全なルート再計算では、同じルート パラメーターを使用できます。
この仕組みは次のとおりです。
- 絶え間なく
RouteDeviationイベントをリッスンします。 - メートルの偏差に基づいて、次に行う操作を決定します。例：
Routeを新しく作成し、以前のRouteの代わりにナビゲーションに使用します。- または、
returnToRoute()を使用し、既存のRouteを使用し続けます。 - 変更なしで、古い
Routeへの追随を続けます。リスク：偏差が大きすぎると、ユーザーは次の運転操作に到達しなかったり、運転操作を失敗したりする可能性があります。
逸脱に関する通知を受信する
// Conform to RouteDeviationDelegate.
// Notifies on a possible deviation from the route.
func onRouteDeviation(_ routeDeviation: RouteDeviation) {
guard let route = visualNavigator.route else {
// May happen in rare cases when route was set to nil inbetween.
return
}
// Get current geographic coordinates.
var currentGeoCoordinates = routeDeviation.currentLocation.originalLocation.coordinates
if let currentMapMatchedLocation = routeDeviation.currentLocation.mapMatchedLocation {
currentGeoCoordinates = currentMapMatchedLocation.coordinates
}
// Get last geographic coordinates on route.
var lastGeoCoordinates: GeoCoordinates?
if let lastLocationOnRoute = routeDeviation.lastLocationOnRoute {
lastGeoCoordinates = lastLocationOnRoute.originalLocation.coordinates
if let lastMapMatchedLocationOnRoute = lastLocationOnRoute.mapMatchedLocation {
lastGeoCoordinates = lastMapMatchedLocationOnRoute.coordinates
}
} else {
print("User was never following the route. So, we take the start of the route instead.")
lastGeoCoordinates = route.sections.first?.departurePlace.originalCoordinates
}
guard let lastGeoCoordinatesOnRoute = lastGeoCoordinates else {
print("No lastGeoCoordinatesOnRoute found. Should never happen.")
return
}
let distanceInMeters = currentGeoCoordinates.distance(to: lastGeoCoordinatesOnRoute)
print("RouteDeviation in meters is \(distanceInMeters)")
// Now, an application needs to decide if the user has deviated far enough and
// what should happen next: For example, you can notify the user or simply try to
// calculate a new route. When you calculate a new route, you can, for example,
// take the current location as new start and keep the destination - another
// option could be to calculate a new route back to the lastMapMatchedLocationOnRoute.
// At least, make sure to not calculate a new route every time you get a RouteDeviation
// event as the route calculation happens asynchronously and takes also some time to
// complete.
// The deviation event is sent any time an off-route location is detected: It may make
// sense to await around 3 events before deciding on possible actions.
}
上の例では、RouteDeviation：distanceInMeters に含まれる座標に基づいて距離が計算されます。これはルート上の予想位置と実際の位置との間の直線距離です。遠すぎると思われる場合は、新しく計算したルートを visualNavigator インスタンスに設定できます。これにより、それ以降のイベントはすべて、新しいルートに基づくようになります。
走行ガイダンス シナリオでは、lastLocationOnRoute および mapMatchedLocation が null になる可能性があります。routeDeviation.lastLocationOnRoute が null の場合、ユーザーはルートにまったく追随していませんでした。これは、開始地点が道路ネットワークから遠く離れているときに発生する可能性があります。通常、Navigator / VisualNavigator は道路に対して Location の更新のマッチングを試みます。ドライバーが遠すぎると、位置情報をマッチングできません。
注イベントは非同期で配信されるため、キュー内の以前のイベントが引き続き古いルートに対して 1 回配信される可能性があります。必要に応じて、新しいルートを設定した後に新しいデリゲートを添付することで、これを防ぐことができます。
Navigation のサンプル アプリで偏差の検出方法を確認できます。
RouteDeviation イベントは、ドライバーが元のルートを離れることを検出するために使用できます。これは誤って行われる場合と、ルートの候補およびルート オプションについて以前に行った選択を無視してドライバーが運転中に目的地まで別のルートを利用することにしたなど意図的に行われる場合があります。
上に示したように、ドライバーの現在地からルート上の最後の既知の位置までの距離を検出できます。この距離に基づいて、新しいルート全体を計算するか、ユーザーを元のルートに誘導してルートの候補およびルート オプションの選択を維持するかがアプリケーションで決定される場合があります。
HERE SDK はルートを自動的に再計算せず、逸脱距離のみを通知します。したがって、ルートに戻る方法についてのロジックはアプリ側で実装する必要があります。
注
RouteDeviationイベントは、新しい位置情報の更新ごとに起動されます。不必要なイベントの処理を回避するため、数秒間待って、ドライバーがまだ逸脱しているかどうかを確認することをお勧めします。イベントが起動しなかった場合は、ドライバーがルートに戻ったということです。ルート計算は非同期で行われ、新しいルート計算をいつどのように開始するかはアプリによって決定されます。ただし、NavigatorまたはVisualNavigatorインスタンスへのナビゲーション中はいつでも新しいルートを設定でき、その先のイベントは新しく設定されたRouteインスタンスに基づいて更新されます。
ユーザーが道路外にいる場合があることも考える必要があります。新しいルートが設定された後もユーザーがまだ道路外におり、そのためユーザーがまだルートを追随できない場合があります。このような場合も新たに設定されたルートの逸脱イベントは受信され、routeDeviation.lastLocationOnRoute が null になります。ユーザーの現在地が変わっていない場合は、新しいルート計算を再度開始しないようにすることをお勧めします。
HERE SDK には、検出されたルート逸脱に対応する API がいくつかあります。
RoutingEngineによって新規または更新されたRouteOptionsでルート全体を再計算し、新しいルートの候補を提供します。ユーザーの現在地を新しい出発地点として使用する場合は、最初のWaypointの方位の向きも必ず指定します。returnToRoute()メソッドを使用して、最初に選択したルート候補に到達するための新しいルートを計算します。これは、オンラインRoutingEngineおよびOfflineRouteEngineで対応できます。OfflineRouteEngineで計算されたルートには、交通情報は含まれなくなりました。routingEngine.refreshRoute()で新しい出発地点を使用して古いルートを更新します。この出発地点は元のルート上にある必要があります。さらに、必要に応じてルート オプションを更新します。元のルートを特定するためにRouteHandleが必要です。このオプションでは、逸脱した場所からルートに戻るパスは提供されないため、単独では逸脱のユースケースに適していません。- 加えて HERE SDK では
DynamicRoutingEngineが提供されており、現在の交通状況に基づいて最適化されたルートを定期的にリクエストできます。RouteHandleが必要となるため、オンラインで計算されたルートが必要です。これは、ユーザーがまだルートを追随する間に、より良いルートを見つけるためのエンジンです。したがって、入力として現在地が必要ですが、逸脱のユースケースには最適な選択ではない場合があります。
1つ目と3つ目のオプションについては、「ルート検索」セクションで説明しています。元のルートを更新する3つ目のオプションでは、逸脱した場所からルートに戻るパスは提供されません。そのため、以下では説明しません。ただし、アプリケーションにより、移動した部分をルートから削除して、ユーザーが自分で新しい出発地点に到達できるよう、この使用が選択される可能性があります。
アプリケーションは、逸脱した場所の距離や位置情報などのパラメーターに基づいて、ドライバーに提供するオプションを決定する必要があります。
ただし一般的には、逸脱が検出された場合は returnToRoute() を使用することをお勧めします。なぜなら、アプリでユーザーが選択できる複数のルートの候補が提供されている場合、始めに選択したルートの候補に誘導するのが最善策であるためです。
注位置情報が更新されるたびに、HERE SDKはその位置情報を最も適した道路にマップマッチングしようとします。位置情報の更新を処理する前に、その精度を事前に評価して、非常に不正確と判断された位置情報のみ破棄します。その後、位置情報を道路ネットワークおよびアクティブなルートとマッチングします。逸脱イベントが発生する前に、内部的にさまざまなパラメーターが考慮されます。
逸脱後にルートに戻る
RoutingEngine または OfflineRoutingEngine によって、元のルートに戻るルートをオンラインまたはオフラインで計算します。最初に選択したルートを保持しつつ、ドライバーができるだけ早くルートに戻れるようにする場合は、returnToRoute() メソッドを使用します。
注
returnToRoute()は、ルートの逸脱に対応できる 1 つのオプションにすぎません。別のオプションについては、上の説明を参照してください。たとえば、ユーザーの目的地までの新しいルート全体を計算するといい場合もあります。
現在、returnToRoute() 機能ではエンジンと同じ移動モードがサポートされており、OfflineRoutingEngine と RoutingEngine の両方を使用できます。RoutingEngine でこのメソッドを実行する場合、公共交通機関ルートのみがサポートされていません。RoutingEngine で利用可能なその他の移動モードはすべてサポートされています。
注
OfflineRoutingEngineのreturnToRoute()メソッドには、キャッシュに保存されたマップ データまたはダウンロード済みのマップ データが必要です。ほとんどの場合、元のルートに戻るパスは、ドライバーがルートから逸脱する間にすでにキャッシュに保存されている可能性があります。ただし、大幅に逸脱している場合は、代わりに新しいルートを計算することを検討してください。
ルート計算には、次のパラメーターが必要です。
- 元の
Route。NavigatorまたはVisualNavigatorから取得できます。 - また、すでに移動したルートの一部を設定する必要があります。この情報は、
RouteDeviationイベントによって提供されます。 - 新しく開始する
Waypoint。これは大抵の場合、マップマッチングされたドライバーの現在の位置となります。
オンラインの RoutingEngine を使用する場合は、RouteHandle が含まれた元の Route が必要です。これがないと、ルート計算が NO_ROUTE_HANDLE エラーになります。OfflineRoutingEngine では、これは必要ありません。
新しい出発地点は、RouteDeviation イベントから取得できます。
// Get current geographic coordinates.
var currentGeoCoordinates = routeDeviation.currentLocation.originalLocation.coordinates
if let currentMapMatchedLocation = routeDeviation.currentLocation.mapMatchedLocation {
currentGeoCoordinates = currentMapMatchedLocation.coordinates
}
// If too far away, consider to calculate a new route instead.
Waypoint newStartingPoint = Waypoint(currentGeoCoordinates)
オンラインの RoutingEngine では、まったく新しいルートが計算されることがあります。たとえば、ユーザーが以前に選択したルート候補よりも早く目的地に到達できる場合です。OfflineRoutingEngine では、ルートのまだ移動していない部分が優先的に再利用されます。
一般に、アルゴリズムは元のルートに戻る最速のルートを見つけようとしますが、目的地までの距離も考慮されます。新しいルートは、可能な場合は元のルート形状を維持しようとします。
まだ到着していない立ち寄る予定のストップオーバーはスキップされません。通過する経由地については、新しいルートで考慮されるとは限られません。
必要に応じて、ドライバーの進行方向を設定することにより、ルート計算を改善できます。
if currentMapMatchedLocation.bearingInDegrees != nil {
newStartingPoint.headingInDegrees = currentMapMatchedLocation.bearingInDegrees
}
最終的に、新しいルートを計算できます。
routingEngine.returnToRoute(originalRoute,
startingPoint: newStartingPoint,
lastTraveledSectionIndex: routeDeviation.lastTraveledSectionIndex,
traveledDistanceOnLastSectionInMeters: routeDeviation.traveledDistanceOnLastSectionInMeters) { (routingError, routes) in
if (routingError == nil) {
let newRoute = routes?.first
// ...
} else {
// Handle error.
}
}
注
CalculateRouteCompletionHandlerが再利用されるため、ルートのリストが表示されます。ただし、リストには 1 つのルートしか含まれません。エラーの処理は、RoutingEngineと同じロジックに従います。
オンラインおよびオフラインの使用状況に関する一般的なガイドラインとして、returnToRoute() 機能は、すでに計算されている originalRoute のその先の部分を再利用しようとします。交通データは、オンラインの RoutingEngine で使用する場合にのみ更新され、考慮されます。
結果として生成される新しいルートでも、originalRoute にある同じ OptimizationMode が使用されます。
ただし最善の結果を提供するには、オンラインの RoutingEngine を使用し、交通状況に最適化されたルートを取得することをお勧めします。
7 日前の更新
