翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Location でルートを計算する
Amazon Location Service を使って、さまざまな交通手段、回避路線、交通状況に応じて、出発地から目的地まで、最大には 23 のウェイポイントを設置することができ、そのすべての経由地点の間のルートを計算することができます。
注記
まず、ルート計算リソースを作成して、それからAmazon Location へのリクエストの認証を設定するのは必要です。詳細については、「Amazon Location を使用してルートを計算するための前提条件」を参照してください。
ルート計算の開始
CalculateRoute オペレーションで簡単にクエストを送信します。シンプルなリクエストには、次のフィールド必要です。
-
DeparturePosition— ルートを計算する開始位置。[longitude, latitude]と定義されます -
DestinationPosition— ルートを計算する終了位置。[longitude, latitude]と定義されます。
注記
出発地または目的地の位置が地図に載っていない場合、Amazon Location はその位置を最も近い道路に変更します。
もしリクエストがあれば、オプションでウェイポイント、出発時刻、または移動モードを選択することができます。
AWS CLI または Amazon Location を使用できますAPIs。
デフォルトでは、レスポンスは Distance をキロメートルで返します。以下のオプションの中のパラメータを利用すれば、計測単位をマイルに変更することができます。
-
DistanceUnit— 距離を計算するシステムを指定します。
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "DistanceUnit": "Miles" }
ウェイポイントの設定
ルートを計算するとき、ウェイポイントの位置を利用して、出発地と目的地の間の経由地点が最大 23 か所を設置することができます。
-
WaypointPositions— 出発地と目的地の間のルートに含まれる経由地点の順序を指定することが必要です。注記
ウェイポイントの位置が道路上にない場合、Amazon Location はその位置を最も近い道路に変更します。
次の CalculateRoute リクエストは、2 つのウェイポイントのあるルートを計算します。
-
出発地は [-122.7565, 49.0021] で、目的地の位置は [-122.3394, 47.6159] です。
-
リクエストパラメータ
WaypointPositionsの場合:-
最初のストップオーバー位置は [
-122.1884, 48.0936]. -
2 番目のストップオーバー位置は [
-122.3493, 47.6205].
-
-
これらの 2 つのウェイポイントの間にレッグラインストリングジオメトリを含めるには、次のオプションパラメータを に設定します。
true:-
IncludeLegGeometry— 2 つの位置の間の各路線の形状データがレスポンスに含まれます。
-
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "WaypointPositions":[ [-122.1884,48.0936], [-122.3493,47.6205] ], "IncludeLegGeometry":true}
レスポンスの例
以下は、 を IncludeLegGeometryに設定して Amazon Location Routes から CalculateRouteオペレーションを呼び出すときの、対応するレスポンスAPIを持つリクエストの例です。true。これには、レスポンス内の位置のペア間の各パスのライン文字列ジオメトリが含まれます。
