候補 - Amazon Location Service
ユースケースリクエストを理解するレスポンスを理解する

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

候補

Suggest は、関連する場所、対象ポイント、クエリ用語、検索カテゴリなど、ユーザーの入力またはコンテキストに基づいて予測またはレコメンデーションを提供します。これにより、ユーザーは場所、対象ポイントを検索したり、不完全またはスペルミスの入力に基づいてフォローアップクエリを特定したりできます。API は可能な一致または絞り込みのリストを返します。このリストを使用して、より正確なクエリを作成できます。ユーザーは、さらに検索するために適切な提案を選択できます。API は、場所やその他の属性による結果のフィルタリングをサポートし、音素やタイムゾーンなどの追加機能を提供します。レスポンスには、洗練されたクエリ用語と詳細な場所情報が含まれます。

注記

デフォルトでは、提案 API は フィールドIDと Titleフィールドのみを返します。費用対効果の高いオプションを提供します。追加のアドレスコンポーネントとハイライトは、 additionalFeaturesを に設定することでリクエストできますCore。保存された結果に関連するコストへの影響プレイスの料金については、「」を参照してください。

詳細については、「Amazon Location Service API リファレンス」の「提案」を参照してください。

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

ユースケース

  • Ride-Hailing Services: 集荷場所と集荷場所の住所をすばやく完了するためのリアルタイムの提案を提供し、正確性と乗車予約の迅速化を実現します。

  • Travel and Navigation Services: 「Eiffel Tower」の「Eifel」など、スペルミスや部分的に入力された用語でも、場所やランドマークをリアルタイムで予測できます。API は提案を絞り込み、関連する近くの対象ポイントを提供し、ユーザーが場所を正確に見つけられるようにします。

  • レストランの検索支援： レストランへのユーザーの関心を予測し、近くのレストランオプションを提案して、検索エクスペリエンスを強化します。

リクエストを理解する

提案 API リクエストは、パラメータを使用してユーザー入力に基づいて提案を生成します。オプションのパラメータを使用すると、位置バイアスとフィルタリング条件を使用して検索結果を絞り込むことができます。詳細については、「 API リファレンスの提案」を参照してください。

リクエストには、次のキーパラメータが含まれます。

認証

他の認証方法を使用する場合、 Keyパラメータはオプションです。

  • Key: 認可用の API キー。

詳細については、Amazon Location Service による認証を参照してください。

クエリ

フリーテキスト検索と位置バイアスを定義します。

  • QueryText: 提案を生成するための自由形式のテキスト (必須）

  • BiasPosition: 特定の経度と緯度に近い提案を優先します。

詳細については、クエリとバイアスを参照してください。

結果の絞り込み

結果をフィルタリングして検索条件を絞り込みます。

  • Filter: 境界ボックスまたは円形領域によるフィルタリングを許可して、検索結果を制限します。

詳細については、「フィルタリング」を参照してください。

国際化とローカリゼーション

言語をカスタマイズし、結果に政治的ビューを適用するためのオプション。

  • Language: 結果の言語を指定します。

  • PoliticalView: 領土クレームを反映した政治的見解を適用します。

詳細については、ローカリゼーションと国際化を参照してください。

その他の機能

タイムゾーン情報などの追加データをリクエストします。

  • AdditionalFeatures: タイムゾーンや音声データなどの追加の詳細をリクエストするオプション。

詳細については、その他の機能を参照してください。

結果の制限

返される結果またはクエリ絞り込みの数に制限を設定します。

  • MaxQueryRefinements: 返されるクエリ絞り込み条件の数を制限します。

  • MaxResults: 返される候補の数を制限します。

レスポンスを理解する

レスポンスは、入力クエリに基づいて、ロケーション、住所の詳細、ビジネスチェーン、連絡先、音素、タイムゾーン、営業時間などの属性を含む、提案された住所または場所を提供します。API はResultItems、入力クエリを完了するための一致候補を表す を返します。によって識別される結果には 2 つのタイプがありますSuggestResultItemType。タイプ の結果はフォローアップカテゴリまたはチェーンクエリQueryを示唆し、 を SearchText API QueryIDに渡すことで、指定されたカテゴリの焦点を絞った結果を取得するために使用できます。タイプの結果は、住所と場所に関する追加情報を含む最終結果Placeを提供します。詳細については、「 API Reference for Suggest API」を参照してください。

レスポンスには、次のキーデータが含まれます。

結果分析

入力クエリの改良に関する情報を提供します。

  • QueryRefinements: 検索クエリを絞り込むために使用できる用語。

  • Highlights: クエリに一致するアドレスまたはタイトルの一部を強調表示します。

プレイスタイプとカテゴリ

場所のタイプとカテゴリについて説明します。

  • Categories: レストランや学校など、場所を説明するカテゴリ。

  • PlaceType: 都市、住所、リージョンなど、場所のタイプを指定します。

  • BusinessChains: 関連するビジネスチェーンを示します。

その他の詳細

リクエストで指定された場所に関する追加情報。

  • Contacts: E メール、電話番号、ウェブサイトを提供します。

  • OpeningHours: 場所の運用時間。

  • AccessPoints: 場所に関連付けられた地理的座標。

  • Phonemes: アドレスコンポーネントの音声表現。

  • TimeZone: オフセットを含むタイムゾーン情報。