はじめに

HERE platform を利用している HERE Location Services の新しいセットを発表し、発表できることを大変嬉しく思います。このセットには、 developer.here.com の Developer ポータルから簡単にアクセスできます。 これらの新たにリリースされたバージョンの HERE Location Services は、ユニファイド API フレームワークを提供すると同時に、 HERE platform を活用することで、あらゆる顧客がロケーションサービスの幅広いサービスを簡単かつ効率的に導入できるようにします。 位置情報サービスをご利用のお客様は、再設計および調整された一連の API 、すべての位置情報サービスとの互換性を備えた合理化されたアーキテクチャのメリットを享受できます。これらの API は、同じ HERE Map Data 、認証および承認方法、および API 仕様を共有しているためです。 また、新たにリリースされた HERE Location Services では、地図更新頻度の向上と、本日 HERE platform を通じて実現された新しい地域（最近統合された日本の高詳細地図など）の迅速な利用を通じて、地図の更新内容を活用しています。

新しいサービスフレームワークが導入されたことで、新たにリリースされた HERE Location Services でのみ利用可能になる新しい機能を提供することも可能になりました。

HERE Location Services の最新バージョンにアクセスすると、現在のすべてのお客様がこれらの新機能を利用できます。 すでにトークンまたは API キー 認証を使用している場合は、アクセス資格情報に関する変更は必要ありません。 それでも app_id と app_code を使用している場合 は、 https://developer.here.com/documentation/identity-access-management にあるドキュメントを参照してください。ここで、新しい資格情報の作成方法と使用方法についての情報を参照できます。

ご登録ありがとうございました。 すべてのお客様に、新しいサービスの詳細を確認して評価してもらい、提供する新機能について理解してもらうことをお勧めします。

新しい Routing API V8 には、次のような新しいモードと機能があります。

• 特定の道路セグメントおよび採用された速度プロファイルを使用した 2 輪駆動の経路指定
• 最適化された充電拠点を考慮して最速ルートを見つけるための充電対応 EV ルーティング
• コアルーティングアルゴリズムのパフォーマンスと品質の改善
• 日本の地理的条件でもサービスを提供しています

Routing Services v7 から Routing Services V8 に移行します

ここでは、今後数か月の間に Routing v7 サービスの廃止が予定されており、サービスはメンテナンスモードになっています。 このガイドでは、 Routing v7 サービスのユーザーが、アプリケーションで Routing V8 サービスを使用するように切り替える方法について説明します。

詳細については、「ルーティング V8 開発者ガイドおよび API リファレンス 」を参照してください。

準備

移行を完了するには、次の一般的なアクションを実行する必要があります。

• 認証方法の変更 ( 該当する場合 )
• リクエストパラメータを更新します
• 新しい出力形式の更新処理

認証

利用可能な使用プランおよび制限の詳細について は、「価格設定とプラン」を参照してください。

概念の変更

地図情報

V8 サービスのルーティングサービスで使用される基本的なマップは HERE Map Contentです。 このマップは トポロジモデルに準拠しています。 そのため、 V8 にはリンクおよびリンク属性の概念はありません。

これにより、ルートに関連する地図情報がどのように返されるかが異なります。 V8 のルートレスポンスは、 1 つ以上のセクションで構成されています。 ルート関連の属性が要求された場合は、スパンが含まれている可能性があります。

スパンは、一般 linkAttribute に、ルート属性のコンパクトな表現を提供し、応答を置き換えます。 return パラメータを使用して、さまざまなルートおよびレッグ属性を指定できるようになりました。

詳細については 、『 Routing API V8 開発者ガイド』を参照してください。

公共交通機関のルーティング

公共交通機関のルーティングは、 Routing v7 サービス（mode=;publicTransportTimeTable または mode=;publicTransport）のモードとして提供され、専用のエンドポイントhttps://transit.ls.hereapi.comを持つ別個の公共交通機関 v3 サービスとして提供さ れました。 V8 では構造がシンプルhttps://transit.router.hereapi.com化され、専用の公共交通機関 V8 サービス（）がこの機能にアクセスする唯一の方法となります。 詳細については、公共交通機関 API V8 サービスのドキュメントを参照してください。

トラックの制限に違反するルート

ルーティング v7 では、トラックの制約に厳密に対応していました。 そこには、トラックの制限に違反したルートが返却されませんでした。 この動作は truckRestrictionPenalty パラメーターで変更できましたが、 Routing v7 では一般的な通知のみが提供されていました : Code: routingOptionViolated、 Text: truckRestriction 。

指定されたすべてのオプションおよび車両パラメータに準拠するルートが Routing V8 で見つからず、適用可能なすべての制限が回避された場合、デフォルトでは、一部の制限に違反するルートが応答に含まれます。 また、回答には、回避できなかった制限について説明する一連の重要な通知も含まれています。 一部の地域では、これは不可能です。たとえば、ルーマニアでは、ほとんどすべての主要道路でアクスルあたり 11.5 t の制限があります。

ルート計算要求の移行

このセクションでは、 v7 Calculate Route リクエストを V8 Routing リクエストに移行するために実行する必要があるアクションについて説明します。

パラメータのタイプまたは仕様の詳細については、『 Routing API V8 開発者ガイド』を参照してください。

リクエスト

このセクションでは、リクエストの変更について説明します。

パラメータが追加されました

この移行では、新しいパラメーター return と spans 、前述の新しい概念の変更が導入されます。

パラメータが変更されました

この移行では、次のパラメータが変更されます。

基本 URL 、バージョン、リソース

waypoint<x> vs origin、viadestination

この移行では、 waypoint<x> パラメータ（ v7 ）がいくつかの個別の特定の経由地タイプ（ V8 ）に分割されます。 waypoint0 V8 では origin と呼ばれます。

中級 waypoint<x> 者は via 、 (v8) として指定する必要があります。 複数の中間点を指定する必要がある場合 via=<> は、複数のパラメーターを使用します。

waypoint<n> (v7) の最後の ( つまり、宛先 ) パラメータが destination (v8) と呼ばれるようになりました。

mode routingMode、、およびに分割します transportMode avoid[features]

この移行 mode では、パラメーター（ v7 ）がいくつかの個別の特定のオプション（ v8 ）に分割されます。 RouteFeatureType およびで RouteFeatureWeightTypeは、を使用 avoid[features]します。 オプション（ -1 および -3 ）では、使用状況の統計およびフィードバックに基づいて十分な値またはユーザー体験が提供されませ んでした。そのため、 V8 では、（softExclude）RouteFeatureWeightType=-2と同等の機能のみが提供されます。

が departureTime に設定されていない限り、トラフィックはデフォルトでルートの計算に使用さ anyれ、 TrafficMode 別のオプションとして提供されなくなります。 v7 では、設定は mode=<routingMode>;<transportMode>;<trafficMode>;<RouteFeatureType>=<RouteFeatureWeightType> V8 の個々のパラメータのようになります。以下を参照してください。

avoid[features]

mode=;;;<RouteFeatureType>=<RouteFeatureWeightType>

詳細については 、『開発者ガイド』を参照してください。

パラメータが削除されました

この移行では、次のパラメータが削除されます。

レスポンス

ここでは、応答の変更点について説明します。

応答の構造

ルーティング v7 のルート応答は、 Route Leg Maneuver Link メタ情報およびルート概要情報によってブックエンドと同じように階層的に構造化されました。 詳細の多くはリクエストに含めることも、除外することもできますが、 RouteAttributes や ManeuverAttributes などのさまざまな階層情報レベルのデフォルト設定もありました。

ルーティング V8 のルートレスポンスは、 routes -> sections およびメタ情報の階層構造になっています。 actions、 summary、 polyline ( ジオメトリ ) 、 notices 、および spans ( 必要に応じて ) が、対応する各セクション内にネストされます。

V8 の応答情報は設定可能で、 v7 に似ていますが、所要時間、距離、ルートシェイプなどのサマリー情報を含むすべてのルート情報は、明示的に要求された場合にのみ返されます。

ジオメトリが必要な場合 return=polylineは、で有効にする必要があります。 結果の形状は 、フレキシブルポリラインとしてエンコードされます。 デコーダーは複数の主要言語で使用できます。

逆に、違反したオプションなど、ルートに関する追加の通知が v7 でデフォルトで返されませ notes んでした。また、この情報を取得するには、消費者が AT ルートまたはレグレベルを要求する必要がありました。 この情報は、違反ルートセクションの一部としてデフォルトで提供されるようになり noticesました（のを参照）。

routeAttributes

v7 では、他のルート属性が明示的に要求されない限り、デフォルトでは waypoints summary legs が返されます。 また publicTransport 、または publicTransportTimeTable モードを使用する場合 lines は、も返されます。

V8 で sections は、概念的には置き換え legsられます。 これらは常に応答の一部です。 sections origin および destination 経由地で構成されている場合、これらの値も常に返されます。他の情報と同様に、 return パラメータを使用して summary 要求する必要があります。

legAttributes

v7 では、この値はデフォルトで maneuvers、 waypoint、 length、 travelTime 、に設定されています。

V8 では、前述の section ように、と同等のエンティティ legです。 明示的に何も要求されない場合、セクションには出発および到着の経由地および使用されている輸送モードについての座標情報のみが含まれます。 要求されたルートに沿ったトランスポートモードの変更も、 transport パラメータで指定されます。 summary が要求された場合、セクションの期間 ( トラフィックの有無 ) と長さが返されます。

linkAttributes

v7 では、デフォルトは shapeです speedLimit。

V8 で segmentRef は PVID、の代わりにが返さ spans れます。概念的には、リンク属性を置き換えます。

lineAttributes

利用可能なオプションについては、公共交通機関の API を参照してください。

maneuverAttributes

v7 では、デフォルトは position、、 lengthです travelTime。

V8 では、これらのパラメータは設定できず actions 、およびに分割されませ turnbyturnActionsん。

action 列挙体が、単純な列挙 (v7) から、および action direction severity の 3 つの詳細な属性に変更されました。 次の表に、これらの値の組み合わせが v7 の列挙値にどのように対応するかを示します。 ANYおよび NONE は列挙体の一部ではありませんが、すべての値がこのように動作するか、または欠落している値がこのように動作することを示しています。