テキスト検索 - Amazon Location Service
ユースケースリクエストを理解するレスポンスを理解する

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

テキスト検索

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

注記

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

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

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

ユースケース

  • テキストによる近傍検索: お客様が最も近い関連場所を見つけるのに役立ちます。お客様は、美術館または博物館、ショップ、公園など、最寄りの住所、ビジネス、名所を見つけることができます。

  • ビジネス検出: 「イタリア料理のレストラン」や「コーヒーショップ」などのキーワードを入力して、特定のビジネスやタイプの場所を見つけることをユーザーに許可します。この機能は、フードデリバリーやレストランのレコメンデーションアプリに特に役立ちます。

  • 旅行アプリで場所を検索する: ユーザーは、「エッフェル塔に近いホテル」などの自由形式のテキストを使用してロケーション、ランドマーク、またはビジネスを検索し、関連する提案をすばやく受け取ることができます。

  • 教育機関検索: ユーザーが学校、大学、またはトレーニングセンター (「小学校」、「大学」など) を検索できるようにします。これは、親や学生に役立つツールです。

リクエストを理解する

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

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

認証

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

  • Key: 認証用の API キー。

詳細については、「Amazon Location Service を使用して認証する」を参照してください。

クエリ

テキスト検索と位置バイアスの指定に使用されるパラメータ。

  • QueryText: 場所を検索するための自由形式のテキスト。

  • QueryId: Suggest API から提案されたクエリを完了できるようにします。

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

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

結果の絞り込み

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

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

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

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

言語をカスタマイズし、結果にポリティカルビューを適用するためのオプション。

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

  • PoliticalView: 領土主張を反映したポリティカルビューを適用します。

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

その他の機能

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

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

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

レスポンスを理解する

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

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

住所と関連情報

返される場所の包括的な住所情報。

  • Address: 国、番地、その他の住所の詳細が含まれます。

場所のタイプとカテゴリ

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

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

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

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

追加の詳細

必要に応じた、場所に関連する追加データ。

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

  • OpeningHours: 場所の稼働時間。

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

  • Phonemes: 住所コンポーネントの音声表現。

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