使用路線矩陣規劃路線 - Amazon Location Service

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用路線矩陣規劃路線

您可以使用 Amazon 定 Location Service 為您的路線規劃和優化軟體建立輸入資料。您可以為一組出發位置和一組目的地位置之間的路線創建路線結果,包括旅行時間和行駛距離。

例如,指定出發位置 A 和 B,以及目的地位置 X 和 Y,亞馬遜定 Location Service 將返回從 A 到 X、A 到 Y、B 到 X 的路線的旅行時間和旅行距離,以及從 B 返回 Y 的路線的旅行時間和旅行距離。

您可以計算具有不同交通方式,避免和交通狀況的路線。例如,您可以指定車輛是 35 英呎長的卡車,計算的路線將使用這些限制來確定行駛時間和行駛距離。

傳回的結果數 (以及計算的路線) 是出發位置數乘以目的地位置數目。您需按計算出的每條路線收費,而不是每個服務的請求,因此包含 10 個出發地和 10 個目的地的路線矩陣將以 100 條路線計費。

注意

您必須先建立路由計算機資源,並為您向 Amazon 位置的請求設定身份驗證。如需詳細資訊,請參閱 先決條件

使用提交請求CalculateRouteMatrixoperation. 最小請求包含以下必要的欄位:

  • DeparturePositions— 要計算路線的起始位置集。定義為陣列[longitude, latitude]

  • DestinationPositions— 要計算路線的結束位置集。定義為陣列[longitude, latitude]

注意

如果您指定的出發地或目的地位置不在道路上,亞馬遜地點將位置移動到最近的道路

您可以選擇性地指定出發時間,以及移動模式在您的請求中。

您可以使用AWS CLI或亞馬遜位置 API。

API

以下是CalculateRouteMatrix請求使用路線計算器資源ExampleCalculator。該請求指定計算出發位置的路線矩陣 [-122.756549.0021] 和 [-122.201447.6101] 到目的地位置 [-122.339447.6159] 和 [-122.481348.7511]。

POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ] }
AWS CLI

以下是calculate-route-matrix指令:使用路線計算器資源ExampleCalculator。該請求指定計算出發位置的路線矩陣 [-122.756549.0021] 和 [-122.201447.6101] 到目的地位置 [-122.339447.6159] 和 [-122.481348.7511]。

aws location \ calculate-route-matrix \ --calculator-name ExampleCalculator \ --departure-positions "[[-122.7565,49.0021],[-122.2014,47.6101]]" \ --destination-positions "[[-122.3394,47.6159],[-122.4813,48.7511]]"

預設情況下,回應將傳回Distance以公里為單位。您可以使用下列選用參數將測量單位變更為英哩:

  • DistanceUnit— 指定用於距離結果的單位系統。

POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ], "DistanceUnit": "Miles" }

出發和目的地位置的限制

計算路由矩陣時,您可以使用出發和目的地位置有一些限制。這些限制取決於所使用的提供者RouteCalculator資源。

限制 埃斯里 這裡
職位數 最多 10 個出發位置和 10 個目的地位置。 多達 350 個出發位置和 350 個目的地位置。
位置之間的動距離 任何一對出發和目的地位置必須彼此相距 400 公里(步行路線為 40 公里)。 所有出發地和目的地位置必須在直徑 180 公里的圓圈內。
route (路由長度 如路線的總行程時間超過 400 分鐘,路線將不會完成。 出發地和目的地點周圍偏離超過 10 公里的路線將不計算。
區域 韓國不支援計算路由矩陣。 無需額外限制。

回應範例

以下是範例請求與相應調用時的響應CalculateRouteMatrix從亞馬遜位置路由 API 進行操作。

Example request
POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ] }
Example response
{ "RouteMatrix": [ [ { "Distance": 178.764, "DurationSeconds": 7565 }, { "Distance": 39.795, "DurationSeconds": 1955 } ], [ { "Distance": 15.31, "DurationSeconds": 1217 }, { "Distance": 142.506, "DurationSeconds": 6279 } ] ], "Summary": { "DataSource": "Here", "RouteCount": 4, "ErrorCount": 0, "DistanceUnit": "Kilometers" } }