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

# テキスト検索
<a name="search-text"></a>

Search Text を使用すると、単一の自由形式のテキスト入力を使用して位置データをクエリし、国、地理的な円、境界ボックスなどのオプションのフィルターを使用して位置の結果を返すことができます。API は、Suggest API から返された `QueryId` による検索も有効にします。レスポンスには、場所名、住所、電話番号、カテゴリ、食品タイプ、連絡先情報、営業時間などの詳細が含まれます。指定したパラメータに基づいて、音素、タイムゾーンなどのオプション機能も使用できます。

**注記**  
結果を保存すると、より高いストレージ料金階層で請求されます。`IntendedUse` パラメータを使用して、結果を単回使用するか保存するかを指定します。保存された結果に関連するコストへの影響については、「[場所の料金](places-pricing.md)」を参照してください。

詳細については、「*Amazon Location Service API リファレンス*」の「[SearchText](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html)」を参照してください。

この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「[検索テキストの使用方法](https://docs.aws.amazon.com/location/latest/developerguide/search-text-how-to.html)」を参照してください。

## ユースケース
<a name="search-text-use-cases"></a>
+ **テキストによる近傍検索:** お客様が最も近い関連場所を見つけるのに役立ちます。お客様は、美術館または博物館、ショップ、公園など、最寄りの住所、ビジネス、名所を見つけることができます。
+ **ビジネス検出:** 「イタリア料理のレストラン」や「コーヒーショップ」などのキーワードを入力して、特定のビジネスやタイプの場所を見つけることをユーザーに許可します。この機能は、フードデリバリーやレストランのレコメンデーションアプリに特に役立ちます。
+ **旅行アプリで場所を検索する:** ユーザーは、「エッフェル塔に近いホテル」などの自由形式のテキストを使用してロケーション、ランドマーク、またはビジネスを検索し、関連する提案をすばやく受け取ることができます。
+ **教育機関検索:** ユーザーが学校、大学、またはトレーニングセンター (「小学校」、「大学」など) を検索できるようにします。これは、親や学生に役立つツールです。

## リクエストを理解する
<a name="search-text-request-parameters"></a>

**注記**  
 `ap-southeast-1` と のお客様は`ap-southeast-5`、サポートされているリクエストフィールドとレスポンスフィールドが異なる場合があります。詳細については、[SearchText API リファレンス](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html)」を参照してください。

Search Text API リクエストでは、さまざまなパラメータで検索を絞り込むことができます。オプションパラメータを使用すると、追加機能、位置バイアス、フィルタリング条件、言語設定、結果の制限が可能になります。詳細については、「Search Text API リファレンス」を参照してください。

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

**認証**  
他の認証方法を使用する場合、`Key` パラメータはオプションです。  
+ `Key`: 認証用の API キー。
詳細については、「[Amazon Location Service を使用して認証する](access.md)」を参照してください。

**クエリ**  
テキスト検索と位置バイアスの指定に使用されるパラメータ。  
+ `QueryText`: 場所を検索するための自由形式のテキスト。
+ `QueryId`: Suggest API から提案されたクエリを完了できるようにします。
+ `BiasPosition`: 特定の経度と緯度に近い結果を優先します。
詳細については、「[クエリとバイアス](places-querying-biasing.md)」を参照してください。

**結果の絞り込み**  
結果をフィルタリングして検索条件を絞り込みます。  
+ `Filter`: 境界ボックスまたは円形の領域によるフィルタリングを許可して、検索結果を制限します。
詳細については、[フィルタリング](places-filtering.md)を参照してください。

**国際化とローカリゼーション**  
言語をカスタマイズし、結果にポリティカルビューを適用するためのオプション。  
+ `Language`: 結果の言語を指定します。
+ `PoliticalView`: 領土主張を反映したポリティカルビューを適用します。
詳細については、「[ローカリゼーションと国際化](places-localization-internationalization.md)」を参照してください。

**その他の機能**  
タイムゾーン情報などの追加データをリクエストします。  
+ `AdditionalFeatures`: タイムゾーンの詳細などの追加データをリクエストするオプション。
詳細については、「[その他の機能](additional-features.md)」を参照してください。

## レスポンスを理解する
<a name="search-text-response-details"></a>

Search Text API からのレスポンスには、場所、住所の詳細、ビジネスチェーン、連絡先、電話、タイムゾーン、営業時間に関する情報を含む、クエリに一致する詳細な結果が含まれます。詳細については、「Search Text API リファレンス」を参照してください。

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

**住所と関連情報**  
返される場所の包括的な住所情報。  
+ `Address`: 国、番地、その他の住所の詳細が含まれます。

**場所のタイプとカテゴリ**  
場所のタイプとカテゴリについて説明します。  
+ `Categories`: *レストラン*や*学校*など、場所を説明するカテゴリのリスト。
+ `PlaceType`: 都市、住所、リージョンなど、場所のタイプを指定します。
+ `BusinessChains`: 関連するビジネスチェーンを示します。

**追加の詳細**  
必要に応じた、場所に関連する追加データ。  
+ `Contacts`: E メール、電話番号、ウェブサイトを提供します。
+ `OpeningHours`: 場所の稼働時間。
+ `AccessPoints`: 場所に関連付けられた地理的座標。
+ `Phonemes`: 住所コンポーネントの音声表現。
+ `TimeZone`: オフセットを含むタイムゾーン情報。