はじめに

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 にあるドキュメントを参照してください。ここで、新しい資格情報の作成方法と使用方法についての情報を参照できます。

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

新しいマトリックスルーティング API V8 は、すべてのマトリックスサイズのユニファイドルーティングサービスとして提供されます。 さらに、次の機能もサポートされています。

  • 最大 10 、 000 x 10 、 000 エレメント(原点 x 目的地)
  • 自転車モード
  • 日本の地理的条件でもサービスを提供しています

詳細については、「 Matrix Routing V8 開発者ガイド and API リファレンス 」を参照してください。

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

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

ルーティングユーザーの場合は 、『 Routing Migration Guide 』を参照してください

等値線 (Isoline) ルーティングユーザーの場合は 、『 等値線 (Isoline) ルーティング移行ガイド』を参照してください

準備

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

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

概念の変更により、サポートされなくなった入力および出力パラメーターがあります。 これらについては、このガイドで詳しく説明します。

認証

アプリコード資格情報は V8 ではサポートされていません。 現在使用可能な認証方法の詳細について は、『 Identity & Access Management 開発者ガイド』を参照してください。

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

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

このドキュメントでは、 Matrix Routing Service ( V8 )の新バージョンへの移行に必要な最も重要な変更について説明します。 詳細について は、「 Matrix Routing V8 開発者ガイド and API リファレンス 」を参照してください。

概念の変更

同期要求と非同期要求

Matrix Routing v7 のすべてのリクエストが同期しています。 Matrix Routing V8 では、同期要求タイプと非同期要求タイプのいずれかを選択できます。 詳細については、「 Matrix Routing V8 開発者ガイド」を参照してください。

フレキシブルモード、リージョンモード、およびプロファイルモード

Matrix Routing V8 には 3 つのモードがあります。 柔軟性、地域、プロファイル。 フレキシブルモードは Matrix Routing v7 に対応していますが、リージョンモードとプロファイルモードでは、最大 10,000 の原点と目的地まで、はるかに大きいマトリックスを計算できます。 これらのモードの詳細について は、 Matrix Routing V8 開発者ガイドを参照してください。

取得 vs POST リクエスト

Matrix Routing v7 では、主に GET メソッドが使用されていました。 唯一の例外 は、 POST リクエスト 本体で送信元と宛先のポイントを送信できることです。 Matrix V8 では、すべてのパラメータを POST リクエスト ボディに配置する必要があります。 async パラメータおよび一部の認証パラメータのみが URL に含まれていることが想定されています。

マトリックス計算リクエストの移行

このセクションでは、 v7 のマトリックス計算リクエストを V8 マトリックスルーティングリクエストに移行するために実行する必要があるアクションについて説明します。

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

リクエスト

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

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

regionDefinition および profile

これらのパラメータは、 Matrix Routing V8 のどのモードを使用するかを定義します。 開発者ガイドで利用可能なモードを確認 し ます。たとえば、マトリックスルーティング v7 に対応するフレキシブルモードを使用するには、regionDefinitionの値としてをworld使用し、どのprofileモードも提供しません。

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

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

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

パラメーター マトリックスルーティング v7. マトリックスルーティング V8
基本 URL 文字列 , https://matrix.route.api.here.com 文字列 , https://matrix.router.hereapi.com
バージョン 文字列 , routing/7.2 文字列 , /v8
リソース 文字列 /calculatematrix.json 文字列 , /matrix

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

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

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

マトリックスルーティング v7. マトリックスルーティング V8
パラメーター mode=<routingMode> routingMode
形式 文字列、のいずれか fastestshortestbalanced 文字列、次のいずれか fastshort
動作 ルーティングモードを設定します。 ルーティングモードを設定します。
メモ balanced モードは提供されなくなりました。
マトリックスルーティング v7. マトリックスルーティング V8
パラメーター mode=;<transportMode> transportMode
形式 文字列、 carcarHOVtruckbicyclepedestrianのいずれか 文字列 , car,truck, bicycle,pedestrian
動作 トランスポートモードを設定します。 トランスポートモードを設定します。

avoid[features]

mode=;;;<RouteFeatureType>=<RouteFeatureWeightType>
V7 パラメータ V8 パラメータ / 注記
avoidAreas を使用 avoid[areas]します。 境界ボックスがサポートされています。
avoidSeasonalClosures まだサポートされていません。
tollroad:-2 を使用 avoid[features]=tollRoadします。
motorway:-2 を使用 avoid[features]=controlledAccessHighwayします。
boatFerry:-2 を使用 avoid[features]=ferryします。
railFerry:-2 を使用 avoid[features]=carShuttleTrainします。
tunnel:-2 を使用 avoid[features]=tunnelします。
dirtRoad:-2 を使用 avoid[features]=dirtRoadします。
avoidTurns を使用します avoid[features]=difficultTurns

summaryAttributes

summaryAttributes はに名前が変更されました matrixAttributesmatrixAttributes Matrix Routing v7 から知られているの機能が削除されました。 これらの 2 つのパラメーターはmatrixAttributesに置き換え られました。このパラメーターを使用すると、結果マトリックスのすべてのエントリについて、移動時間 (travelTimes) 、距離 (distance) 、またはその両方を選択できます。

routeId Matrix Routing v7 から削除されました。 この機能はルーティング V8 API リファレンス に移行RouteHandle され、その API で呼び出されます。

その他のパラメータ

ルーティング V8 で truck は、パラメータは廃止されました。 vehicle 代わりにパラメーターを使用してください。 同じリクエストでは、truckパラメータとvehicleパラメータを使用しないでください。

V7 パラメータ V8 パラメータ / 注記
start を使用 originsします。
destination を使用 destinationsします。
departure departureTime。 存在しない場合は、現在の時刻が使用されます。 departureTime=any は、サービスに時間依存の属性を使用しません ( トラフィックも無効化されます ) 。 時刻を入力する場合 は、タイムゾーンオフセットを指定する必要があります
axleCount を使用 vehicle[axleCount]します。
shippedHazardousGoods を使用 vehicle[shippedHazardousGoods]します。
limitedWeight を使用 vehicle[grossWeight]します。 キログラム単位で値を入力してください。
weightPerAxle を使用 vehicle[weightPerAxle]します。 キログラム単位で値を入力してください。
height/width/length vehicle[height]vehicle[width]vehicle[length]およびを使用 します。 値をセンチメートル単位で指定します。
tunnelCategory を使用 vehicle[tunnelCategory]します。
truckType を使用 vehicle[type]します。
trailersCount を使用 vehicle[trailerCount]します。
weightsPerAxleGroup を使用 vehicle[weightPerAxleGroup]します。 triple アクスルグループごとに重量を指定することもできます( single およびに加え tandemて)。 キログラム単位で値を入力してください。
avoidLinks を使用します avoid[segments]
excludeCountries を使用します exclude[countries]

今後のリリースでサポートされる予定のパラメータ

V7 パラメータ V8 パラメータ / 注記
speedProfile まだサポートされていません。
avoidSeasonalClosures まだサポートされていません。 として計画 avoid[seasonalClosure]されました。

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

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

V7 パラメータ V8 に関する注意事項
searchRange 削除されました
Format この移行で Format は、パラメータ (v7) が削除されます。 応答は常に JSON 形式( V8 )で返されます。 XML はサポートされなくなりました。

レスポンス

Matrix Routing v7 では、結果マトリックスのすべてのアイテムが、起点 / 終点インデックスを含むオブジェクトであり、これらのポイント間のルートに関する情報を要求しました。 Matrix Routing V8 はこの概念を変更し、代わりに値の配列を返します。

HERE は、 3x2 マトリックスリクエストに対する応答例を比較したものです。

マトリックスルーティング v7. マトリックスルーティング V8
        {
            "response": {
                "metaInfo": {
                    "timestamp": "[timestamp]",
                    "mapVersion": "[map version]",
                    "moduleVersion": "[module version]",
                    "interfaceVersion": "[interface version]",
                    "availableMapVersion": ["map version"]
                },
                "matrixEntry": [
                    {
                        "startIndex": 0,
                        "destinationIndex": 0,
                        "summary": {
                            "distance": 21470,
                            "travelTime": 2313,
                            "costFactor": 2333
                        }
                    },
                    {
                        "startIndex": 0,
                        "destinationIndex": 1,
                        "summary": {
                            "distance": 18227,
                            "travelTime": 1953,
                            "costFactor": 1973
                        }
                    },
                    {
                        "startIndex": 0,
                        "destinationIndex": 2,
                        "summary": {
                            "distance": 24803,
                            "travelTime": 2280,
                            "costFactor": 2301
                        }
                    },
                    {
                        "startIndex": 1,
                        "destinationIndex": 0,
                        "summary": {
                            "distance": 16112,
                            "travelTime": 2749,
                            "costFactor": 2749
                        }
                    },
                    {
                        "startIndex": 1,
                        "destinationIndex": 1,
                        "summary": {
                            "distance": 21206,
                            "travelTime": 2446,
                            "costFactor": 2466
                        }
                    },
                    {
                        "startIndex": 1,
                        "destinationIndex": 2,
                        "summary": {
                            "distance": 27782,
                            "travelTime": 2773,
                            "costFactor": 2794
                        }
                    },
                    {
                        "startIndex": 2,
                        "destinationIndex": 0,
                        "summary": {
                            "distance": 20410,
                            "travelTime": 2222,
                            "costFactor": 2242
                        }
                    },
                    {
                        "startIndex": 2,
                        "destinationIndex": 1,
                        "summary": {
                            "distance": 17167,
                            "travelTime": 1862,
                            "costFactor": 1882
                        }
                    },
                    {
                        "startIndex": 2,
                        "destinationIndex": 2,
                        "summary": {
                            "distance": 23743,
                            "travelTime": 2189,
                            "costFactor": 2210
                        }
                    }
                ]
            }
        }
        
        {
            "matrixId": "[matrix ID]",
            "matrix": {
                "numOrigins": 3,
                "numDestinations": 2,
                "travelTimes": [
                    3663,
                    3016,
                    2915,
                    2247,
                    3045,
                    2177
                ],
                "distances": [
                    35097,
                    30990,
                    34343,
                    31949,
                    32501,
                    24412
                ]
            },
            "regionDefinition": {
                "type": "world"
            }
        }
        

マトリックスルーティング V8 の応答形式の詳細について は、 API リファレンス の「応答」セクションを参照してください。

」に一致する結果は 件です

    」に一致する結果はありません