ガイドAPIリファレンス
ガイド

フレキシブルモードでマトリックスを計算する方法

次のチュートリアルでは、以下の出発地と目的地を持つ3x3のマトリックスリクエストの例を示します。

  1. サンフランシスコ (37.76、-122.42)
  2. ニューヨーク (40.63、-74.09)
  3. オースティン (30.26,-97.74)
米国でのマトリックスリクエスト

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

{
    "origins": [
        { "lat": 37.76, "lng": -122.42 },
        { "lat": 40.63, "lng": -74.09 },
        { "lat": 30.26, "lng": -97.74 }
    ],
    "regionDefinition": {
        "type": "world"
    },
    "matrixAttributes": ["distances"]
}

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

{
    "matrixId": "d3f94d55-65a0-4b73-94f7-f65817b09980",
    "matrix": {
        "numOrigins": 3,
        "numDestinations": 3,
        "distances": [
            0,4708189,2835632,
            4702095,0,2829359,
            2837455,2835478,0
        ]
    },
    "regionDefinition": {
        "type": "world"
    }
}

計算されたルーティングマトリックスは次のとおりです。

出発地\目的地123
1047081892835632
2470209502829359
3283745528354780