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

# 周辺検索
<a name="search-nearby"></a>

Search Nearby API を使用すると、デベロッパーは中央座標から指定された半径内の対象となるポイントをクエリできます。API は、カテゴリ、ビジネスチェーン、食品タイプなど、オプションのフィルターを使用して場所の結果を提供します。レスポンスの詳細には、場所名、住所、電話、カテゴリ、食品タイプ、連絡先、営業時間などがあります。音素、タイムゾーンなどの追加機能は、リクエストされたパラメータに基づいて使用できます。

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

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

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

## ユースケース
<a name="search-nearby-use-cases"></a>
+ **不動産アプリケーション:** 可能性のある住宅購入者や借用者に、学校、病院、ショッピングセンターなどの施設の近くにある設備やサービスのリストを提供します。
+ **現地のビジネス検出:** ユーザーは、現在の場所から特定の半径内のビジネス、レストラン、またはショップを見つけることができます。例えば、食品配送アプリは、リアルタイムの場所に基づいて近くのレストランを表示できます。
+ **旅行と観光アプリ:** 訪問者が自分の場所や目的地の近くにある名所、ランドマーク、ホテル、サービスを探索するのに役立ちます。旅行アプリは、美術館または博物館、公園、歴史的なサイトなど、近くの対象となるポイントを提案する場合があります。
+ **緊急サービス:** 緊急時に最も近い病院、警察、または薬局を検索するユーザーを支援します。特に、健康、安全、災害対策に重点を置いたアプリにとって重要です。
+ **輸送と物流:** 最寄りの発電所、EV 充電ポイント、または公共交通の停止場所を見つけるのに役立ちます。配車サービスは、近くにある利用可能なドライバーを表示できます。

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

Search Nearby API リクエストには、`QueryPosition` などの必須パラメータと、検索を絞り込むためのフィルターなどのオプションパラメータが含まれます。`Language` や `PoliticalView` などの追加オプションは、特定のニーズに合わせて結果をカスタマイズします。詳細については、「Search Nearby API リファレンス」を参照してください。

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

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

**クエリ**  
クエリの場所と検索範囲を定義します。  
+ `QueryPosition`: 経度と緯度の座標を指定します。
+ `QueryRadius`: 指定された座標を囲む検索半径を定義します。
詳細については、[クエリとバイアス](places-querying-biasing.md)を参照してください。

**結果の絞り込み**  
結果をフィルタリングして検索条件を絞り込みます。  
+ `Filter`: カテゴリ、ビジネスチェーン、食品タイプなどのフィルターを適用します。
詳細については、「[フィルタリング](places-filtering.md)」を参照してください。

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

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

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

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

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

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

**場所のタイプとカテゴリ**  
返される場所のタイプとカテゴリについて説明します。  
+ `Categories`: *レストラン*や*学校*など、場所を説明するカテゴリ。
+ `FoodTypes`: レストランまたは食堂で使用できる食品のタイプ。
+ `BusinessChains`: 関連するビジネスチェーンを示します。

**その他の詳細**  
必要に応じた、場所に関連する追加情報。  
+ `Contacts`: E メール、電話番号、ウェブサイトを一覧表示します。
+ `OpeningHours`: 場所の稼働時間を指定します。
+ `Phonemes`: 住所コンポーネントの音声表現を提供します。
+ `TimeZone`: 場所のタイムゾーン情報が含まれます。