マトリックス計算のプロファイル

Matrix Routingサービスで任意の長さのルートを含むルーティングマトリックスの計算をサポートする1つの方法は、プロファイルを選択することです。プロファイルは、事前定義されたオプションのセットです。

プロファイルの使用には、次の2つの制限があります。

一連のオプションはカスタマイズできません。
時間を考慮しないルーティングのみがサポートされます。特に、ダイナミックな交通情報は考慮されず、過去のトラフィックに基づく自由流速速度のみが適用されます。

このサービスでは、エンドポイント/v8/profilesで使用できる、事前定義されたプロファイルのセットがサポートされています。このエンドポイントは、プロファイルのリストと、対応するprofileIdおよび事前定義済みのオプションを返します。

使用可能なプロファイルのリストについては、「/v8/profilesエンドポイント」を参照してください。

任意の長さのルートを含むルーティングマトリックスの計算をサポートする別の方法については、「HERE Matrix Routing API v8のモード」を参照してください。

リクエスト

プロファイルを使用してマトリックスを計算するには、上のリストからプロファイルIDをprofileパラメーターとして指定し、必要な地域定義パラメーターを特殊なバリアントworldに設定します。

プロファイルを選択すると、すべてのリクエストオプションとその値はプロファイル定義によって提供されます。

プロファイルを使用する際に手動で定義できるオプションは、次の4つのみになります。

origins
destinations
regionDefinition
matrixAttributes

例：

{
    "origins": [
        { "lat": 52.54, "lng": 13.40 },  // Berlin
        { "lat": 50.43, "lng": 30.52 },  // Kyiv
        { "lat": 51.50, "lng": -0.08 },  // London
        { "lat": 40.40, "lng": -3.68 },  // Madrid
        { "lat": 55.75, "lng": 37.60 },  // Moscow
        { "lat": 48.87, "lng":  2.33 },  // Paris
        { "lat": 41.90, "lng": 12.48 }   // Rome
    ],
    "profile": "carFast",   // one of the profile IDs from the list /v8/profiles
    "regionDefinition": {
        "type": "world"     // required
    },
    "matrixAttributes": ["travelTimes", "distances"]
}

トラフィック

プロファイルが使用されている場合、マトリックスの計算では、過去のトラフィックに基づく自由流速速度のみが考慮されます。したがって、パラメーターdepartureTimeは、すべてのプロファイルの特別な値anyに常に設定されます。使用可能なプロファイルのリストについては、「/v8/profilesエンドポイント」を参照してください。