GetRouteCostMatrix HTTP POST オプション

HTTP POST URL 形式

標準の HTTP GET パラメータのほか、一時更新や道路タイプの優先度を指定する HTTP POST ペイロード オプションをリクエストに追加できます。入力ポイントのリストが呼び出し元の URL バッファの制限を超える場合は、HTTP POST ペイロードを使用することもできます。コンテンツ タイプは application/json に設定する必要があります。HTTP POST リクエストには次の形式を使用します。

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

始点と終点の定義

一連の始点または終点を HTTP POST 要求に含めるには、ルートのポイントを示す MultiPoint JSON ペイロードを追加します。始点と終点が HTTP POST ペイロードに定義されている場合、startPoints および endPoints パラメータは URL の必須クエリ パラメータではありません。これらのパラメータが URL に定義されていても無視されます。URL のポイントが無視されると、警告メッセージが wrapper.log ファイルにログとして記録されます。

例: 始点の HTTP POST ペイロード

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

例: 終点の HTTP POST ペイロード

{			
"endPoints": {"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"}}
        ]
    }
]
}			
			

例: GeoJSON ポイント

"point": {"type": "Point", "crs":
          {
              "type": "name",
              "properties":
                {"name": "epsg:4326"}
               },
               "coordinates":
               [-73.979102,40.785193]
			   }
			

道路タイプの優先度

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

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

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