Amazon Location を使用してルートを計算するための前提条件 - Amazon Location Service
ルート計算リソースを作成するリクエストを認証する

Amazon Location を使用してルートを計算するための前提条件

このページでは、サービスでルーティング機能 (複数地点間の最適ルートと移動時間を計算可能) を開始するための前提条件について説明します。AWS アカウント内でのアクセス許可の設定、必要なリソースの設定のほか、特定のユースケースや開発環境に基づいて必要になる追加の依存関係やツールなど、重要なトピックを網羅しています。

ルート計算リソースを作成する

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

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

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

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

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

注記

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

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

Console

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

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

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

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

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

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

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

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

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

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

API

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

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

次の例は、データプロバイダーの Esri を利用して計算例というルート計算リソースを作成する 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 を使うのはお勧めです。

    例

    以下の例では、API キーによる認可方法、AWS JavaScript SDK v3 と Amazon Location 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);