翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
テキストの検索
注記
結果を保存すると、より高いストレージ料金階層で請求されます。IntendedUse
パラメータを使用して、結果がシングルユースかストレージかを指定します。保存された結果に関連するコストへの影響プレイスの料金については、「」を参照してください。
検索テキストを使用すると、単一の自由形式のテキスト入力を使用して位置データをクエリし、国、地理的円、境界ボックスなどのオプションのフィルターを使用して位置の結果を返すことができます。API は、提案 API からQueryId
返された による検索も有効にします。レスポンスには、場所名、住所、電話番号、カテゴリ、食品タイプ、連絡先情報、営業時間などの詳細が含まれます。指定したパラメータに基づいて、音素、タイムゾーンなどのオプション機能も使用できます。
ユースケース
-
テキストによる近傍検索: 顧客が最も近い関連場所を見つけるのに役立ちます。お客様は、ミュージション、ショップ、公園など、最寄りの住所、ビジネス、名所を見つけることができます。
-
ビジネス検出: 「イタリアのレストラン」や「コーヒーショップ」などのキーワードを入力して、特定のビジネスやタイプの場所を見つけることをユーザーに許可します。この機能は、フードデリバリーやレストランのレコメンデーションアプリに特に役立ちます。
-
旅行アプリで検索する: ユーザーは、「Eiffel Tower に近いホテル」などの自由形式のテキストを使用してロケーション、ランドマーク、またはビジネスを検索し、関連する提案をすばやく受け取ることができます。
-
教育機関の検索: ユーザーが学校、大学、またはトレーニングセンター (「大学」など) を検索できるようにします。これは、親や学生にとって便利なツールです。
リクエストを理解する
Search Text API リクエストでは、さまざまなパラメータで検索を絞り込むことができます。オプションパラメータを使用すると、追加機能、位置バイアス、フィルタリング条件、言語設定、結果の制限が可能になります。詳細については、「Search Text API Reference」を参照してください。
リクエストには、次のキーパラメータが含まれます。
- 認証
-
他の認証方法を使用する場合、
Key
パラメータはオプションです。Key
: 認可用の API キー。
詳細については、「Amazon Location Service による認証」を参照してください。
- クエリ
-
テキスト検索と位置バイアスの指定に使用されるパラメータ。
QueryText
: 場所を検索するための自由形式のテキスト。QueryId
: Suggest API から提案されたクエリを完了できるようにします。BiasPosition
: 特定の経度と緯度に近い結果を優先します。
詳細については、「クエリとバイアス」を参照してください。
- 結果の絞り込み
-
結果をフィルタリングして検索条件を絞り込みます。
Filter
: 境界ボックスまたは円形領域によるフィルタリングを許可して、検索結果を制限します。
詳細については、「フィルタリング」を参照してください。
- 国際化とローカリゼーション
-
言語をカスタマイズし、結果に政治的ビューを適用するためのオプション。
Language
: 結果の言語を指定します。PoliticalView
: 領土クレームを反映した政治的見解を適用します。
詳細については、「ローカリゼーションと国際化」を参照してください。
- その他の機能
-
タイムゾーン情報などの追加データをリクエストします。
AdditionalFeatures
: タイムゾーンの詳細などの追加データをリクエストするオプション。
詳細については、「その他の機能」を参照してください。
レスポンスを理解する
Search Text API からのレスポンスには、場所、住所の詳細、ビジネスチェーン、連絡先、電話、タイムゾーン、営業時間に関する情報を含む、クエリに一致する詳細な結果が含まれます。詳細については、「Search Text API Reference」を参照してください。
レスポンスには、次のキーデータが含まれます。
- アドレスと関連の詳細
-
返される場所の包括的な住所情報。
Address
: 国、番地、その他の住所の詳細が含まれます。
- 場所のタイプとカテゴリ
-
場所のタイプとカテゴリについて説明します。
Categories
: レストランや学校など、場所を説明するカテゴリのリスト。PlaceType
: 都市、住所、リージョンなど、場所のタイプを指定します。BusinessChains
: 関連するビジネスチェーンを示します。
- 追加の詳細
-
必要に応じて、場所に関連する追加データ。
Contacts
: E メール、電話番号、ウェブサイトを提供します。OpeningHours
: 場所の運用時間。AccessPoints
: 場所に関連付けられた地理的座標。Phonemes
: アドレスコンポーネントの音声表現。TimeZone
: オフセットを含むタイムゾーン情報。