プロファイルモードでマトリックスを計算する方法

次のチュートリアルでは、これらの出発地と目的地を持つ7x7のマトリックスリクエストの例を示します。

1. ベルリン (52.54、13.40)
2. キーウ (50.43、30.52)
3. ロンドン (51.50、-0.08)
4. マドリード (40.40、-3.68)
5. モスクワ (55.75、37.60)
6. パリ (48.87、2.33)
7. ローマ (41.90、12.48)

自動車走行距離のマトリックスを計算するには、以下のリクエストを使用します。リクエストでは目的地の配列が指定されていないため、出発地は目的地と見なされ、結果のマトリックスは7x7のマトリックスになります。
リージョン定義は特殊なバリアントworldです。リクエストでは、TransportモードのCARを使用するプロファイルcarFastを使用し、移動時間のルート計算を最適化します。
デフォルトではサービスは移動時間のマトリックスを計算しますが、レスポンスでは時間ではなく距離を取得するため、リクエストでは値distancesを使用してmatrixAttributesプロパティが指定されます。

{
    "origins": [
        { "lat": 52.54, "lng": 13.40 },
        { "lat": 50.43, "lng": 30.52 },
        { "lat": 51.50, "lng": -0.08 },
        { "lat": 40.40, "lng": -3.68 },
        { "lat": 55.75, "lng": 37.60 },
        { "lat": 48.87, "lng":  2.33 },
        { "lat": 41.90, "lng": 12.48 }
    ],
    "profile": "carFast",
    "regionDefinition": {
        "type": "world"
    },
    "matrixAttributes": ["distances"]
}

次のように表示されます。

マトリックスリクエストを送信するすべての手順については、「HERE Matrix Routing API v8の使用を開始する」セクションで説明しています。レスポンスは次のようになります。

{
    "matrixId": "d68e214a-52f7-4b67-858a-d67935cce61b",
    "matrix": {
        "numOrigins": 7,
        "numDestinations": 7,
        "distances": [
            0, 1360978, 1093439, 2319223, 1836226, 1052278, 1508389,
            1346659, 0, 2395659, 3621443, 853752, 2354498, 2445588,
            1101711, 2404221, 0, 1719756, 2879469, 456781, 1838456,
            2317959, 3620469, 1711156, 0, 4095717, 1271140, 1961961,
            1823692, 851480, 2872692, 4098476, 0, 2831531, 3054079,
            1051198, 2353708, 452120, 1272365, 2828956, 0, 1426684,
            1507836, 2441104, 1832407, 1963512, 3049976, 1424346, 0
        ]
    },
    "regionDefinition": {
        "type": "world"
    }
}

レスポンスはメートル単位のエントリを持つこちらのマトリックスに対応します。
| 出発地\目的地 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
| :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| 1 | 0 | 1360978 | 1093439 | 2319223 | 1836226 | 1052278 | 1508389 |
| 2 | 1346659 | 0 | 2395659 | 3621443 | 853752 | 2354498 | 2445588 |
| 3 | 1101711 | 2404221 | 0 | 1719756 | 2879469 | 456781 | 1838456 |
| 4 | 2317959 | 3620469 | 1711156 | 0 | 4095717 | 1271140 | 1961961 |
| 5 | 1823692 | 851480 | 2872692 | 4098476 | 0 | 2831531 | 3054079 |
| 6 | 1051198 | 2353708 | 452120 | 1272365 | 2828956 | 0 | 1426684 |
| 7 | 1507836 | 2441104 | 1832407 | 1963512 | 3049976 | 1424346 | 0 |