翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ルートを計算する
Routes API は、自動車、トラック、スクーター、歩行など、異なる移動モードに対応し、回避の条件の有無を指定して、2 つ以上の場所間のルートを計算します。この API を使用すると、ルーティングオプションをカスタマイズして、特定のニーズに合わせて追加のルート関連情報をリクエストできます。この API は、ターンバイターンナビゲーションをサポートしており、有料道路、高速道路、フェリーの回避などのパラメータを適用してルート計算をカスタマイズします。この API によって、速度制限と通話料金も返されます。
詳細については、Amazon Location Service API リファレンスの「CalculateRoutes」を参照してください。
この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「ルートの計算を使用する方法」を参照してください。
ユースケース
-
ルートマップに地理情報を表示する: 高度なマッピング機能を使用して、ランドマーク、地形、都市インフラストラクチャなど、豊富な地理的情報と共に詳細なルートを視覚化します。ユーザーが出発地から目的地までの明確なルートを表示できるため、意思決定が強化されます。この機能はナビゲーション、計画、さまざまな物流シナリオに対応しており、自動車、トラック、スクーター、歩行などの移動モードのルートを表示できます。回避や料金計算などの要素を追加して、ルートをカスタマイズできます。
-
ターンバイターンナビゲーションを表示する: ウェブおよびモバイルデバイスでシームレスなナビゲーションサポートを提供します。ユーザーは、効率的な移動を確保しながら、ターンバイターンの指示にアクセスできます。どちらのプラットフォームでも、ナビゲーション手順を活用し、速度制限などを指定して、個人での移動または出張のルートを提供できます。
-
ルートに沿って通行料金を計算する: 通行料金の計算をルート計画に組み込み、有料の道路、橋、トンネルを含むルートの正確な料金見積もりを提供します。ドライバーやプランナーが費用対効果の高い意思決定を行い、必要に応じて料金を回避できるように、通行料金を事前に表示します。
-
制限速度の遵守を確保する: 制限速度データを統合して、罰金のリスクを減らし、より安全で燃料効率の高い運転を促進しながら、ドライバーが法定速度で走行できるよう支援します。速度遵守をリアルタイムでモニタリングすることによって、物流とフリートの管理にも利点があります。
-
輸送および車両ルーティングソリューションのサポート: ルート、ナビゲーション、追跡機能を物流ポータルに統合して、輸送および車両ルーティングオペレーションを簡素化します。複数の配送のルートを効率的に計画し、出荷をリアルタイムで追跡して、より適切なルーティングを通じて燃料コストを管理します。
リクエストを理解する
注記
ap-southeast-1 と のお客様はap-southeast-5、サポートされているリクエストフィールドとレスポンスフィールドが異なる場合があります。詳細については、「 CalculateRoutes API リファレンス」を参照してください。
リクエストには Origin および Destination パラメータが必須ですが、Allow、Avoid、Traffic などのオプションパラメータによって、特定のニーズと制約に合わせてルートをカスタマイズできます。
- オリジン
-
経度と緯度によるルートの開始位置。
- 送信先
-
ルートの終了位置。
- ウェイポイント
-
開始位置と終了位置の間でルート沿いに指定する中間位置。
- OptimizeRoutingFor
-
最速ルートや最短ルートなど、ルートの最適化基準。
- LegGeometryFormat
-
各ルートレグに対して返されるジオメトリの形式。
- 回避
-
ルート計算時に回避する特徴。代替ルートが見つからない場合は無視されます。
- トラフィック
-
ルート計算に影響する交通関連のオプション。
- Tolls
-
ルート計算と通行料金に影響を与える通行料金関連のオプション。
- LegAdditionalFeatures
-
ジャーニーの各レグのレスポンス内で有効にできる特徴。
- SpanAdditionalFeatures
-
ジャーニーの各レグのレスポンス内で有効にできる区間に関連する特徴。
レスポンスを理解する
レスポンスは、ジャーニーのレグ、ルート計算に関する通知、距離と期間を含む概要情報などのルートの詳細を提供します。
- ルート
-
レグと関連するプロパティを含むルートの配列。
- 注意
-
ルートに関する警告または情報メッセージ。
- LegGeometryFormat
-
ルートのジオメトリの形式を指定します。
レグの詳細
ジャーニーの各レグは、移動モードに応じて、フェリー、歩行、または車両のタイプを指定できます。各レグには移動モードに依存しないプロパティが含まれていますが、以下に示す特定のプロパティを使用できます。
- FerryLegDetails
-
レグのフェリー固有のプロパティ。
- VehicleLegDetails
-
レグの車両固有のプロパティ。
- PedestrianLegDetails
-
レグの歩行固有のプロパティ。
Steps
ジャーニーの各レグは、ルートの一部のアクションの内容を提供するステップに分割されます。ステップは、基本的なアプリケーションに適した Default、またはターンバイターンナビゲーションに適した TurnByTurn のいずれです。各ステップには、期間や距離などのステップタイプに依存しないプロパティと、終了ステップにのみ適用される ExitStepDetails などのその他の特定のプロパティが含まれます。
- BeforeTravelSteps
-
ジャーニーを開始する前に行うステップ。
- TravelSteps
-
ジャーニー中に行うステップ。
- AfterTravelSteps
-
ジャーニーの終了後に行うステップ。
スパン
ジャーニーの各レグはスパンに分割できます。スパンは、リクエストされた SpanAdditionalFeatures のセットに対して同じ値を持つレグの一部です。スパンは、SpeedLimit、道路名、地域などの道路プロパティで分割されます。返されたスパンを使用すると、道路属性とアクセス関連情報を視覚化できます。
