車と徒歩での移動

GitHub でのルーティング例

この機能を示す例について は、 https://github.com/heremaps/ (Obj-C) および https://github.com/heremaps/ (Swift) を参照してください。

NMACoreRouter

NMACoreRouter クラスは NMARoute 、経由地およびの一覧表を使用してを計算します NMARoutingMode。 NMACalculateResultBlock また、計算の進行状況を監視し、完了時に適切なコールバックメソッドをトリガするためのも提供されます。 ルートを計算するには calculateRouteWithStops:routingMode:completionBlock: 、メソッドを呼び出します。 別の NMACoreRouter インスタンスを使用して計算リクエストを起動することで、並列ルーティングリクエストを起動できます。

NMACoreRouter は、ルート計算を開始する前に dynamicPenalty プロパティを設定することで、トラフィックが考慮されたルートを計算することもできます。 NMADynamicPenalty クラスの詳細 については、「ダイナミックルーティングのペナルティ」を参照してください。

NMAWaypoint

NMACoreRouter は、経由地 AS NMAPlace、 NMAPlaceLocation 、または NMAWaypoint のオブジェクトをサポートします。

を使用 NMAWaypoint して、自動車ルート計算に経由地の詳細を追加できます。 これらの詳細には、経由地が意図的なストップオーバーであるか、またはルートが通過する必要があるパススルーポイントであるかが含まれます。 ストップオーバーまたはパススルー経由地が含まれているルートが異なる場合があるため、これはルーティングに影響します。 たとえば、計算されたルートでは、ストップオーバー後の U ターン操作が提案され、パススルー経由地と同じ場所にあるルートでは、同じ道路を走行することが推奨されます。 パススルー経由地タイプは、 CAR ルートでのみサポートされ、他のルートタイプではサポートされません。

NMARoutingMode

NMARTE

NMARoute このクラスは、 2 つ以上の経由地を接続する別個の計算パスを表し、操作およびルートリンクのリストで構成されます。 NMACoreRouter の calculateRouteWithStops:routingMode:completionBlock: メソッドの呼び出しによってルート計算がトリガーされますが、返された NSProgress オブジェクトと NMACalculateResultBlock ブロックを使用して操作を監視し、結果の NMARoute オブジェクトを処理できます。

NMALOUTETTA

NMARouteTta ( 「到着までの時間」 ) クラスは、車両プールの制約、ターンアラウンドの制約、道路の渋滞など、走行時間に影響を与える所要時間やルートの詳細など、ルートに関する有用な情報を提供します。 たとえば、計算されたルートの期間を取得するに tta は、プロパティを使用します。 たとえば、

NSTimeInterval duration = [route ttaExcludingTrafficForSubleg:NMARouteSublegWhole].duration;

ttaForSubleg: メソッドを使用して、ルートからサブレッグの期間を取得することもできます。 たとえば、

if (myRoute.sublegCount > 0)
{
  NSTimeInterval duration = [myRoute ttaExcludingTrafficForSubleg:0].duration;
}

トラフィックアウェアルーティングと NMALOTTA

この NMARoute クラスには、トラフィックを反映する別の NMARouteTta 結果セットを提供する ttaIncludingTrafficForSubleg メソッドと ttaUsingDownloadedTrafficForSubleg メソッドもあります。 トラフィックペナルティモードを設定してルートが最初に計算された場合 ttaIncludingTrafficForSubleg 、メソッドは、ルート計算時に交通状況に合わせて到着までの推定時間を返します。 値はルート計算時に 1 回計算され、時間とともに変更されません。ルートが戻されてから経過した時間が（ttaIncludingTrafficForSubleg を使用して取得した）到着までの時間を正確にするのに十分な大きさである場合に ttaUsingDownloadedTrafficForSubleg 使用してください。 交通状況が変化した場合。 NMATrafficManager クラスを使用して交通データが頻繁に更新されていれば、到着予定時刻のより最新の見積もりが ttaUsingDownloadedTrafficForSubleg 提供されます。

...
NMADynamicPenalty *penalty = [[NMADynamicPenalty alloc] init];
penalty.trafficPenaltyMode = NMATrafficPenaltyModeOptimal;
coreRouter.dynamicPenalty = penalty;
[coreRouter calculateRouteWithStops:stops routingMode:routingMode
  completionBlock:^(NMARouteResult *routeResult, NMARoutingError error) { ... }];
NSTimeInterval duration = [route ttaIncludingTrafficForSubleg:NMARouteSublegWhole].duration;

ダウンロードしたトラフィックデータに基づいて期間を計算する必要がある場合は、次の手順を実行して、トラフィックデータの入力を要求することもできます。

[[NMATrafficManager sharedTrafficManager] requestTrafficOnRoute:route];
// Wait for the callback that the traffic data has been downloaded: trafficDataDidFinish
NSTimeInterval durationWithTraffic = [route ttaUsingDownloadedTrafficForSubleg:NMARouteSublegWhole].duration;

NMAManeuver

NMALOUTEElement および NMARoadElement

NMARouteElement および NMARoadElement は、操作の一部を表します。 たとえば、ドライバーに左折を要求してから通りに出るように指示する場合がありますが、この通りはトンネル、泥道、トール道路などの複数のセクションで構成されていることがあります。 この状況では、操作に複数 NMARouteElement のオブジェクトが含ま NMARoadElement れており、各エレメントに道路の個々のセクションに関する情報をアプリケーションに提供できるプロパティが含まれています。

NMAMapRoute

NMAMapRoute このクラスは、 NMAMapObject 地図に計算されたルートを表示するのタイプです。 通常、アプリケーションはルート計算後に NMAMapRoute を作成し、 NMAMapView addMapObject: を呼び出してマップに NMAMapRoute 追加します。

renderType プロパティと NMAMapRoute API を使用して、地図のルートの色をカスタマイズできます。 サポートされているレンダリングタイプの値は NMAMapRouteRenderTypePrimary、、 NMAMapRouteRenderTypeSecondary、の 3 つ NMAMapRouteRenderTypeUserDefinedです。 デフォルト NMAMapRoute では、は事前定義された色のプライマリセットに設定され、セカンダリレンダリングタイプは代替ルートを示すように設計されています。 NMAMapRouteRenderTypeUserDefined を使用すると、 color および traveledColor プロパティを使用して、任意の ARGB カラーにルートのカラーを設定できます。

図 1. プライマリ RenderType を使用しています	図 2. セカンダリ RenderType を使用しています
図 3. ユーザー定義のルートの色

たとえば、 2 つの経由地（開始および宛先）を接続するルートをレンダリングする場合は、次のアプリケーションロジックを追加できます。

図 4. NMAMapRoute にが追加されました NMAMapView

1. を作成します NMACoreRouter

   // Create a NMACoreRouter.
   NMACoreRouter* coreRouter = [[NMACoreRouter alloc] init];

2. NSMutableArray を作成し、 2 つの NMAGeoCoordinates 経由地

   NMAGeoCoordinates* geoCoord1 = [[NMAGeoCoordinates alloc] initWithLatitude:49.1966286 longitude:-123.0053635];
   NMAGeoCoordinates* geoCoord2 = [[NMAGeoCoordinates alloc] initWithLatitude:49.1947289 longitude:-123.1762924];
   
   NMAWaypoint* waypoint1 = [[NMAWaypoint alloc] initWithGeoCoordinates:geoCoord1];
   NMAWaypoint* waypoint2 = [[NMAWaypoint alloc] initWithGeoCoordinates:geoCoord2];
   
   NSMutableArray* stops = [[NSMutableArray alloc] initWithCapacity:4];
   [stops addObject:waypoint1];
   [stops addObject:waypoint2];

   を追加します
3. を作成し NMARoutingMode 、その NMATransportMode、 NMARoutingType、 NMARoutingOption およびの値を設定します

   NMARoutingMode* routingMode = [[NMARoutingMode alloc]
       initWithRoutingType:NMARoutingTypeFastest
       transportMode:NMATransportModeCar
       routingOptions:0];

4. 交通状況を考慮しながらルートを計算する場合は、次のフラグを設定します。

   NMADynamicPenalty *penalty = [[NMADynamicPenalty alloc] init];
   penalty.trafficPenaltyMode = NMATrafficPenaltyModeOptimal;
   coreRouter.dynamicPenalty = penalty;

5. ルートを計算し、ルート計算の結果を受信します。

   [coreRouter calculateRouteWithStops:stops routingMode:routingMode
       completionBlock:^(NMARouteResult *routeResult, NMARoutingError error) {
   
         // If the route was calculated successfully
         if (!error && routeResult && routeResult.routes.count > 0)
         {
           NMARoute* route = [routeResult.routes objectAtIndex:0];
           // Render the route on the map
           NMAMapRoute* mapRoute = [NMAMapRoute mapRouteWithRoute:route];
           [mapView addMapObject:mapRoute];
   
           // To see the entire route, we orient the map view accordingly
           [mapView setBoundingBox:route.boundingBox
                   withAnimation:NMAMapAnimationLinear];
         }
         else if (error)
         {
           // Display a message indicating route calculation failure
         }
       }];
   

   注 : NMARoutingErrorViolatesOptions エラーが発生した場合でも、ルートが返されます。 ルーティングオプションに違反するこれらのルート結果は、ユーザーが処理する必要があります。

ダイナミックルーティングのペナルティ

を使用 NMADynamicPenalty して、ルート探索の計算時に適用される道路およびエリア制限要因のポリシーを作成できます。 たとえば、このクラスを使用して、あるエリアの走行速度が通常より 50% 遅くなっていることを示します。 NMADynamicPenalty このクラスで trafficPenaltyMode は、プロパティを介したルート計算で交通イベントを処理するために使用されるモードを設定することもできます。

で dynamicPenalty プロパティを設定することで、アクティブなポリシーを変更 NMACoreRouterできます。 制限を考慮するには、ルート計算の前にポリシーを設定する必要があります。

交通イベントオブジェクトを取得しています

NMATrafficManager このクラスを使用して、道路閉鎖や渋滞などの交通イベントを取得できます。 これは、アプリが特定のルートの現在のトラフィックイベントのリストを表示する必要がある場合に役立ちます。

NSNumber *requestID = [[NMATrafficManager sharedTrafficManager] requestTrafficOnRoute:myRoute];

オフラインルーティング

SDK for iOS で開発されたアクティブなデータ接続アプリケーションがなくても、ある場所から別の場所への移動を支援するためのルーティング情報を要求できます。

アプリケーションユーザーは、ルートを計算して地図に表示するために、アクティブなデータ接続を維持する必要はありません。 オフライン中にルーティングリクエストを実行するための更新されたマップおよびデータベース情報を事前にダウンロードできます。 たとえば、ユーザーがカリフォルニア州とオレゴン州のオフライン地図をダウンロードした場合、サンディエゴからポートランドまでのルートをデータに接続せずに作成できます。

オフライン地図のダウンロードの詳細 については、「マップ データのプリロード」を参照してください。

ルーティング関連の列挙体