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

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

## リクエストを理解する
<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**  
ジャーニーの各レグのレスポンス内で有効にできる区間に関連する特徴。

**TravelMode**  
トランスポートモードを指定します。サポートされている値には、`Car`、`Truck`、、`Scooter`、`Pedestrian``Transit`、および が含まれます`Intermodal`。

**TravelModeOptions**  
トラベルモード固有のオプション。(許可/除外モード、最大転送数、歩行者オプション`Transit`など) および `Intermodal` (トランジット、レンタル、タクシー、車両、歩行者オプションなど) のオプションが含まれます。

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

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

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

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

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

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

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

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

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

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

**TransitLegDetails**  
トランジットライン情報、停止、スケジュールなど、レッグのトランジット固有のプロパティ。

**RentalLegDetails**  
カーシェアの詳細など、レッグのレンタル固有のプロパティ。

**TaxiLegDetails**  
レッグのタクシー固有のプロパティ。

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

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

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

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

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

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

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