GetRouteCostMatrix

説明

GetRouteCostMatrix サービスは、始点と終点の間の移動時間と距離を計算し、最短時間または最短距離となるルートを返します。この結果は、個々のルートの合計時間と合計距離 (ルート コスト) を示します。例えば、4 つの始点と 4 つの終点を入力すると、合計 16 個のルートが計算されます。

HTTP GET URL 形式

HTTP GET 要求には次の形式を使用します。HTTP GET は、その他の JSON ペイロードを必要としない単純なコスト計算に使用します。

HTTP GET /rest/Spatial/erm/databases/dbsource.json?q=routeCostMatrix&query_parameters
			

ここで、dbsource は、ルート用のデータを含むデータベースの名前です。Enterprise Routing モジュールのルーティング データベース リソース ツールで指定されたデータベース名を使用してください。

HTTP POST URL 形式

HTTP POST リクエストには次の形式を使用します。

HTTP POST:  /rest/Spatial/erm/databases/dbsource.json?q=routeCostMatrix&query_parameters
POST BODY: Content-Type:application/json {Route Data}
			

Route Data は、入力ポイントのリストが呼び出し元の URL バッファの制限を超える場合の計算や、一時更新、または道路タイプの優先度を含む計算で使用されるその他のルート情報を表す POST Json 本体 (Content-Type: application/json) です。これらのオプションの詳細については、GetRouteCostMatrix HTTP POST オプションを参照してください。

クエリ パラメータ

この演算は、次のクエリ パラメータを取ります。

例

2 つの始点と 2 つの終点を持つコスト マトリックス ルート。

http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase.json?q=routeCostMatrix&startPoints=-73.56565,40.5545,-73.46565,40.4545,epsg:4326&endPoints=-73.34343,40.667,-73.14343,40.267,epsg:4326&returnOptimalRoutesOnly=true&optimizeBy=distance&distanceUnit=km&timeUnit=min&majorRoads=true&destinationSrs=epsg:4322&returnTime=false			
			

応答

{
    "matrix":
       [
           {
               "startPoint":
               {
                   "type": "Point",
                   "coordinates":
                   [
                       -73.56567672202618,
                       40.554384822358614
                   ],
                   "crs":
                   {
                       "type": "name",
                       "properties":
                       {
                           "name": "epsg:4322"
                       }
                   }
               },
               "endPoint":
               {
                   "type": "Point",
                   "coordinates":
                   [
                       -73.34345711862802,
                       40.66688488742393
                   ],
                   "crs":
                   {
                       "type": "name",
                       "properties":
                       {
                           "name": "epsg:4322"
                       }
                   }
               },
               "distance": 35.268,               
               "distanceUnit": "km
           },
           {
               "startPoint":
               {
                   "type": "Point",
                   "coordinates":
                   [
                       -73.46567684021008,
                       40.454384834155185
                   ],
                   "crs":
                   {
                       "type": "name",
                       "properties":
                       {
                           "name": "epsg:4322"
                       }
                   }
               },
               "endPoint":
               {
                   "type": "Point",
                   "coordinates":
                   [
                       -73.34345711862802,
                       40.66688488742393
                   ],
                   "crs":
                   {
                       "type": "name",
                       "properties":
                       {
                           "name": "epsg:4322"
                       }
                   }
               },
               "distance": 44.444,
               "distanceUnit": "km"
           }
       ]
    }