GetTravelBoundary

説明

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

注: REST サービスからの応答は JSON 形式です。要求の GET URL に無効なクエリ パラメータが含まれていたり、POST のペイロードが無効である場合は、累積的なエラー応答が JSON 配列に返されます。応答 JSON の value ノードは非推奨です。エラーの確認には、errors ノードを使用してください。

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 オプション を参照してください。

クエリ パラメータ

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

パラメータ Type 必須 説明
point 文字列 はい 経路境界を計算するときの始点で、形式 x,y,coordSys で表されます。例: -74.2,40.8,EPSG:4326
コスト 二重線 はい 距離または時間のコストで、指定された単位で表されます (小数値が使用できます)。例えば、指定された単位がマイルの場合に、このフィールドに 10 を指定すると、10 マイル移動するための経路境界が計算されます。また、複数のコストを指定することも可能で、値をカンマ区切り文字列として指定します。指定されたすべてのコストに対して個別に経路境界が返されます。複数のコストを指定した場合、応答にはコストとその応答に関連付けられているコスト単位が含まれます。
costUnit 文字列 はい 経路境界の計算に使用される指標のタイプ。使用可能な距離値: m (メートル)、km (キロメートル)、yd (ヤード)、ft (フィート)、mi (マイル)。使用可能な時間値: min (分)、msec (ミリ秒)、s (秒)、h (時間)。
maxOffroadDistance 二重線 いいえ maxOffroadDistanceUnit を使用して道路以外を移動できる距離の最大値。道路以外とは、私道や進入路などのことです。例えば、道路外距離の最大値を 1 マイルと指定すると、道路から 1 マイル以上離れた地点は、経路境界に含まれません。道路外距離の最大値として 0 を指定すると、道路から少しでもそれた地点は経路境界に含まれません。道路以外を移動する際の速度は、一般道走行速度オプションによって指定します。
maxOffroadDistanceUnit 文字列 いいえ maxOffroadDistance を定義する距離単位。また、このパラメータを定義する場合も、maxOffroadDistance を定義する必要があります。使用可能な距離値: m (メートル)、km (キロメートル)、yd (ヤード)、ft (フィート)、mi (マイル)。
destinationSrs 文字列 いいえ 経路境界ジオメトリを返す座標系。デフォルトは、使用するデータの座標系 (例えば、epsg:4326) です。
majorRoads Boolean いいえ 計算時に、すべての道路を含めるか、幹線道路のみを含めるかを指定します。幹線道路のみを含めるように指定した場合は、パフォーマンスは向上しますが精度は低くなる場合があります。既定値は true です。
returnHoles Boolean いいえ 境界内の到達不可能領域を返すかどうかを指定します。これは、道順に従って適切な時間または距離で到達できない、より大きな境界内に存在する領域を指します。デフォルトは false です。
returnIslands Boolean いいえ 境界外の到達可能領域を返すかどうかを指定します。これは、適切な時間または距離で到達できない、主要境界の外にある小さな領域です。デフォルトは false です。
simplificationFactor Integer いいえ 返す必要がある元のポイントの割合 (結果のジオメトリの複雑さが基づく必要がある割合)。0.0 ~ 1.0 (0.0 は除くが 1.0 は含む) の間の数値が指定できます。値が大きいほど複雑さは増します。つまり、1.0 は最も複雑であることを意味します。既定値は 0.5 です。
bandingStyle 文字列 いいえ

結果に使用する境界線表示形式。境界線表示形式は、複数のコストに基づいて表示できる複数の距離境界線のタイプです。境界線表示形式は、次の形式で返すことができます。

Donut
境界は、次に小さな境界をくり抜く方法で確定されます。これはデフォルトの方法です。
Encompassing
境界は、他のすべての境界から独立して確定されます。
historicTrafficTimeBucket 文字列 いいえ

ルーティング計算において、トラフィック速度履歴を使用するかどうかを指定します。これらの速度は、1 日のうちの異なるタイム バケットに基づきます。この機能を使用するには、トラフィック速度履歴がデータに含まれている必要があります。各国/地域のデータに対するバケット定義は同じです。バケット値に対する速度は異なる場合があります。次のオプションがあります。

None
デフォルト値です。計算において、トラフィック データ履歴は使用しません。代わりに速度の平均値を使用します。
AMPeak
午前のピーク速度でルートを計算します。午前ピークのタイム バケットは、1 日のうちの 07:00 ~ 10:00 です。
PMPeak
午後のピーク速度でルートを計算します。午後ピークのタイム バケットは、1 日のうちの 16:00 ~ 19:00 です。
OffPeak
オフピーク (日中) 速度でルートを計算します。オフピークのタイム バケットは、1 日のうちの 10:00 ~ 16:00 です。
Night
夜間速度でルートを計算します。夜間のタイム バケットは、1 日のうちの 22:00 ~ 04:00 です。

単一のコストを持つ経路境界。


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","crs":{"type":"name","properties":{"name":"epsg: 4326"}},"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","crs":{"type":"name","properties":{"name":"epsg: 4326"}},"coordinates":[[[...]]]}"
	},
	{
		"cost": 5,
		"costUnit": "m",
		"geometry": "{"type":"MultiPolygon","crs":{"type":"name","properties":{"name":"epsg: 4326"}},"coordinates":[[[...]]]}"
	}
  ]
}
}