1 つのルートの計算 - Amazon Location Service
ルート計算の開始ウェイポイントレスポンスの例

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

1 つのルートの計算

Amazon Location Service を使って、さまざまな交通手段、回避路線、交通状況に応じて、出発地から目的地まで、最大には 23 のウェイポイントを設置することができ、そのすべての経由地点の間のルートを計算することができます。

注記

まず、ルート計算リソースを作成して、それからAmazon Location へのリクエストの認証を設定するのは必要です。詳細については、「前提条件」を参照してください。

ルート計算の開始

CalculateRouteオペレーションで簡単にクエストを送信します。シンプルなリクエストには、次のフィールド必要です。

  • DeparturePosition— ルートを計算する開始位置。[longitude, latitude]と定義されます。

  • DestinationPosition— ルートを計算する終了位置。[longitude, latitude]と定義されています。

注記

出発地または目的地の位置が地図に載っていない場合、Amazon Locationはその位置を最も近い道路に変更します。

もしリクエストがあれば、オプションでウェイポイント、出発時刻、または移動モードを選択することができます。

AWS CLIまたは Amazon Location API を使用することができます。

API

次の例は、ルート計算リソース を使用したCalculateRouteリクエストですExampleCalculator。このリクエストは、出発位置 -122.7565, 49.0021から目的地位置 -122.3394, 47.6159までのルートを計算することを説明します。

POST /routes/v0/calculators/ExampleCalculator/calculate/route
Content-type: application/json
{
   "DeparturePosition": [-122.7565,49.0021],
   "DestinationPosition": [-122.3394, 47.6159]
}
AWS CLI

次の例は、ルート計算リソース を使用するcalculate-routeコマンドですExampleCalculator。このリクエストは、出発位置 -122.7565, 49.0021から目的地位置 -122.3394, 47.6159までのルートを計算することを説明します。

aws location \
    calculate-route \
        --calculator-name ExampleCalculator \
        --departure-position -122.7565 49.0021 \
        --destination-position -122.3394 47.6159

デフォルトでは、Distance は JSON 形式で応答を返します。以下のオプションの中のパラメータを利用すれば、計測単位をマイルに変更することができます。

  • 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です。

  • リクエストパラメータ

    • 最初のウェイポイントは -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
}

レスポンスの例

以下は、true IncludeLegGeometry に設定した Amazon Location Routes API CalculateRoute からのオペレーションを呼び出したときの、対応するレスポンスを含むリクエストの例です。これには、レスポンス内のポジションペアの間の各パスのラインストリングジオメトリが含まれます。

Example request
POST /routes/v0/calculators/ExampleCalculator/calculate/route
Content-type: application/json
{
   "DeparturePosition": [-122.7565,49.0021],
   "DestinationPosition": [-122.3394, 47.6159],
   "IncludeLegGeometry": true
}
Example response
{
   "Legs": [ 
      { 
         "Distance": 178.5,
         "DurationSeconds": 6480,
         "EndPosition": [-122.3394,47.6159],
         "Geometry": { 
            "LineString": [ 
               [-122.7565,49.0021],
               [-122.3394,47.6159]
            ]
         },
         "StartPosition": [-122.7565,49.0021],
         "Steps": [ 
            { 
               "Distance": 178.5,
               "DurationSeconds": 6480,
               "EndPosition": [-122.3394,47.6159],
               "GeometryOffset": 0,
               "StartPosition": [-122.7565,49.0021]
            }
         ]
      }
   ],
   "Summary": { 
      "DataSource": "Esri",
      "Distance": 178.5,
      "DistanceUnit": "Kilometers",
      "DurationSeconds": 6480,
      "RouteBBox": [
        -122.7565,49.0021,
        -122.3394,47.6159
    ]
   }
}