徒歩とドライブに最適なターン・バイ・ターンナビ　（矢印ナビ）

ドライブにターン・バイ・ターンナビ　（矢印ナビ）を使用している場合、実際の NMAMapRoute オン NMAMapView オブジェクトを表示するには、再ルーティングのデリゲートメソッドを実装する必要があります。 ナビゲーション管理者がルートと実際のユーザー位置の間の偏差を判断すると、再経路化がトリガされます。 Navigation Manager は、次のメソッドをトリガーします。

• navigationManager:navigationManagerWillReroute: - 再経路化がトリガされたとき。
• navigationManager:didRerouteWithError: - 再経路化が完了したとき ( 新しいルートが作成されたとは限りません ) 。
• navigationManager:didUpdateRouteWithResult: - ナビゲートしているルートに変更が加えられたとき。

navigationManager:didUpdateRouteWithResult: は NMAMapRoute 再描画の主な場所です。 このメソッドは、さまざまなシナリオで呼び出されることがあります。

• ユーザーがを使用してルートをプログラム的に変更しました

  [[NMANavigationManager sharedNavigationManager] setRoute:newRoute];

• ナビゲーションルートと実際のユーザー位置の間に偏差があるため、ルート変更に成功しました。
• ナビゲーションが停止したとき。

navigationManager:didUpdateRouteWithResult: 次のコードは、実装の例です。

- (void)navigationManager:(nonnull NMANavigationManager *)navigationManager
 didUpdateRouteWithResult:(nonnull NMARouteResult *)routeResult
{
  if (routeResult && routeResult.routes.count > 0) {
    // Let's add the 1st result onto the map
    self.route = routeResult.routes[0];

    // remove previously created map route from map
    if (self.mapRoute) {
      [self.mapView removeMapObject:self.mapRoute];
    }
    // create new one based on provided route
    if (route) {
      self.mapRoute = [NMAMapRoute mapRouteWithRoute:self.route];
      self.mapRoute.traveledColor = [UIColor clearColor];
      [self.mapView addMapObject:self.mapRoute];
    }
  } else {
    // The routeResult doesn't contain route for redraw.
    // It might occur when navigation stop was called.
  }
}
        

HERE SDK モードを運転に使用している場合は 、アプリがバックグラウンドにあるときにガイダンス ( 音声案内やイベントコールバックを含む ) を実行するようにターン・バイ・ターンナビ　（矢印ナビ）を設定することもできます。 ただし、以下の制限事項に注意してください。

• 前景色のナビゲーションシナリオとは異なり 、 ストリームマップ データでは背景のナビゲーション中に HERE SDK を使用しません。 バックグラウンドでのナビゲーションをサポート するには、アプリがバックグラウンドでマップ データを使用できる場合に、 NMAMapLoader を使用して HERE ( 現在の都市または州など ) をプリロードする必要があります。
• アプリがバックグラウンドにある場合、マップをレンダリング ( 外部デバイスに送信 ) することはできません。
• アプリがフォアグラウンドにあるときに、ナビゲーションが以前に有効になっていない限り、バックグラウンドからナビゲーションを開始できません。 そのため、バックグラウンドで直接起動されるアプリは、ナビゲーションセッションを確実に開始することはできません。 NMANavigationManager クラスのこのチェックプロパティの詳細については、 backgroundNavigationStartEnabled を参照してください。

次の方法でナビゲーションを開始できます。

• startTurnByTurnNavigationWithRoute: - ナビゲーションモードでナビゲーションマネージャを起動します
• startTrackingWithTransportMode: - 追跡モードでナビゲーションマネージャを起動します

NMANavigationManager setNaturalGuidanceMode: 自然なガイダンスを有効にするためにメソッドを使用できます。 自然なガイダンスとは、ナビゲーション中に利用できる動的な情報の一種を指します。この情報には、ルートガイダンスの指示に、決定ポイントの周囲にコンテキスト要素が含まれています。 これらのコンテキスト要素には、サービス、地図作成機能、交通信号などがあります。 自然なガイダンスの指示には、次のようなものがあります。

• " 右側の公園を通過し、アンダーソンスクールの Bayview street で左折します "
• " 渋滞ランプを通過し、ガソリンスタンドの手前で右折します "
• " 右側のドームビルを通過するルートを続行します "

NMANavigationManager NMANavigationManagerDelegate プロトコルを実装するデリゲートを介して、ナビゲーションイベントをクライアントに通知します。 デリゲートプロトコルには、次のメソッドが含まれています。

• navigationManagerDidReachDestination: - ナビゲーションの目的地に到達したことを示します
• navigationManager:hasCurrentManeuver:nextManeuver: - nextManeuver のプロパティにアクセスして取得できる新しい命令情報があることを示します NMANavigationManager
• navigationManager:didUpdateRoute: –新たに計算された NMARoute オブジェクトを提供します。このオブジェクトを使用して、マップ上に新しいルートをレンダリングできます
• didUpdateSpeedingStatus:forCurrentSpeed:speedLimit: - ユーザーが指定された道路名と制限速度で制限速度を超過したことを示します
• navigationManagerDidLosePosition: - システムが GPS 信号を失ったことを示します
• navigationManagerDidFindPosition: - システムが GPS 信号を取得したことを示します
• navigationManagerWillReroute: –ルートの再計算が開始されたことを示します。 これは、現在の位置が元のルートから逸脱しているためです
• navigationManagerDidReroute: - ルートの再計算が完了したことを示します
• navigationManager:didFindAlternateRouteWithResult: - ナビゲーション管理者が改善されたルートを見つけたことを示します
• navigationManager:shouldPlayVoiceFeedbackWithText: - 音声フィードバックを再生する準備ができていることを示します。 このコールバックの戻り値を使用して、音声で読み上げるテキストを取得し（該当する場合）、現在の音声フィードバックを再生するかどうかを制御します
• navigationManager:willPlayVoiceFeedbackWithText: - 音声フィードバックイベントが発生することを示します ( たとえば、操作が発表されたとき ) 。
• navigationManager:didPlayVoiceFeedbackWithText: - 音声フィードバックイベントが終了したことを示します
• navigationManager:didFindAlternateRoutes: - 交通渋滞回避モードが有効になっているナビゲーション中に代替ルートが発見されたことを示します

NMASchoolZoneWarnerDelegate コールバックメソッドを使用して、ユーザーが学校のゾーンに入っているか、または学校のゾーンから出ているかを確認できます。 コールバック didDetectSchoolZone は、ユーザーが現在のルートの方向に沿っている場合に、前に学校 NMARoadElement のゾーンがあると発生します。このゾーンは、現在のルートの方向に沿っている場合に、学校のゾーンがある場合には、その約 100 メートル先 コールバック didUpdateSchoolZone は、ユーザーが学校区に入ったとき、または左側に入ったときに発生します。 例 :

- (void)schoolZoneWarner:(nonnull NMASchoolZoneWarner *)schoolZoneWarner
   didDetectSchoolZone:(nonnull NMASchoolZoneNotification *)notification
{
  // distance to the road element with school zone
  NSUInteger distance = notification.distance;
  // road element associated with this school zone
  NMARoadElement* roadElement = notification.roadElement;
  // begin time, e.g. Monday 09:00
  NSDate* timeBegin = notification.schoolZoneInfo.timeBegin;
  // end time, e.g. Monday 17:00
  NSDate* timeEnd = notification.schoolZoneInfo.timeEnd;
  float speedLimit = notification.schoolZoneInfo.speedLimit;
}

- (void)schoolZoneWarner:(nonnull NMASchoolZoneWarner *)schoolZoneWarner
   didUpdateSchoolZone:(nonnull NMASchoolZoneInfo *)zoneInfo
{
  if (zoneInfo) {
    // user enters school zone
    float speedLimit = zoneInfo.speedLimit;
  } else {
    // user left school zone
  }
}
        

開発者は、のユーティリティメソッドを使用 NMASchoolZoneWarnerDelegate して、特定の道路要素に学校区があるかどうかを確認することもできます。 例 :

 // Get road element from geo coordinate
 // Use instance of NMAMapView to get roadElementAtCoordinates
NMARoadElement* roadElement = [NMAMapView roadElementAtCoordinates:coordinate];
 if (roadElement) {
   // Check whether road element has active school zone
   NMASchoolZoneInfo* info = [NMASchoolZoneWarner schoolZoneInfoForRoadElement:roadElement];
   if (info) {
     // provided road element has school zone
   }

   // Check whether school zone is active at specific time
   // GMT: Sunday, 8 March 2020, 00:00:00
   NSDate *sunday = [NSDate dateWithTimeIntervalSince1970:1583625600];
   NMASchoolZoneInfo* infoAtTime = [NMASchoolZoneWarner schoolZoneInfoForRoadElement:roadElement
                                          time:sunday];
   if (infoAtTime) {
     // school zone is active at provided time
   }
 } else {
   // NMARoadElement is nil either because there is no road at the provided location or map
   // data is not loaded. Use NMAMapLoader API to download map area, or use road element from
   // another provider, e.g. from the calculated route.
 }
        

デリゲートの実装を追加すると、ユーザーが Realistic View をサポートするハイウェイセクションに近づくと、アプリケーションは次のメソッドコールバックを受信し始めます。 次の操作 コールバックは、 2 番目の次の操作で現実的なビューが利用可能になったとき（たとえば、次の操作が交差点に入るとき）に発生 し、現在の操作コールバックは、直近の操作（ユーザーが交差点に入るときなど）を入力したときに発生します。

• navigationManager:didUpdateRealisticViewsForCurrentManeuver:
• navigationManager:didUpdateRealisticViewsForNextManeuver:

上記の最初の 2 つのメソッドコールバックは NSDictionary 、 1 realisticViewsつ以上 NSDictionary のイメージを保持するという名前のオブジェクトを返します。 NSDictionary から画像のを取得 realisticViewsするには、次のいずれかの縦横比の文字列をキーとして使用します。

• NMARealisticView16x9Key
• NMARealisticView3x5Key
• NMARealisticView4x3Key
• NMARealisticView5x3Key

このステップを実行した後、スルーキー NMANavigationManagerSignpostKey および NMANavigationManagerJunctionViewKey キー NSDictionary から署名ポストおよび交差点表示の画像を抽出できます。

- (void)navigationManager:(NMANavigationManager *)navigationManager
    didUpdateRealisticViewsForCurrentManeuver:(NSDictionary *)realisticViews
{
  NSDictionary *realisticView = [realisticViews objectForKey:NMARealisticView3x5Key];
  NMAImage *junction = [realisticView objectForKey:NMANavigationManagerJunctionViewKey];
  if (junction) {
    //** display the junction image
  }
  NMAImage *signpost = [realisticView objectForKey:NMANavigationManagerSignpostKey];
  if (signpost) {
    //** display the signpost image
  }
}