翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ルートマトリックスを計算する
<a name="calculate-route-matrix"></a>

Matrix Routing サービスは、ルーティングマトリックスを計算し、複数の出発地と目的地の間の移動時間または距離を提供します。このサービスには柔軟なカスタマイズオプションが用意されており、移動モード、交通状況、その他のルーティングパラメータを指定できます。マトリックスの計算は、サイズと形状によって異なり、正方形と長方形の両方のマトリックスをサポートし、動的またはフリーフローのトラフィックデータに対応します。

詳細については、*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>
+ **物流および e コマースの配送ルートを最適化する:** 複数の集荷場所と配送場所間の移動時間と距離を効率的に計算して、ルートを最適化します。物流企業は、この機能を使用して、都市間の効率的な経路を計画し、コストと配信時間を最小限に抑えることができます。同日または翌日のサービス用に最適化された配送期間を設定し、マルチストップ配送ルートを計画するのに最適です。
+ **ライドシェアアプリケーションでドライバーと乗客をマッチングする:** ルート計算を使用して、場所間の最速ルートを見つけて、ドライバーを最も近い乗客とマッチングします。ライドシェアアプリは、迅速な配車と降車を確保しながら、ドライバーの到着をリアルタイムで見積もり、ユーザーエクスペリエンスを向上させることができます。車、自転車、スクーターなど、さまざまな輸送モードをサポートします。
+ **フリート管理のルートを計画および最適化する:** 燃料消費量と移動時間を短縮するためにルートを最適化して、大規模なフリートを管理します。フリートマネージャーは、複数の停留所に対して車両に最も効率的なルートを割り当てることができるため、全体的な運用効率が向上します。ユースケースには、最適なルート計画が現場の訪問に不可欠なサービスフリート、輸送会社、公共事業などがあります。

## リクエストを理解する
<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)」を参照してください。

リクエストにはルート計算の **Origins** と **Destinations** が含まれ、設定と制約に基づいてマトリックスを調整するためのオプションパラメータを指定できます。詳細については、Calculate Route Matrix API の API リファレンスを参照してください。
+ `Origins`: 出発地の経度と緯度の座標のリスト。
+ `Destinations`: 目的地のリスト。
+ `OptimizeRoutingFor`:「最速」ルートや「最短」ルートなどの最適化基準。
+ `RoutingBoundary`: 計算の境界を「無制限」または特定のジオメトリに制限して定義します。
+ `Avoid`: ルート計算中に回避する特徴。有効なルートが見つからない場合は無視されます。
+ `Traffic`: ルート計算に影響する交通関連のオプション。

## レスポンスを理解する
<a name="route-matrix-response"></a>

レスポンスには、出発地と目的地の間で計算されたルートのマトリックスと、距離や期間などの詳細が含まれます。該当する場合は、ルートのエラーと境界も提供されます。Calculate Route Matrix API の詳細については、 API リファレンスを参照してください。
+ `RouteMatrix`: 出発地と目的地の間の移動距離 (メートル単位) と所要時間 (秒単位) を含むマトリックス。
+ `ErrorCount`: ルート計算中に発生したエラーの数。
+ `RoutingBoundary`: マトリックスが計算される境界。