Amazon Location での場所の前提条件
ジオコーディング、リバースジオコーディング、または場所の検索を開始する前に、前提条件となる手順に従ってください。
プレースインデックスリソースの作成
まず、AWS アカウントでプレースインデックスリソースを作成します。
プレースインデックスリソースを作成すると、ジオコーディング、リバースジオコーディング、検索のクエリをサポートするデータプロバイダーを選択できます。
-
Esri — 対象地域における Esri のカバレッジの詳細については、Esri のドキュメントの「Esri のジオコーディングカバレッジ
」を参照してください。 -
HERE テクノロジー — 対象地域における HERE のカバレッジの詳細については、HERE ドキュメントの「HERE ジオコーディングカバレッジ
」を参照してください。 -
Grab — Grab は東南アジアのデータのみ提供します。イベントの詳細については、このガイドの「国/地域と対象地域」を参照してください。
Amazon Location Service コンソール、AWS CLI、または Amazon Location API を利用することができます。
注記
請求は使用状況によって異なります。他の AWS サービスの利用料金が請求される場合があります。詳細については、「Amazon Location Service 料金
リクエストを認証する
プレースインデックスリソースを作成し、アプリケーションに位置情報を組み込む準備ができたら、リクエストの認証方法を選択します。
-
サービスにアクセスする方法については、「Amazon Location Service へのアクセス」を参照してください。
-
ウェブサイトには匿名機能を利用されるユーザーがいらっしゃる場合、API キーまたは Amazon Cognito を使うのはお勧めです。
例
以下の例では、API キーによる認可方法、AWS JavaScript SDK v3
と Amazon Location JavaScript 認証ヘルパー の使用方法をしています。 import { LocationClient, SearchPlaceIndexForTextCommand } 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 = { IndexName: "ExamplePlaceIndex", Text: "Anyplace", BiasPosition: [-123.4567, 45.6789] }; const command = new SearchPlaceIndexForTextCommand(input); const response = await client.send(command);
