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 は、ルート用のデータを含むデータベースの名前です。Spatial モジュールのルーティング データベース リソース ツールで指定されたデータベース名を使用してください。

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": [{
					"distance": 35.258,
					"distanceUnit": "km",
					"endPoint": {
					"type": "Point",
					"coordinates": [-73.34345711862802, 40.66688488742393],
					"crs": {
					"type": "name",
					"properties": {
					"name": "epsg:4322"
					}
					}
					},
					"startPoint": {
					"type": "Point",
					"coordinates": [-73.56567672202618, 40.554384822358614],
					"crs": {
					"type": "name",
					"properties": {
					"name": "epsg:4322"
					}
					}
					}
					}, {
					"distance": 41.761,
					"distanceUnit": "km",
					"endPoint": {
					"type": "Point",
					"coordinates": [-73.34345711862802, 40.66688488742393],
					"crs": {
					"type": "name",
					"properties": {
					"name": "epsg:4322"
					}
					}
					},
					"startPoint": {
					"type": "Point",
					"coordinates": [-73.46567684021008, 40.454384834155185],
					"crs": {
					"type": "name",
					"properties": {
					"name": "epsg:4322"
					}
					}
					}
					}]
					}
							

バージョン固有のエラー応答

リクエストに無効なパラメータ値 (ポイントが境界の外側にある、など) を入力すると、入力したバージョンによって異なるエラー応答が返ります。バージョンが 1 の場合、値とエラーが返りますが、バージョンが 2 の場合、応答にはエラーのみが含まれます。

• version が 1 の場合のリクエスト:

  http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase.json?
  q=routeCostMatrix&startPoints=-73.56565,40.5545,-73.46565,40.4545,epsg:4326&
  endPoints=-14.321600,60.662859,-73.14343,40.267,epsg:4326&version=1

• レスポンス:

  {
    "value": "Point outside boundaries: (-14.3216,60.662859,0)",
    "errors": [
      {
        "errorCode": 5008,
        "userMessage": "Point outside boundaries: (-14.3216,60.662859,0)"
      }
    ]
  }

• version が 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=-14.321600,60.662859,-73.14343,40.267,epsg:4326&version=2

• レスポンス:

  {
    "errors": [
      {
        "errorCode": 5008,
        "userMessage": "Point outside boundaries: (-14.3216,60.662859,0)"
      }
    ]
  }