GetTravelBoundary

説明

GetTravelBoundary は、ロケーションから一定の時間または距離で、車両または徒歩で到達可能なエリアの境界を示します。この機能では、時間到達圏または距離到達圏の計算に基づくポリゴンを取得します。時間到達圏とは、始点から一定時間内に道路を通って到達できるエリアを表すポリゴンまたはポイントの集まりです。距離到達圏とは、始点から一定距離の移動で到達できるエリアを表すポリゴンまたはポイントの集まりです。GetTravelBoundary 操作 (到達圏検索とも呼ばれます) は、始点、単位 (距離または時間)、および 1 つ以上のコストを入力として受け取り、生成された到達圏(ポリゴン)を返します。コストとは、到達圏計算に使用する時間または距離の値を意味します。また、複数のコストを入力として提供することもできます。複数のコストの場合、コストはカンマ区切り文字列として提供することもできます。

HTTP GET URL 形式

HTTP GET 要求には次の形式を使用します。HTTP GET は、その他の JSON ペイロードを必要としないすべての到達圏境界に使用されます (周辺移動速度の変更)。

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

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

HTTP POST URL 形式

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

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

Route Data は、道路タイプの周辺移動速度を含む計算で使用される追加のルート情報を表す POST Json 本体 (Content-Type: application/json) です。これらのオプションの詳細については、GetTravelBoundary HTTP POST オプション を参照してください。

クエリ パラメータ

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

例

単一のコストを持つ到達圏境界。

http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase.json?​q=travelBoundary&point=-77.092609,38.871256,epsg:4326&costs=5&costUnit=m

応答

{
"travelBoundary": {
  "costs": [
	{
		"cost": 5,
		"costUnit": "m",
		"geometry": {"type":"MultiPolygon","coordinates":[[[...]]]}
	}
  ]
}
}	
			

複数のコストを持つ到達圏境界。

http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase.json?​q=travelBoundary&point=-77.092609,38.871256,epsg:4326&costs=2,5&costUnit=m

応答

{
"travelBoundary": {
  "costs": [
	    {
                 "cost": 2,
                 "costUnit": "m",
		"geometry": "{"type":"MultiPolygon","coordinates":[[[...]]]}"
	},
	{
		"cost": 5,
		"costUnit": "m",
		"geometry": "{"type":"MultiPolygon","coordinates":[[[...]]]}"
	}
  ]
}
}
}	
			

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

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

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

  
  http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase.json?q=travelBoundary
  &costs=5&costUnit=min&point=-14.321600,60.662859,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=travelBoundary
  &costs=5&costUnit=min&point=-14.321600,60.662859,epsg:4326&version=2 

• レスポンス:

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