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

# 計算路由矩陣
<a name="calculate-route-matrix"></a>

矩陣路由服務會計算路由矩陣，提供多個原始伺服器和目的地之間的行程時間或距離。此服務提供彈性的自訂選項，可讓您指定行程模式、流量條件和其他路由參數。矩陣計算的大小和形狀可能有所不同，同時支援正方形和非正方形矩陣，並容納動態或自由流動流量資料。

如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [CalculateRouteMatrix](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html)。

如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱[如何使用計算路由矩陣](https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix-how-to.html)。

## 使用案例
<a name="route-matrix-use-cases"></a>
+ **最佳化物流和電子商務的交付路由：**有效率地計算多個取件和交付地點之間的行程時間和距離，以最佳化路由。物流公司可以使用此功能，透過規劃跨城市的高效路徑，將成本和交付時間降至最低。它非常適合為當日或次日服務設定最佳化交付時段，並規劃多站交付路由。
+ **在共乘應用程式中比對駕駛和乘客：**透過尋找位置之間的最快路線，使用路由計算來比對駕駛與最接近乘客。共乘應用程式可以透過提供即時駕駛人抵達估計來增強使用者體驗，確保快速取件和下車。支援各種運輸模式，例如汽車、自行車和機車。
+ **規劃和最佳化機群管理的路由：**透過最佳化路由來管理大型機群，以減少油耗和行駛時間。機群管理員可以將最有效率的路由指派給多個停靠站的車輛，從而提高整體營運效率。使用案例包括服務機群、運輸公司和公用程式，其中最佳路由規劃對於網站造訪至關重要。

## 了解請求
<a name="route-matrix-request"></a>

**注意**  
 對於 `ap-southeast-1`和 中的客戶`ap-southeast-5`，支援的請求和回應欄位可能會有所不同。如需詳細資訊，請參閱 [CalculateRouteMatrix API 參考](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html)。

請求包含路由計算的**原始**伺服器和**目的地**，以及根據偏好設定和限制條件量身打造矩陣的選用參數。如需詳細資訊，請參閱計算路由矩陣 API 的 API 參考。
+ `Origins`：以經度和緯度表示的原始座標清單。
+ `Destinations`：目的地座標的清單。
+ `OptimizeRoutingFor`：最佳化條件，例如 "Fastest" 或 "Shortest" 路由。
+ `RoutingBoundary`：定義要計算的邊界，可以是「無限制」或限制在特定幾何。
+ `Avoid`：在路由計算期間要避免的功能。如果找不到可行的路由，則忽略。
+ `Traffic`：與流量相關的選項會影響路由計算。

## 了解回應
<a name="route-matrix-response"></a>

回應包含原始伺服器和目的地之間計算路由的矩陣，以及距離和持續時間等詳細資訊。如果適用，也會提供路由的錯誤和界限。如需計算路由矩陣 API 的其他詳細資訊，請參閱 API 參考。
+ `RouteMatrix`：包含原始伺服器與目的地之間的行程距離 （以公尺為單位） 和持續時間 （以秒為單位） 的矩陣。
+ `ErrorCount`：在路由計算期間遇到的錯誤數目。
+ `RoutingBoundary`：計算矩陣的邊界。