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

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

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

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

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

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

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

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

  2. HERE テクノロジー – 対象リージョンでの HEREのカバレッジの詳細については、HERE「カールーティングカバレッジ」とHERE「トラックルーティングカバレッジ」を参照してください。

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

注記

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

これは、Amazon Location Service コンソール、 AWS CLI、または Amazon Location を使用して行うことができますAPIs。

Console

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

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

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

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

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

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

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

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

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

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

API

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

Amazon Location Places から CreateRouteCalculatorオペレーションを使用しますAPIs。

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

POST /routes/v0/calculators Content-type: application/json { "CalculatorName": "ExampleCalculator", "DataSource": "Esri", "Description": "string", "Tags": { "Tag1" : "Value1" } }
AWS CLI

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

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

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

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

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

リクエストを認証する

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

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

  • 匿名ユーザーがいるウェブサイトがある場合は、APIKeys または Amazon Cognito を使用できます。

    次の例は、認証に API キーを使用する方法、AWS JavaScriptv3 SDK を使用する方法、および 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);