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

# ルートを計算する
<a name="calculate-routes"></a>

Routes API は、自動車、トラック、スクーター、歩行など、異なる移動モードに対応し、回避の条件の有無を指定して、2 つ以上の場所間のルートを計算します。この API を使用すると、ルーティングオプションをカスタマイズして、特定のニーズに合わせて追加のルート関連情報をリクエストできます。この API は、ターンバイターンナビゲーションをサポートしており、有料道路、高速道路、フェリーの回避などのパラメータを適用してルート計算をカスタマイズします。この API によって、速度制限と通話料金も返されます。

詳細については、*Amazon Location Service API リファレンス*の「[CalculateRoutes](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)」を参照してください。

この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「[ルートの計算を使用する方法](https://docs.aws.amazon.com/location/latest/developerguide/calculate-routes-how-to.html)」を参照してください。

![Amazon Location Service Routes の概要。](http://docs.aws.amazon.com/ja_jp/location/latest/developerguide/images/routesV2/P2P-Turn-by-turn-navigation.gif)


## ユースケース
<a name="use-cases"></a>
+ **ルートマップに地理情報を表示する:** 高度なマッピング機能を使用して、ランドマーク、地形、都市インフラストラクチャなど、豊富な地理的情報と共に詳細なルートを視覚化します。ユーザーが出発地から目的地までの明確なルートを表示できるため、意思決定が強化されます。この機能はナビゲーション、計画、さまざまな物流シナリオに対応しており、自動車、トラック、スクーター、歩行などの移動モードのルートを表示できます。回避や料金計算などの要素を追加して、ルートをカスタマイズできます。
+ **ターンバイターンナビゲーションを表示する:** ウェブおよびモバイルデバイスでシームレスなナビゲーションサポートを提供します。ユーザーは、効率的な移動を確保しながら、ターンバイターンの指示にアクセスできます。どちらのプラットフォームでも、ナビゲーション手順を活用し、速度制限などを指定して、個人での移動または出張のルートを提供できます。
+ **ルートに沿って通行料金を計算する:** 通行料金の計算をルート計画に組み込み、有料の道路、橋、トンネルを含むルートの正確な料金見積もりを提供します。ドライバーやプランナーが費用対効果の高い意思決定を行い、必要に応じて料金を回避できるように、通行料金を事前に表示します。
+ **制限速度の遵守を確保する:** 制限速度データを統合して、罰金のリスクを減らし、より安全で燃料効率の高い運転を促進しながら、ドライバーが法定速度で走行できるよう支援します。速度遵守をリアルタイムでモニタリングすることによって、物流とフリートの管理にも利点があります。
+ **輸送および車両ルーティングソリューションのサポート:** ルート、ナビゲーション、追跡機能を物流ポータルに統合して、輸送および車両ルーティングオペレーションを簡素化します。複数の配送のルートを効率的に計画し、出荷をリアルタイムで追跡して、より適切なルーティングを通じて燃料コストを管理します。

## リクエストを理解する
<a name="understanding-request"></a>

**注記**  
 `ap-southeast-1` と のお客様は`ap-southeast-5`、サポートされているリクエストフィールドとレスポンスフィールドが異なる場合があります。詳細については、[「 CalculateRoutes API リファレンス](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)」を参照してください。

リクエストには `Origin` および `Destination` パラメータが必須ですが、`Allow`、`Avoid`、`Traffic` などのオプションパラメータによって、特定のニーズと制約に合わせてルートをカスタマイズできます。

**オリジン**  
経度と緯度によるルートの開始位置。

**送信先**  
ルートの終了位置。

**ウェイポイント**  
開始位置と終了位置の間でルート沿いに指定する中間位置。

**OptimizeRoutingFor**  
最速ルートや最短ルートなど、ルートの最適化基準。

**LegGeometryFormat**  
各ルートレグに対して返されるジオメトリの形式。

**回避**  
ルート計算時に回避する特徴。代替ルートが見つからない場合は無視されます。

**トラフィック**  
ルート計算に影響する交通関連のオプション。

**Tolls**  
ルート計算と通行料金に影響を与える通行料金関連のオプション。

**LegAdditionalFeatures**  
ジャーニーの各レグのレスポンス内で有効にできる特徴。

**SpanAdditionalFeatures**  
ジャーニーの各レグのレスポンス内で有効にできる区間に関連する特徴。

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

レスポンスは、ジャーニーのレグ、ルート計算に関する通知、距離と期間を含む概要情報などのルートの詳細を提供します。

**ルート**  
レグと関連するプロパティを含むルートの配列。

**注意**  
ルートに関する警告または情報メッセージ。

**LegGeometryFormat**  
ルートのジオメトリの形式を指定します。

### レグの詳細
<a name="leg-details"></a>

ジャーニーの各レグは、移動モードに応じて、フェリー、歩行、または車両のタイプを指定できます。各レグには移動モードに依存しないプロパティが含まれていますが、以下に示す特定のプロパティを使用できます。

**FerryLegDetails**  
レグのフェリー固有のプロパティ。

**VehicleLegDetails**  
レグの車両固有のプロパティ。

**PedestrianLegDetails**  
レグの歩行固有のプロパティ。

### Steps
<a name="steps"></a>

ジャーニーの各レグは、ルートの一部のアクションの内容を提供するステップに分割されます。ステップは、基本的なアプリケーションに適した Default、またはターンバイターンナビゲーションに適した TurnByTurn のいずれです。各ステップには、期間や距離などのステップタイプに依存しないプロパティと、終了ステップにのみ適用される ExitStepDetails などのその他の特定のプロパティが含まれます。

**BeforeTravelSteps**  
ジャーニーを開始する前に行うステップ。

**TravelSteps**  
ジャーニー中に行うステップ。

**AfterTravelSteps**  
ジャーニーの終了後に行うステップ。

### スパン
<a name="spans"></a>

ジャーニーの各レグはスパンに分割できます。スパンは、リクエストされた `SpanAdditionalFeatures` のセットに対して同じ値を持つレグの一部です。スパンは、`SpeedLimit`、道路名、地域などの道路プロパティで分割されます。返されたスパンを使用すると、道路属性とアクセス関連情報を視覚化できます。