前提条件

ルートを計算する前に、以下の手順に従って操作してください。

ルート計算リソースの作成

ルートを計算する前に、まずはAWSアカウントにルート計算リソースを追加してください。

ルート計算リソースを作成するとき、利用可能なデータプロバイダーから 1 つを選択してください。

1. — 対象地域における Esri のカバレッジの詳細については、道路網とトラフィックの対象地域に関する Esri の詳細を参照してください。

2. – 対象地域における HERE Technologies のカバレッジに関する追加情報については、「HERE 自動車ルーティングのカバレッジ」および「HERE トラックルーティングのカバレッジ」を参照してください。

3. Grab — Grab のカバレッジの詳細については、「国/地域と対象地域」を参照してください。

注記

配送車両や従業員など、ビジネスで使用する資産をアプリケーションで追跡またはルーティングする場合、位置情報プロバイダーに Esri を使用してはいけません。詳細については、「AWS サービス規約」のセクション 82 を参照してください。

Amazon Location Service コンソール、AWS CLI、または Amazon Location API を利用することができます。

Console

Amazon Location コンソールを利用してルート計算リソースを作成すること。

1. Amazon Location Service コンソール (https://console.aws.amazon.com/location/) を開きます。

2. 左のナビゲーションペインの選択肢の中に ルート計算ツール を選択してください。

3. 「ルート計算ツールを作成」 を選択してください。

4. 次のボックスに入力します。

   • コードネーム — ルート計算リソースのコードネームを入力してください。例えば、 などですExampleCalculator。最大 100 文字。には、英数字、ピリオド (.)、ハイフン (-)、アンダースコア (_) を含めることができます。

   • 説明 – 任意の説明を入力します。

5. データプロバイダーについては、ご利用されたいルート計算ツールのデータプロバイダーを選択してください。

6. （オプショナル） タグに、タグのキーと値を入力します。これにより、新しいルート計算リソースにタグが追加されます。詳細については、リソースにタグを付けるを参照してください。

7. 「ルート計算ツールを作成」 を選択してください。

API

Amazon Location API を利用してルート計算リソースを作成すること

Amazon Location プレース API CreateRouteCalculator のオペレーションを利用してください。

次の例は、データプロバイダー Esri ExampleCalculatorを使用して というルート計算リソースを作成する API リクエストです。

POST /routes/v0/calculators
Content-type: application/json

{
   "CalculatorName": "ExampleCalculator",
   "DataSource": "Esri",
   "Description": "string",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}

AWS CLI

AWS CLIコマンドを利用してルート計算リソースを作成すること

create-route-calculator コマンドを実行します。

次の例では、データプロバイダーとして Esri ExampleCalculatorを使用して、 というルート計算リソースを作成します。

aws location \
  create-route-calculator \
  --calculator-name "ExampleCalculator" \
  --data-source "Esri" \
  --tags Tag1=Value1

注記

請求は使用状況によって異なります。他の AWS サービスの利用料金が請求される場合があります。詳細については、「Amazon Location Service 料金」を参照してください。

リクエストを認証する

ルート計算リソースの作成、並びに位置情報をアプリケーションに組み込む準備ができたら、リクエストの認証方法を選択してください。

• サービスにアクセスする方法については、「Amazon Location Service へのアクセス」を参照してください。

• ウェブサイトには匿名機能を利用されるユーザーがいらっしゃる場合、API キーまたは Amazon Cognito を使うのはお勧めです。

  例

  次の例は、AWS JavaScript SDK v3 と Amazon Location を使用して、認証に API キーを使用する方法を示していますJavaScript 認証ヘルパー。

  import { LocationClient, CalculateRouteCommand } from "@aws-sdk/client-location";
  import { withAPIKey } from "@aws/amazon-location-utilities-auth-helper";
  
  const apiKey = "v1.public.your-api-key-value"; // API key
  
  // Create an authentication helper instance using an API key
  const authHelper = await withAPIKey(apiKey);
  
  const client = new LocationClient({
    region: "<region>", // region containing Cognito pool
    ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location
  });
  
  const input = {
    CalculatorName: "ExampleCalculator",
    DeparturePosition: [-123.4567, 45.6789],
    DestinationPosition: [-123.123, 45.234],
  };
  
  const command = new CalculateRouteCommand(input);
  
  const response = await client.send(command);