Autocomplete

Autocomplete は、部分的な入力に基づいて完全なアドレスとアドレスコンポーネントを返します。主なユースケースには、アドレスフォームの自動入力と先行アドレスの入力 (エンドユーザーが入力している間にインタラクティブにアドレスを完了する) が含まれます。

注記

デフォルトでは、結果ごとにプレース ID、プレースタイプ、ラベル属性のみが返されます。インタラクティブなユースケースの完全なアドレス内訳や入力ハイライト範囲など、豊富な追加詳細は、AdditionalFeatures入力属性を設定することで取得できますが、追加機能のリクエストは に影響する可能性があることに注意してください。 場所の料金

注記

日本語アドレスはサポートされていません。

結果は常に住所、または通り、郵便番号、国などの住所コンポーネントです。対象ポイントは返されません。Autocomplete はジオコーディングではなくアドレス補完に焦点を当てているため、結果にはジオコードは含まれません。アドレスジオコード座標を取得するには、ジオコードオペレーションを使用します。結果は地理的領域でフィルタリングできます。ローカリティのみや郵便番号のみを含めるなど、場所タイプでフィルタリングすることもできます。

すべての Autocomplete リクエストおよびレスポンス属性の詳細については、「Amazon Location Service API リファレンス」の「Autocomplete」を参照してください。

この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「Autocomplete の使用方法」を参照してください。

ユースケース

• チェックアウトエクスペリエンスの向上: 顧客が e コマースチェックアウトエクスペリエンスやその他のアドレスエントリエクスペリエンスに住所を入力すると、ウェブサイトやアプリで住所をリアルタイムで入力できます。配送場所または集荷場所が既知の住所と一致するようにし、コストのかかるエラーを減らし、顧客満足度を向上させます。

• サポートカスタマーサービス: コンタクトセンターや緊急サービスディスパッチなどの分野のカスタマーサービス担当者にリアルタイムの住所提案を行い、正確な住所情報を収集するプロセスを合理化し、正しい住所情報を取得するのに必要な時間を短縮することでユーザーの満足度を向上させます。

リクエストを理解する

Autocomplete オペレーションは、検索結果を絞り込むための多くのオプションのリクエスト属性をサポートしています。リクエスト属性の完全なリストについては、「Amazon Location Service API リファレンス」の「Autocomplete」を参照してください。

リクエストは、次のキーパラメータを受け入れます。

認証

オートコンプリート API オペレーションは、2 つの代替認証モードをサポートしています。SigV4 署名でリクエストに署名するか、API キーを指定して認証できます。

• 言語固有の AWS SDK または AWS CLI を使用してリクエストを行う場合、リクエストは通常、デフォルトで SigV4 で署名されます。

• ウェブブラウザからのリクエストや、AWS SDK 以外の他のクライアントの使用など、一部のユースケースでは、API キーの方がより適切な認証形式です。オプションのキーリクエスト属性を使用して、 を認証するための API キーを指定しますAutocomplete。

詳細については、Amazon Location Service API リファレンスAmazon Location Service を使用して認証するの「」を参照してください。

クエリするアドレスの指定

• クエリする自由形式のテキストを指定するには、必須のQueryTextリクエスト属性を使用します。

• BiasPosition: オプションのBiasPositionリクエスト属性を使用してピン位置を[longitude, latitude]座標ペアとして指定し、返される結果の関連性を向上させます。

詳細については、Amazon Location Service API リファレンスクエリとバイアスの「」を参照してください。

すべてのレスポンス属性を含める

オプションのフィールド AdditionalFeatures を値 ["Core"] に設定して、完全な住所の内訳やインタラクティブなハイライトの場所など、使用可能なすべての結果属性をレスポンスに含めます。これらの追加の属性をリクエストすると、料金に影響する可能性があることに注意してください。

結果を絞り込む

Filter 属性を使用して、特定の国、場所タイプ、または地理的地域に基づいて返された結果をフィルタリングします。詳細については、「Amazon Location Service デベロッパーガイドフィルタリング」の「」を参照してください。

レスポンスを理解する

レスポンスオブジェクトには、関連性の昇順にランク付けResultItemsされた結果のリストを含む という名前の配列属性が含まれています。結果項目属性の完全なリストについては、「Amazon Location Service API リファレンス」の「Autocomplete」を参照してください。

以下は、より重要な結果項目属性の簡単なリストです。

住所と関連情報

• PlaceType には結果の場所タイプが含まれており、アドレスがポイントアドレス、通りなどを表すかどうかがわかります。によって返される結果Autocompleteには、常に完全な住所または住所のコンポーネントを表す場所タイプがあります。たとえば、市外局番や郵便番号などです。結果に対象ポイントが含まれることはありません。

• Address には結果ラベルが含まれており、 に ["Core"]を指定した場合AdditionalFeatures、住所の完全な内訳が、自宅番号、住所、郵便番号、国などの構造化フィールドにも含まれます。

結果分析

入力クエリに関連する各結果の分析データを提供します。

• Distance: リクエストで が指定されBiasPositionている場合、各結果項目には、 からの結果の距離をメートル単位で示すDistance属性が含まれますBiasPosition。AdditionalFeatures を ["Core"]に設定する必要があります。

• Highlights は、入力の単語、フレーズ、部分文字列が結果属性で正確にQueryText表示される場所を示します。これにより、アプリケーションはユーザーの一致を強調する便利なユーザーエクスペリエンスを提供できます。AdditionalFeatures を ["Core"]に設定する必要があります。