GetRoute HTTP POST オプション

HTTP POST URL 形式

標準の HTTP GET パラメータのほか、通過点、一時更新、および道路タイプの優先度を指定する HTTP POST ペイロード オプションをリクエストに追加できます。コンテンツ タイプは application/json に設定する必要があります。HTTP POST リクエストには次の形式を使用します。

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

通過点

ルートに沿って含める通過点のリスト。一連の通過点を HTTP POST 要求に含めるには、ルートのポイントを示す MultiPoint JSON ペイロードを追加します。通過点が URL と JSON ペイロードの両方で指定されている場合は、JSON ペイロードが優先され、URL の通過点は無視されます。

例: 通過点の HTTP POST ペイロード

{
  "intermediatePoints": {"type": "MultiPoint","crs": {"type": "name","properties": {"name": "epsg:4326"}},"coordinates": [[ -73.976266,40.788717],[ -73.973562,40.792193],[ -73.971802,40.794630]]}
}			
			

一時更新

この優先設定セットを使用して、要求ごとに一時更新を設定することができます。例えば、サーバーがすべての幹線道路タイプを回避するよう要求することができます。要求ごとに 1 つ以上の更新を含めることができます。速度更新の場合、正の速度値は速度の増加、負の速度値は速度の減少です。次は、一時更新タイプの説明です。

例: 一時更新の HTTP POST ペイロード

{
  "transientUpdates": [
    {
        "segmentID": "specify a segment id",
        "updates": [
            {"exclude": "Y"},
            {"roadType": "a road type"},
            {"percentage": 26.0},
            {"speed": { "velocity": 25, "velocityUnit": "kph"}},
            {"percentage": -13.5},
            {"speedAdjustment" : { "velocity": 5, "velocityUnit": "kph"}}
        ]
    },
    {
        "point": "specify a geojson point",
        "updates": [
            {"exclude": "Y"},
            {"percentage": 26.0},
            {"speed": { "velocity": 25, "velocityUnit": "kph"}},
            {"percentage": -13.5},
            {"speedAdjustment" : { "velocity": 5, "velocityUnit": "kph"}}
        ]
    },    
    {
        "roadType": "specify a road type",
        "updates": [
            {"percentage": 26.0},
            {"speed": { "velocity": 25, "velocityUnit": "kph"}},
            {"percentage": -13.5},
            {"speedAdjustment" : { "velocity": 5, "velocityUnit": "kph"}}
        ]
    }
]
}			
			

商用車規制

商用車規制は、ルートに沿って移動する商用車両の動作と属性をガイドするルーティング エンジンへのディレクティブで構成されます。指定された車両の属性 (高さ、幅、長さ、重量など)、および道路網に見られる商用車規制の属性に応じて、特定の車両に、あるセグメント上を経由させることができるかどうかが決定されます。道路網に商用車規制の属性がない場合、入力制限パラメータは、結果的なルートに影響を与えません。

以下に示すのは、商用車規制の一連のパラメータです。

例

車両規制なし

リクエスト:

HTTP GET /rest/Spatial/erm/databases/US_CVR.json?q=route&startPoint=-74.7221203,42.9737073,epsg:4326&endPoint=-74.6671887,42.8097083,epsg:4326
	

レスポンス:

{
   "distance": 24.87,
   "distanceUnit": "mi",
   "time": 36.57,
   "timeUnit": "min"
}	

車両規制あり

リクエスト:

HTTP POST /rest/Spatial/erm/databases/US_CVR.json?q=route&startPoint=-74.7221203,42.9737073,epsg:4326&endPoint=-74.6671887,42.8097083,epsg:4326	
POST BODY: Content-Type:application/json {CVR Data}	

{
     "cvr":{
     "looseningBarrierRestrictions":"n","vehicleAttributes":{
     "vehicleType":"ALL","heightUnit":"meter","height":"4","weightUnit":"Kilogram","weight":"40000"
                                                            }
           }
} 	

		
		{   
		"distance": 27.92,
		"distanceUnit": "mi",
		"time": 37.48,
		"timeUnit": "min"
		}

次の地図上の 2 つの経路は、同じ始点および終点の場所に適用された CVR を示しています。茶色い線で表示された経路は CVR なし、赤い線で表示された経路は CVR ありを示しています。移動を始めてからすぐに経路が逸れていることに注目してください。これは、高さおよび重量規制が経路に適用されていることが原因です。

道路タイプの優先度

ルート決定時にさまざまな道路に与える優先順位を指定します。次は、道路タイプの優先度オプションの説明です。

例: 道路タイプの優先度の HTTP POST ペイロード

{
" roadTypesPriority ": {
        "RoadType.MajorRoadDenseUrban": "High",
        "RoadType.LimitedAccessDenseUrban":"Low",
        "RoadType.LimitedAccessRural":"Medium",
        "RoadType.PrimaryHighwayUrban":"Avoid"
      }
}